prose-review
Installation
SKILL.md
Review the prose this work adds — comments, docstrings, changelog entries — against
the "Writing for Future Readers" section of AGENTS.md, which is the authority.
This skill is the operational check.
The reader you are writing for has never seen this change. They open the file months from now and see only the code as it stands. Detail that feels important while making a change — what the code used to do, why an alternative was rejected, that the fix was verified — is invisible context to them, and often actively misleading.
Scope
| Argument | Diff to review |
|---|---|
staged |
git diff --cached -U0 |
branch (default) |
git diff $(git merge-base main HEAD) -U0 |
<path> |
git diff $(git merge-base main HEAD) -U0 -- <path> |