Doc Site Claw
doc-site-claw
v0.2.0May 25, 2026Documentation site architecture — navigation, search indexing, versioning, and content organization that makes docs discoverable
Docs sites that bury the API reference six clicks deep are user-hostile. I structure documentation sites with information architecture that maps to user intent — getting started, how-to guides, reference, and troubleshooting — with searchable navigation that makes the answer closer than a support ticket.
PRIMARY ACTION
Unlock with ProWhen to Use
- Create practical README and setup docs
- Document API behavior with clarity
- Maintain reliable changelogs
- Reduce onboarding friction
Compatible Frameworks
8 TOOLS
Quality Gates
- no fake claims
- navigation intuitive
- search functional
- versioning documented
3 GATES DEFINED
Expected Outputs
Native exports per tool
openclaw/AGENTS.mdopenclaw/SOUL.mdopenclaw/TOOLS.md+7 morehermes/skills/flickclaw/doc-site-claw/SKILL.mdhermes/skills/flickclaw/doc-site-claw/references/workflow.mdhermes/skills/flickclaw/doc-site-claw/references/quality-gates.md+2 moreclaude-code/CLAUDE.mdclaude-code/.claude/skills/doc-site-claw/SKILL.mdclaude-code/.claude/skills/doc-site-claw/references/workflow.md+3 morecodex/AGENTS.mdcodex/.flickclaw/agents/doc-site-claw/codex.mdcodex/.flickclaw/agents/doc-site-claw/workflow.md+2 morecursor/.cursor/rules/flickclaw-doc-site-claw.mdccursor/.cursor/rules/flickclaw-doc-site-claw-workflow.mdccursor/.cursor/rules/flickclaw-doc-site-claw-quality-gates.mdcwindsurf/.windsurf/rules/flickclaw-doc-site-claw.mdwindsurf/.windsurf/rules/flickclaw-doc-site-claw-workflow.mdwindsurf/.windsurf/rules/flickclaw-doc-site-claw-quality-gates.mdaider/CONVENTIONS.mdaider/aider.mdaider/.aider.conf.ymlollama/Modelfileollama/system-prompt.mdollama/template.md+1 moreInstall Commands
Install the FlickClaw CLI, then select your AI agent framework below to get the correct install command.
Step 1: Install CLI (one-time)
npm install -g @flickclaw/cli@latestStep 2: Select Framework
npm exec --yes @flickclaw/cli@latest -- install doc-site-claw --target openclawDownload as ZIP
Example Prompt
Try this prompt with Doc Site Claw to see what it can do:
Review the documentation and identify gaps. Generate Static Documentation Site (Next.js/Docusaurus/Vitepress), Information Architecture Sitemap, Search Index Configuration with Faceted Navigation covering setup, API reference, and troubleshooting.Example Output
IllustrativeWhat a typical Doc Site Claw report looks like:
# Doc Site Claw — Assessment Report **Project**: api-docs-site **Context**: a developer documentation site with OpenAPI specs and tutorials **Generated**: 2026-07-10 ## Executive Summary The Doc Site Claw completed its review of api-docs-site (a developer documentation site with OpenAPI specs and tutorials). 3 findings were identified with concrete remediation steps. All quality gates were verified before delivery. ## Findings | # | Severity | Area | Finding | Recommended Action | |---|----------|------|---------|-------------------| | 1 | **P1** | Structure | Quickstart buried 3 levels deep in navigation | Promote Quickstart to top-level with 5-minute timebox | | 2 | **P2** | Completeness | Webhook events missing from API reference | Document all webhook types with payload examples | | 3 | **P2** | Examples | Code samples lack error handling | Add try/catch blocks and error response examples | ## Quality Gates - [✓] every_page_reachable_within_three_clicks_from_nav_root - [✓] search_index_covers_all_content_pages - [✓] responsive_layout_verified_on_mobile_viewport ## Outputs Generated - **Static Documentation Site (Next.js/Docusaurus/Vitepress)**: Included in the report above. - **Information Architecture Sitemap**: Included in the report above. - **Search Index Configuration with Faceted Navigation**: Included in the report above. ## Validation - [x] All quality gates passed (3/3) - [x] 3 findings documented with severity and remediation - [x] 3 output sections generated - [x] Evidence collected and referenced --- *This is an illustrative example output from FlickClaw. Results vary based on project context.*