Db Explorer

Browse database tables and run SQL queries across multiple engines. Use when exploring schemas, running queries, comparing databases.

Security Scan

The published name/description claim this is a database explorer, but the bundled SKILL.md and script implement a local gamification/logging tool that writes files under your home directory — the skill's behavior does not match its stated purpose.

Purpose & Capability

Registry metadata and description advertise a DB browsing/querying tool, but SKILL.md and scripts implement a command-line gamification/score-tracking tool. There are no database drivers, no DB-related env vars or binaries, and the script never connects to databases. This is a clear mismatch: a DB explorer would legitimately require DB connection info or client libraries.

Instruction Scope

SKILL.md instructs the agent to run scripts/script.sh and documents many game/leaderboard commands; the script reads and writes only to ~/.local/share/db-explorer, and uses only coreutils. While the script's actions are limited (file writes, grep, tail, export), the instructions as presented do not match the skill's advertised purpose — the agent would be instructed to run tooling unrelated to database exploration.

Install Mechanism

No install spec; this is instruction-only plus an included script. That lowers installation risk because nothing is fetched from external URLs and no archives are extracted.

Credentials

The skill requests no environment variables, credentials, or config paths. The included script only reads/writes under the user's home data directory and uses standard coreutils — no secrets or unrelated credentials are requested.

Persistence & Privilege

always is false and the skill does not modify agent/system-wide configs. It creates and writes files under ~/.local/share/db-explorer, which is a reasonable local data footprint for a CLI logging tool but should be considered if you expect a DB explorer.

What to consider before installing

Don't install this skill if you expected a database explorer: the package contains a local gamification/logging script, not DB connectivity. If you got this from a registry listing for a DB tool, treat the mismatch as suspicious — it could be a publishing error or mislabeling. Before installing or running: (1) inspect scripts/script.sh yourself (it is included and safe-looking: it only writes logs under ~/.local/share/db-explorer and performs local text operations), (2) run it in a sandbox or throwaway account if you want to test, (3) ask the publisher for the correct DB-explorer implementation or source code that actually provides database drivers, and (4) prefer skills that declare their required DB credentials and show expected connection behavior. If you expected DB functionality and need it, find a skill whose code/instructions actually open DB connections and require the appropriate credentials.

Db Explorer v2.0.0 — a gaming/gamification toolkit for tracking scores, ranks, challenges, leaderboards, rewards, and more from the command line.

Commands

Run via: bash scripts/script.sh <command> [args]

Command	Description
roll <input>	Roll dice or log a random outcome. Without args, shows recent rolls.
score <input>	Record a score entry — points, grades, or performance metrics.
rank <input>	Log rank changes or current standing in a leaderboard.
history <input>	Add or view historical entries for past events and milestones.
stats <input>	Log stats data points (game stats, player stats, etc.).
challenge <input>	Create or record a challenge — goals to achieve or compete on.
create <input>	Create a new entity — game, character, team, or project.
join <input>	Log a join event — joining a team, session, or group.
track <input>	Track progress on a challenge, quest, or ongoing goal.
leaderboard <input>	Record or view leaderboard entries and rankings.
reward <input>	Log rewards earned — badges, achievements, prizes.
reset <input>	Record a reset event — starting fresh on a score, rank, or challenge.
stats	Show summary statistics across all entry types.
export <fmt>	Export all data in json, csv, or txt format.
search <term>	Search across all log files for a keyword.
recent	Show the 20 most recent activity entries from the history log.
status	Health check — version, data directory, entry count, disk usage.
help	Show the built-in help message with all available commands.
version	Print the current version (db-explorer v2.0.0).

Each data command works in two modes:

• With arguments: saves the input with a timestamp to its dedicated log file.
• Without arguments: displays the 20 most recent entries from that log.

Data Storage

All data is stored locally in ~/.local/share/db-explorer/:

• Each command has its own log file (e.g., roll.log, score.log, rank.log)
• Entries are saved in timestamp|value format
• A unified history.log records all activity across commands
• Export files are written to the same directory

Requirements

• Bash (standard system shell)
• No external dependencies — uses only coreutils (date, wc, du, grep, tail, cat)

When to Use

• When you want to track scores and rankings from the terminal
• To manage challenges and record progress on gamified goals
• For maintaining leaderboards and tracking competitive standings
• To log rewards, achievements, and milestones
• When building a simple gamification layer for productivity
• To export game/challenge data for analysis or sharing
• For lightweight, file-based score and progress tracking

Examples

# Roll the dice
db-explorer roll "D20 — got 17, critical success"

# Record a score
db-explorer score "Level 5 completed: 2450 points"

# Update rank
db-explorer rank "Moved up to #3 on weekly leaderboard"

# Log history
db-explorer history "First time clearing the boss in under 2 minutes"

# Create a challenge
db-explorer challenge "30-day coding streak — no skipped days"

# Join a team
db-explorer join "Joined Team Alpha for the hackathon"

# Track progress
db-explorer track "Day 12/30 of coding streak — still going"

# Record a reward
db-explorer reward "Earned 'Consistency King' badge"

# Update leaderboard
db-explorer leaderboard "Week 12: Alice 980, Bob 875, Charlie 720"

# Reset scores
db-explorer reset "New season — all scores zeroed"

# View all statistics
db-explorer stats

# Export everything as JSON
db-explorer export json

# Search for entries mentioning "streak"
db-explorer search streak

# Check recent activity
db-explorer recent

# Health check
db-explorer status

---

Powered by BytesAgain | bytesagain.com | [e-mail]