Help us improve
Share bugs, ideas, or general feedback.
Share bugs, ideas, or general feedback.
Share bugs, ideas, or general feedback.
By agent-sh
Sync documentation with code changes. Find outdated refs, update CHANGELOG, flag stale examples.
npx claudepluginhub agent-sh/sync-docs --plugin sync-docsDetect outdated documentation by comparing docs against actual code state - broken references, version mismatches, stale examples, and missing CHANGELOG entries.
Documentation drifts from code silently. A function gets renamed, an import path changes, a version bumps - but the README and CHANGELOG still reference the old state. sync-docs compares documentation files against the current codebase and finds the gaps. Safe fixes like version updates and CHANGELOG entries are auto-applied. Ambiguous cases - removed exports referenced in docs, code examples needing context - are flagged for manual review.
Use cases:
agentsys install sync-docs
# Check for outdated docs (no changes made)
/sync-docs
# Apply safe fixes (version updates, CHANGELOG entries)
/sync-docs apply
# Check docs related to a specific path
/sync-docs report src/
# Scan entire codebase, not just recent changes
/sync-docs --scope=all
sync-docs runs a multi-phase analysis pipeline:
Phase 1 - Project detection. Identifies the project type (JavaScript, Python, Rust, Go) and locates documentation files (README.md, CHANGELOG.md, docs/*.md).
Phase 2 - Change discovery. Gets changed files based on scope (recent commits, full branch, or entire codebase) and finds documentation files that reference those changed files by filename, import path, function name, or class name.
Phase 3 - Issue analysis. Reads each related doc and checks for:
Phase 4 - CHANGELOG check. Compares recent conventional commits against CHANGELOG entries. Flags commits with no corresponding entry.
Phase 5 - Doc-drift detection (optional). When repo-intel data is available, identifies docs with zero code coupling - files that never co-change with code and are likely stale.
/sync-docs
/sync-docs report src/auth/
/sync-docs report --scope=all
Outputs a structured report of documentation issues sorted by severity. No files are modified.
/sync-docs apply
/sync-docs apply --scope=before-pr
Applies safe fixes (version updates, CHANGELOG entries) and reports remaining issues for manual review. Changes are committed with the message docs: sync documentation with code changes.
recent (default) - files changed since last commit to mainall - scan all docs against all codebefore-pr - files in current branch, optimized for pre-PR workflows<path> - specific file or directory/sync-docs --include-undocumented # Find exports with no doc coverage (uses repo-intel)
MIT
Uses power tools
Uses Bash, Write, or Edit tools
Share bugs, ideas, or general feedback.
Based on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Audit codebase documentation for accuracy, completeness, and freshness against actual code. Auto-fixes small discrepancies, reports structural changes. Companion to agent-ready.
Cross-references docs against actual source. Flags drift, missing params, dead references.
Automatically update project documentation based on code changes
Documentation and authoring workflow router: audit docs vs code drift, sync docs after changes, optimize prompts and SKILL.md files, validate GLFM and Markdown formatting, summarize files/URLs/images with fidelity enforcement. Use when: docs are out of date, CLAUDE.md needs improving, SKILL.md needs optimizing, checking if documentation matches code, summarizing files or URLs.
Make your AI agent code with your project's architecture, rules, and decisions.
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.
Deep repository analysis to realign project plans with actual code reality - discovers drift, gaps, and produces prioritized reconstruction plans
Master workflow orchestrator with autonomous task-to-production automation, quality gates, and multi-agent review
Plugin structure and tool use analyzer - validates plugin.json, MCP tools, and security patterns
AI slop cleanup with minimal diffs and behavior preservation
Multi-agent iterative code review until zero issues remain
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge.
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge.
Sign in to claim