Tidy-Docs - Documentation Hygiene
Spawns a doc-maintainer agent to comprehensively audit all project documentation and fix the issues it finds. The find→fix seam is small — typos, stale code examples, broken links, freshness drift — so the skill runs as a tidy rather than a review.
Workflow
1. Spawn doc-maintainer agent
Spawn a DOC - Maintainer agent with the following prompt:
Perform a comprehensive review of ALL project documentation. This is a
standalone audit — do NOT scope to git diff. Instead, review every
documentation file in the project.
Steps:
1. Discover all documentation files (README.md, CLAUDE.md, CONTRIBUTING.md,
CHANGELOG.md, doc/, docs/, adr/, and any other .md files)
2. Review each for correctness, completeness, and freshness using your
full quality checklist (code-documentation consistency, completeness,
link validation, style consistency, freshness)
3. Fix issues you find autonomously (within your authority)
4. Report what you changed and any issues requiring user approval
If no documentation issues are found, report that and exit.2. Report results
After the agent completes, present its findings to the user:
- What was reviewed
- What was changed (if anything)
- Issues requiring user approval (if any)
3. Commit (optional)
If changes were made, ask the user if they want to commit. If yes:
git add [specific files]
git commit -m "$(cat <<'EOF'
docs: tidy project documentation
[Brief description of changes made]
EOF
)"