docs2skills
v0.3.0
Published
Install AI agent skills generated from documentation
Downloads
30
Maintainers
Readme
docs2skills
Install agent-ready skills generated from documentation — directly into your AI coding agents.
npx docs2skills add <slug>One command installs to all your agents at once. A canonical SKILL.md is written for the first agent, and symlinks are created for the rest — no duplication, always in sync.
Quick start
# Install a skill to all detected agents
npx docs2skills add trigger-dev
# Install globally (~/.<agent>/skills/)
npx docs2skills add stripe -g
# Skip prompts, install to all agents
npx docs2skills add clerk -y
# List installed skills
npx docs2skills list
# Remove a skill from all agents
npx docs2skills remove clerk
# Show supported agents and their status
npx docs2skills agentsCommands
| Command | Description |
|---|---|
| add <slug> | Install a skill to your agents |
| list | Show installed skills |
| remove <slug> | Uninstall a skill from all agents |
| agents | Show supported agents and status |
Options
| Flag | Description |
|---|---|
| -g, --global | Install to ~/.<agent>/skills/ |
| -y, --yes | Skip prompts, install to all agents |
| -h, --help | Show help |
| --no-color | Disable colored output |
Supported agents (17)
| Agent | Project path | Global path |
|---|---|---|
| OpenCode | .agents/skills/ | ~/.config/opencode/skills/ |
| Cursor | .cursor/skills/ | ~/.cursor/skills/ |
| Claude Code | .claude/skills/ | ~/.claude/skills/ |
| Windsurf | .windsurf/skills/ | ~/.codeium/windsurf/skills/ |
| GitHub Copilot | .github/copilot/skills/ | ~/.copilot/skills/ |
| Cline | .cline/skills/ | ~/.cline/skills/ |
| Trae | .trae/skills/ | ~/.trae/skills/ |
| Roo Code | .roo/skills/ | ~/.roo/skills/ |
| Codex | .codex/skills/ | ~/.codex/skills/ |
| Gemini CLI | .gemini/skills/ | ~/.gemini/skills/ |
| Aider | .aider/skills/ | ~/.aider/skills/ |
| Zed AI | .zed/skills/ | ~/.config/zed/skills/ |
| JetBrains AI | .jb-ai/skills/ | ~/.jb-ai/skills/ |
| Amp | .amp/skills/ | ~/.amp/skills/ |
| Void | .void/skills/ | ~/.void/skills/ |
| PearAI | .pearai/skills/ | ~/.pearai/skills/ |
| Supermaven | .supermaven/skills/ | ~/.supermaven/skills/ |
How it works
- Fetch — The CLI fetches a pre-generated
SKILL.mdfrom the docs2skills API - Canonical write — The skill file is written to the first agent's skills directory
- Symlink — All other agents get a symlink pointing to the canonical copy
- Fallback — If symlinking fails (e.g., cross-device), a full copy is written instead
Skills are structured markdown files distilled from official documentation, designed to be consumed by AI coding agents as context.
What is a skill?
A skill is a SKILL.md file containing distilled knowledge from a library or framework's documentation. It includes:
- Description — When the agent should load this skill
- API patterns — Correct usage, configuration, and common patterns
- Best practices — Performance tips, error handling, and gotchas
- Code examples — Real-world snippets ready for the agent to reference
When your AI agent encounters a task related to the skill, it loads the relevant SKILL.md as context — giving it accurate, up-to-date knowledge without hallucination.
Browse skills
Visit docs2skills.com/explore to browse available skills, or generate your own from any documentation URL.
Requirements
- Node.js >= 18
- No additional dependencies (zero-dependency CLI)
License
MIT
