db-skills

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