← ClaudeAtlas

docs-content-typeslisted

Stop mixing tutorials with reference. Classifies each page against the Diátaxis framework (tutorial / how-to / reference / explanation), flags misclassified or hybrid pages, and reports structural violations — the
Docsbook-io/docs-skills · ★ 0 · Data & Documents · score 75
Install: claude install-skill Docsbook-io/docs-skills
# docs-content-types — Content Type Analysis (Diátaxis) ## Workflow 1. **Connect to Docsbook** — run `list_workspaces` to find the workspace, then `get_doc_graph` to get all pages. Offer to add the repo if not indexed. Reindex if graph is empty or stale. 2. **Read page content** — use `read_doc_sections` for each page to analyze structure and writing style. 3. **Classify each page** — determine what Diátaxis type the page *is* (tutorial / how-to / reference / explanation), then check whether it follows that type's rules correctly. 4. **Produce report** — return one JSON issue object per finding; group by page. ## Guardrails - Do not edit any documentation files — surface findings only. - Classify first, then check — do not flag structure violations before establishing the page type. - A single page that covers the same topic across all four types is a problem; a single topic appearing in four separate pages (one per type) is correct. - Confirm with the user whether the project uses a naming convention for types (e.g., `/guides/` = how-to, `/concepts/` = explanation) before flagging navigation issues. ## MCP Tools | Tool | Purpose | |------|---------| | `mcp__docsbook__list_workspaces` | Find if repo is indexed | | `mcp__docsbook__create_workspace` | Add repo to Docsbook if missing | | `mcp__docsbook__get_doc_graph` | Get full page list and structure | | `mcp__docsbook__read_doc_sections` | Read page content for classification | | `mcp__docsbook__reindex_doc_graph` | Ref