review-docs

Installation
SKILL.md

Documentation review

Process

  1. Verify file version - git status to confirm you have the latest

  2. Run deterministic checks (main process) - these are objective, no judgment needed:

    • vale --minAlertLevel=suggestion "<file>" (prose style: voice, tone, terminology, grammar, headings, link text)
    • pnpm lint:md (heading hierarchy, list numbering, spacing)
    • .agents/skills/review-docs/scripts/check-frontmatter.sh "<file>" (description char count)

    Vale carries most of the style guide, so don't re-check its ground by hand. If it isn't installed, say so and note that prose coverage was skipped.

Installs
6
GitHub Stars
81
First Seen
Aug 1, 2026