# Doc Review

> Review documentation for accuracy, drift, and duplication. No code changes.

- Skill: `majiayu000/doc-review-5` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/doc-review-5`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/doc-review-5/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/doc-review-5

---


# Doc Review

Review documentation for correctness, alignment with code and GitHub state, and minimal duplication. No fixes — findings only.

## Inputs

Which docs (or PR) to review. Audience focus (dev workflow vs player-facing).

## Review-aware

Before starting: check if `<slug>.findings.md` exists for these docs. If it does, build on prior findings.

## Workflow

1. **Load docs** — Read the target doc(s). Load `docs/DOCUMENTATION_POLICY.md` to know what format and accuracy standards apply.

2. **Cross-check** — Validate each claim against:
   - Code (grep for referenced function names, file paths, constants)
   - GitHub state (`gh issue list`, `gh pr list`) for workflow accuracy
   - Design pillars (`design/`) for design claim accuracy
   - Other docs for duplication (flag the single best source of truth)

3. **Report** — Group findings by severity (Critical/Major/Minor) with `path:line` and suggested fix. Note any sections that are outdated, missing, or contradicted by code.

4. **Use `/findings`** — Write findings to `<slug>.findings.md` so the author can respond without copy-paste.

## Reference

- Documentation policy: `docs/DOCUMENTATION_POLICY.md`