Installation
Installation
Section titled “Installation”- From the root of your project, install the skill with
npx skills:See Which agent(s) should I select? for agent selection options.Terminal window npx skills add Grisselbav/dbLinter - Make sure the
dblinterCLI itself is installed and authenticated — see the CLI Overview. The skill assumesdblinteris already on yourPATH.
- Copy or symlink the
skills/dblinterdirectory from the dbLinter GitHub repository into.agents/skills/dblinter/at the root of your project (or~/.agents/skills/dblinter/to make it available in every project). This shared, “universal” location is read directly by most Agent-Skills-compatible agents, including OpenAI Codex and GitHub Copilot — see Which agent(s) should I select?. - Claude Code is the exception: it only reads its own
.claude/skills/directory, not.agents/skills/. If you use Claude Code, also copy or symlinkskills/dblinterinto.claude/skills/dblinter/(or~/.claude/skills/dblinter/for every project). - Make sure the
dblinterCLI itself is installed and authenticated — see the CLI Overview.
Which agent(s) should I select?
Section titled “Which agent(s) should I select?”Without -a, the installer lists all supported agents, including those you have not configured.
When run inside a supported agent, it may install without prompting; check the result.
Pick explicitly to skip the prompt:
# install for Claude Code and Codex onlynpx skills add Grisselbav/dbLinter -a claude-code -a codex
# install for every supported agentnpx skills add Grisselbav/dbLinter -a '*'The installer stores one copy in .agents/skills/dblinter/ and creates symlinks for agents that require another
directory, such as Claude Code. Updating the shared copy updates the skill for all linked agents.
See Compatibility for directory details.
Update
Section titled “Update”- Update the skill to the latest published version:
Terminal window npx skills update dblinter -p
- Re-copy the
skills/dblinterdirectory from the dbLinter GitHub repository, overwriting the version in your agent’s skills directory.
Verifying the installation
Section titled “Verifying the installation”Confirm dblinter appears in your agent’s skill list (for example, run /skills in Claude Code).
See Compatibility for other agents’ instructions. Then try:
Check my SQL files with dblinter and summarize the issues.The agent should select the skill and CLI flags automatically. See Usage for more examples.