Docs Skills
docs-skills is an open catalog of SKILL.md files for AI agents. Each skill teaches an agent how to perform a focused documentation task — auditing SEO, generating new pages from a website, publishing to a workspace, or watching for stale content.
The catalog lives at github.com/Docsbook-io/docs-skills.
What is a Skill?#
A Skill is a reusable workflow — a set of Guardrails, Steps, and Acceptance Criteria encoded in a SKILL.md file. Think of it as a QA Checklist: you apply it in any project, with any agent (Claude Code, Cursor, Copilot, Codex). It does not carry project-specific context.
A Subagent is an executor: it has a pinned model, specific tools, priorities, and an autonomous work plan. Subagents live in docs-subagents. They are built for a specific context and are not meant to be reused across projects.
Rule of thumb: "Would this workflow be useful in another project?" — yes → skill, no → subagent.
Categories#
27 skills are organized into 6 categories:
| Category | Count | Examples |
|---|---|---|
| analysis | 11 | docs-analyze, docs-seo, docs-accessibility, docs-i18n, docs-style-tone |
| creation | 4 | docs-create, docs-create-interactive, docs-detect-source, docs-from-site |
| publishing | 3 | docs-publish, docs-setup-workspace, docs-generate-agents-md |
| automation | 7 | docs-pr-check, docs-tune-ai-chat, docs-stale-watcher, docs-release-announce, docs-sync |
| observability | 1 | docs-gap-finder |
| planning | 1 | docs-strategy-plan |
Two consumption modes#
Local install#
Copy SKILL.md files into your agent's local skill directory:
npx docs-skills installThe installer detects Claude Code, Cursor, and Cline layouts and writes to .claude/skills/, .cursor/rules/, or AGENTS.md as appropriate. Skills work offline once installed.
Runtime discovery via MCP#
If the agent is connected to the Docsbook MCP server, it can discover skills on demand:
find_skill({ query: "audit my docs for SEO" })The tool returns matching SKILL.md entries with a raw_url field. The agent fetches the file directly from GitHub and follows its instructions. No local install required.
Skills vs Subagents#
| Skill | Subagent | |
|---|---|---|
| Analogy | QA Checklist | Jira ticket |
| Contains | Workflow, Guardrails, Acceptance Criteria | Pinned model, tools, plan |
| Reusable | Yes — any project | No — specific context |
| Works in | Claude Code, Cursor, Copilot, Codex | Claude Code (agent system) |
| Install | npx docs-skills install |
npx docs-subagents install |
Catalog page#
Browse and filter the full catalog at docsbook.io/skills. Each skill has a detail page with installation snippets and the rendered SKILL.md body.
Pricing#
The catalog and find_skill MCP tool are available on all plans, including Free. Individual skills may invoke MCP tools that require a paid plan.
Related#
- MCP Server — How
find_skillis exposed to agents. - llms.txt — The other discovery surface for AI clients.
- docs-subagents — subagents for autonomous doc automation.
- docs-claude-plugins — bundled plugins (skills + subagents + MCP + hooks).