By xiaolai
Enforce documentation quality and freshness across projects by detecting stale docs, measuring coverage of public APIs, verifying accuracy against source code, and auto-generating missing documentation for Python, TypeScript, Go, and Rust in MkDocs, VitePress, Docusaurus, Sphinx, or plain Markdown. A full audit command produces a report with scores, findings, and a fixing plan.
Full documentation audit — launch staleness, accuracy, coverage, and quality agents in parallel, then synthesize a report with a fixing plan
Check documentation coverage — find undocumented public APIs and report coverage percentage
Auto-generate missing documentation — scan for coverage gaps, then write docs in the project's framework format
Initialize docs-guardian for this project — auto-detect language and doc framework, propose code-to-doc mappings, configure hook strictness
Shared config validation step — reads and validates docs-guardian config, stops with init instructions if missing.
You are the accuracy checker. Your job is to find places where documentation says something different from what the code actually does.
You are the coverage scanner. Your job is to find every public API symbol and determine whether it has documentation.
You are the doc writer. Your job is to read source code and produce high-quality documentation in the project's documentation framework format.
You are the quality rater. Your job is to evaluate the quality of existing documentation files.
You are the staleness detector. Your job is to find documentation that has fallen behind the code it describes.
Use when detecting a project's programming language and documentation framework from filesystem markers — package.json, Cargo.toml, pyproject.toml, mkdocs.yml, etc.
Use when mapping source code files to their documentation counterparts — find which docs cover which code, detect gaps, and resolve doc-to-code relationships.
Use when evaluating documentation quality — check completeness, accuracy, freshness, and adherence to project documentation standards.
Use when generating or auditing documentation in Docusaurus format — covers config, directory structure, frontmatter conventions, and build commands.
Use when generating or auditing documentation in MkDocs format — covers config, directory structure, frontmatter conventions, and build commands.
Executes bash commands
Hook triggers when Bash tool is used
Uses power tools
Uses Bash, Write, or Edit tools
Has parse errors
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Some configuration could not be fully parsed
Some configuration could not be fully parsed
Documentation quality and freshness enforcer — detect staleness, check accuracy, measure coverage, and auto-generate docs across any language and doc framework.
Docs-guardian treats documentation like code: it drifts, goes stale, and needs continuous maintenance. This plugin detects when docs fall behind, measures how much of your API is actually documented, checks whether docs match the current code, and can auto-generate missing documentation in your project's chosen framework format.
Part of the xiaolai plugin marketplace.
Add the marketplace (once):
/plugin marketplace add xiaolai/claude-plugin-marketplace
Then install:
/plugin install docs-guardian@xiaolai
Install fails with "Plugin not found in marketplace 'xiaolai'"? Your local marketplace clone is stale. Run
claude plugin marketplace update xiaolaiand retry —plugin installdoes not auto-refresh.
| Scope | Command | Effect |
|---|---|---|
| User (default) | /plugin install docs-guardian@xiaolai | Available in all your projects |
| Project | /plugin install docs-guardian@xiaolai --scope project | Shared with team via .claude/settings.json |
| Local | /plugin install docs-guardian@xiaolai --scope local | Only you, only this repo |
# 1. Initialize — detects your language, doc framework, proposes mappings
/docs-guardian:init
# 2. Check how much of your API is documented
/docs-guardian:coverage
# 3. Full audit — staleness, accuracy, coverage, quality in parallel
/docs-guardian:audit
# 4. Auto-generate docs for undocumented code
/docs-guardian:generate
| Command | Description |
|---|---|
/docs-guardian:init | Auto-detect language and doc framework, propose code-to-doc mappings, configure hook strictness |
/docs-guardian:audit | Full audit — launch 4 agents in parallel, synthesize a report with prioritized fixing plan |
/docs-guardian:coverage | Lightweight coverage check — find undocumented public APIs and report coverage % |
/docs-guardian:generate | Auto-generate missing docs — scan for gaps, then write docs in framework format |
detection skill scans for marker files (tsconfig.json, go.mod, mkdocs.yml, etc.) to identify your language and doc framework. The mapping skill resolves which source files map to which doc files.doc-writer agent reads undocumented code, understands its API, and writes docs using the correct framework template.| Agent | Model | Focus |
|---|---|---|
staleness-detector | haiku | Git timestamp comparison between code and doc files |
accuracy-checker | opus | Deep code-vs-doc mismatch analysis (signatures, examples, behavior) |
coverage-scanner | sonnet | Find every undocumented public symbol, calculate coverage % |
quality-rater | haiku | Empty sections, TODOs, broken links, formatting, readability |
doc-writer | opus | Read code, generate/update docs in the project's framework format |
Three-layer design:
Detection Layer (skills) → auto-detect language + doc framework
↓
Adapter Layer (skills) → stack-specific knowledge (5 languages × 5 frameworks)
↓
Agent Layer (agents) → stack-agnostic analysis and generation
Adding a new language = one skill file under languages/. Adding a new framework = one skill file under frameworks/. Zero agent or command changes needed.
After /docs-guardian:init, config lives at .claude/docs-guardian/config.json:
Natural-Language Programming Manager — score, check, fix, and test NL artifacts across Claude Code, Codex CLI, and Antigravity. Tier-aware scoring with per-tool overlays.
A 260-token system prompt that overrides three structural presumptions every RLHF-trained LLM inherits from training: that you want confirmation, that old scarcity still applies, that best practices are ceilings.
English language coach for non-native speakers — auto-corrects prompts, translates non-English, refines with :: prefix, tracks improvement over time
One plugin to bridge and delegate across Claude Code, Codex CLI, and Gemini CLI — single-source AGENTS.md, shared skills, mirrored hooks and MCP servers, and full Claude↔Codex bidirectional delegation.
Auto-updated multi-skill reference for the whole Anthropic doc ecosystem. 8 skills covering claude-code, claude-agent-sdk, anthropic-api, anthropic-platform-features, claude-connectors, claude-cowork, mcp-spec, and anthropic-pulse (news + research digests). Pipeline refreshes daily.
npx claudepluginhub xiaolai/claude-plugin-marketplace --plugin docs-guardianComplete collection of battle-tested Claude Code configs from an Anthropic hackathon winner - agents, skills, hooks, and rules evolved over 10+ months of intensive daily use
Complete creative writing suite with 10 specialized agents covering the full writing process: research gathering, character development, story architecture, world-building, dialogue coaching, editing/review, outlining, content strategy, believability auditing, and prose style/voice analysis. Includes genre-specific guides, templates, and quality checklists.
Upstash Context7 MCP server for up-to-date documentation lookup. Pull version-specific documentation and code examples directly from source repositories into your LLM context.
Unity Development Toolkit - Expert agents for scripting/refactoring/optimization, script templates, and Agent Skills for Unity C# development
Comprehensive .NET development skills for modern C#, ASP.NET, MAUI, Blazor, Aspire, EF Core, Native AOT, testing, security, performance optimization, CI/CD, and cloud-native applications
AI-powered wiki generator for code repositories. Generates comprehensive, Mermaid-rich documentation with dark-mode VitePress sites, onboarding guides, deep research, and source citations. Inspired by OpenDeepWiki and deepwiki-open.