docs-seolisted

Make your docs rankable — by Google and by AI. A documentation-aware SEO audit covering title and description optimization, heading hierarchy, keyword placement, internal topic clusters, image alt text and GEO / AI Overviews compatibility. Not a general site audit — tuned for doc-specific failure modes.
Docsbook-io/docs-skills · ★ 0 · Data & Documents · score 75

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

# docs-seo — SEO Analysis for Documentation ## Workflow 1. **Connect to Docsbook** — run `list_workspaces` to find the workspace, then `get_doc_graph` to get all pages with titles and metadata. Skip if docs are private or internal. Reindex if graph is empty or stale. 2. **Read pages** — use `read_doc_sections` to access frontmatter, headings, and content for each page. 3. **Apply checklist** — check titles, descriptions, heading structure, body content, images, internal links (topic clusters), URL/file path conventions, and AI Overviews / GEO criteria. 4. **Produce report** — return one JSON issue object per finding, sorted by severity. Cross-page checks (duplicate titles, orphan pages) require the full graph. ## Guardrails - Do not run on private or internal documentation — SEO only applies to public docs. - Do not edit any documentation files — surface findings only. - Cross-page checks (duplicate titles, orphan pages) can only be found by scanning all pages together — run these after reading individual pages. - Ask the user to confirm primary keywords per page before flagging title/description intent mismatches. - AI Overviews / GEO criteria are a separate, stricter checklist — ask the user whether to apply them. ## MCP Tools | Tool | Purpose | |------|---------| | `mcp__docsbook__list_workspaces` | Find workspace | | `mcp__docsbook__get_doc_graph` | Full page list, metadata, link relationships | | `mcp__docsbook__read_doc_sections` | Read frontmatter, headings, and