docs-navigation-linkinglisted

Fix the dead ends and orphan pages in your docs. Walks the full doc graph to find broken internal links, pages nothing links to, generic anchor text ("click here"), over-deep hierarchies and missing next-step links between related pages. Cross-file — requires the whole graph, not one page.
Docsbook-io/docs-skills · ★ 0 · Data & Documents · score 75

Install: claude install-skill Docsbook-io/docs-skills

# docs-navigation-linking — Navigation and Linking Analysis ## Workflow 1. **Connect to Docsbook** — run `list_workspaces` to find the workspace, then `get_doc_graph` to get all pages and their link relationships. Reindex if graph is empty or stale. This skill requires the full doc graph — do not run on a single page in isolation. 2. **Build link sets** — extract all `href` values from every page; compare to the full page list to identify orphans and broken links. 3. **Apply checklist** — check internal links, orphan pages, anchor text quality, navigation hierarchy, next steps / cross-references, and external links. 4. **Produce report** — return one JSON issue object per finding, sorted by severity. ## Guardrails - Do not edit any documentation files — surface findings only. - This skill is cross-file: orphan detection requires the full graph. Never run on a single page in isolation. - The root index/home page is expected to have no inbound links from docs — exclude it from orphan detection. - Checking external link validity requires HTTP requests — ask the user before making outbound calls. - Confirm Tier 1 pages with the user before flagging navigation accessibility as medium vs. high severity. ## MCP Tools | Tool | Purpose | |------|---------| | `mcp__docsbook__list_workspaces` | Find workspace | | `mcp__docsbook__get_doc_graph` | Full page list, link relationships, structure | | `mcp__docsbook__read_doc_sections` | Read page content for anchor text analysis | | `mc