Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (db-skills) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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