db-skills

Built by Docfork

Curated database skills for AI coding agents (OpenCode, Claude Code, Codex, Cursor).

Each skill is a small, reviewable workflow in skills/<skill-name>/SKILL.md (with name + description frontmatter). Think: schema discovery, safe migrations, debugging slow queries, and data quality checks.

Installation

npm install -g db-skills

Quick Start

# see what's bundled in this package
db-skills list

# install all bundled db skills (global)
db-skills add --all --global --yes

Usage

Commands

| Command | Purpose | | ----------------------------------- | ------------------------------------------------ | | db-skills list | list bundled skills | | db-skills add | install selected skills (interactive by default) | | db-skills add --all | install all bundled skills | | db-skills rm / db-skills remove | uninstall selected skills |

Options

| Option | Description | | ------------------------- | ---------------------------------------------------------- | | -g, --global | install to user directories instead of the current project | | --agent <agents...> | target specific agents (e.g. cursor, claude-code) | | -s, --skill <skills...> | select skills by name (skip selection prompt) | | --mode <mode> | install mode: copy (default) or symlink | | -y, --yes | skip confirmation prompts |

Examples

# list skills
db-skills list

# install one skill globally to cursor + claude-code
db-skills add -g --agent cursor claude-code --skill query-database-schema

# install everything globally (ci-friendly)
db-skills add --all -g -y

# remove one skill globally
db-skills rm -g --skill query-database-schema -y

Supported Agents

This CLI can install skills into these agent directories:

| Agent | --agent | Project Path | Global Path | | ----------- | ------------- | ------------------- | ---------------------------- | | Cursor | cursor | .cursor/skills/ | ~/.cursor/skills/ | | Claude Code | claude-code | .claude/skills/ | ~/.claude/skills/ | | Codex | codex | .codex/skills/ | ~/.codex/skills/ | | OpenCode | opencode | .opencode/skills/ | ~/.config/opencode/skills/ |

How installs work

• source of truth: bundled skills live under ./skills/<skill-name>/SKILL.md
• canonical store: installs copy into .agents/skills/<skill-name>/ (project) or ~/.agents/skills/<skill-name>/ (global)
• agent install:
  • copy: copies from canonical store into each agent directory
  • symlink: symlinks each agent directory to canonical store

Available Skills

This section is auto-generated from ./skills/*/SKILL.md. To refresh it, run npm run sync-skills.

| Skill | Purpose | | ---------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | | data-quality-audit | Audits database data quality (nulls, duplicates, orphans, invalid ranges) and produces a short findings report with remediation queries | | debug-slow-queries | Diagnoses and fixes slow database queries using explain plans, statistics, and targeted indexes or rewrites | | query-database-schema | Inspects database schema and metadata (tables, columns, indexes, constraints, relationships) | | write-safe-migrations | Plans and executes safe database migrations with low-downtime patterns, verification, and rollback |

Contributing

This repo is curated. Skill requests and focused PRs are welcome.

• request a skill: open an issue using the “db-skill request” template
• contribute a skill: see CONTRIBUTING.md

Troubleshooting

"No skills found"

• ensure skills live at skills/<skill-name>/SKILL.md
• ensure frontmatter has name and description
• ensure name matches the directory name exactly

Skill not loading in agent

• verify the skill exists under the agent skills directory after install
• some agents require additional configuration to load skills from disk

License

MIT