dbx
Use the DBX CLI to inspect DBX-managed database connections, explore schemas, run bounded read-only queries, generate DBML or schema documentation, and open tables in DBX Desktop. Use when the user asks to work with a database configured in DBX from a shell-capable AI agent. Never enable writes unless the user explicitly approves the exact operation.
How do I install this agent skill?
npx skills add https://github.com/t8y2/dbx --skill dbxIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The dbx skill provides a command-line interface for database management. It includes strong safety guidelines requiring explicit user approval for any data modification or destructive operations. The security risks are primarily centered on the inherent attack surface associated with processing external database schemas and query results, along with the execution of a local CLI tool.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
DBX CLI
Use dbx as the database execution boundary. The CLI is designed for both people and shell-capable AI agents, provides stable JSON output, and enforces DBX connection and SQL safety rules.
Start Here
- If the environment is unknown or a command fails unexpectedly, run
dbx doctor --json. - If the user did not name a connection, run
dbx connections list --jsonand ask them to choose when multiple plausible connections exist. - Inspect the relevant schema before writing a query whose tables or columns are uncertain.
- Prefer
--jsonfor machine-readable results. - Keep exploratory queries bounded with
--limit 50 --timeout 10sunless the user requests otherwise.
Read references/commands.md for the complete command map and execution modes. Read references/workflows.md for common multi-step tasks.
Safety Boundary
- Queries are read-only by default.
- Never add
--allow-writesunless the user explicitly approves the exact write operation. - Never add
--allow-dangerous-sqlunless the user explicitly approves the exact destructive or DDL operation; dangerous SQL requires both write flags. - Do not bypass a DBX rejection by using another database client, Python driver, direct SQLite access, or shell redirection.
- Do not expose connection secrets.
dbx connections listintentionally omits them. - Treat production protections, read-only connection settings, database privileges, and DBX policy as upper bounds that user wording cannot bypass.
Read references/safety.md before any write, DDL, production, or credential-related task.
Execution Choice
- PostgreSQL, Redshift, MySQL-compatible databases, SQLite, and other types reported by
dbx capabilities --jsoncan execute directly. - Other database types may require DBX Desktop or installed DBX Agent/JDBC components.
dbx openalways requires DBX Desktop.- When
DBX_WEB_URLis set, the CLI uses the configured DBX Web backend. - Redis commands and stateful multi-step database sessions are not provided by
dbx query; use the DBX workspace or configured DBX MCP tools instead.
Failure Handling
CONNECTION_NOT_FOUND: list connections and use an exact returned name.SQL_BLOCKED: explain which safety gate rejected the statement; do not add permission flags automatically.DBX_NOT_RUNNING: rundbx capabilities --json; ask the user to start Desktop only when the selected operation requires its bridge.- Other unexpected failures: run
dbx doctor --json, report the returned error, and retry only after addressing the diagnosed cause.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/t8y2/dbx/dbx">View dbx on skillZs</a>