Audit repository documentation for drift, stale claims, and missing changelog entries.
npx skills add https://github.com/jrmatherly/spacebot --skill docs-audit-jrmatherly
Please help me install this Agent Skill. Skill: docs-audit Source: https://github.com/jrmatherly/spacebot/tree/main/.claude/skills/docs-audit Command: npx skills add https://github.com/jrmatherly/spacebot --skill docs-audit-jrmatherly
Many repository documentation files become stale, inconsistent, or incomplete as code, releases, and processes evolve. This Skill provides a systematic, evidence-first audit to uncover incorrect claims, missing changelog entries, broken links, and status drift across user-facing and operational docs so maintainers can prioritize precise fixes.
Run an evidence-backed documentation audit across the repository and produce a prioritized findings report with file and git citations.
High-intent search queries and answers about installing and using this skill.
Documentation drift is detected by auditing project files against git history and code to find stale claims, missing changelog entries, and unresolved TODOs. The audit produces evidence-backed findings with file:line citations and specific remediation recommendations.
Changelog completeness is verified by comparing CHANGELOG entries against git commits and queued changesets. The audit validates version and date claims against manifests and flags missing entries to ensure release documentation is accurate and complete.
Nested CLAUDE.md files and .claude/rules are included in the scoped audit. The audit targets repo-root docs, package CHANGELOGs, openspec specs, and other operational docs while honoring explicit out-of-scope directories like vendored spacedrive.
An audit report prioritizes fixes by providing evidence-backed findings with git output, file listings, or code grep evidence for each issue. It produces a prioritized report of incorrect, stale, and missing documentation items with precise remediation recommendations.
Documentation auditing does not automatically edit files. The audit produces evidence-backed findings with verbatim claims, git or filesystem evidence, and specific remediation recommendations without making edits unless explicitly approved by the maintainer.
Broken links to gitignored or transient paths are found during the release and lifecycle checks phase of a documentation audit. The audit validates links within README, spaceui docs, and openspec specs to flag references to non-existent or transient filesystem locations.
ulises-jeremiasGenerate and update project documentation from repository structure and git history.
SuperlendAnalyze commit changes to verify security audit remediation and generate fix-review reports.
tony30552001Align README, ARCHITECTURE, CONTRIBUTING, and CLAUDE.md with shipped code diffs.
CERTCCValidate markdown documentation with strict mkdocs build checks.
