Self-review plans and documentation in Claude Code

Check placeholders, contradictions, scope, and ambiguity, then record corrections supported by the brief.

Install in Claude Code

A Claude Code workspace and a document to review. Bring confirmed goals and constraints that can resolve ambiguities.

Review `.claude/skills/self-review/SKILL.md` and its requirements at the pinned GitHub commit.
Create `.claude/skills/self-review/` in your project and save the reviewed file as `.claude/skills/self-review/SKILL.md`.
Start Claude Code from that project's root, then select `/self-review` in the slash menu.

Example task

A rehearsal-list spec calls for A4 in one place and letter in another, and still has a TODO. The confirmed fixture is `{paper:'A4',scope:'print only',placeholder:'TODO'}`. The existing page has no requirement for booking changes.

What to check

Align the document on `paper=A4; scope=print only`, resolve the known TODO, and report the paper conflict and placeholder corrections. Check that no booking work entered the scope.

Original SKILL.md on GitHub · Updated 2026-11-14

Frequently asked question

What should a quick self-review look for after drafting documentation?

Look for placeholders, contradictions, scope drift, and requirements with multiple meanings. Correct discrepancies supported by the brief and summarize the fixes.