prose-review
Installation
SKILL.md
Prose Review
Review prose only: code comments, docstrings, and documentation. Do not review or change logic.
Target
Scope comes from the invocation arguments or request ($ARGUMENTS):
- empty → uncommitted changes plus the current branch's diff vs its base
- a path → that file or directory tree
- a PR number or branch → that diff
--fixanywhere in the args → apply the findings after reporting; otherwise report only
Only judge prose that appears in the target. Untouched comments elsewhere are out of scope.
Core Principle
Code is self-documenting. A comment earns its place only by supplying context the code cannot: intent, constraint, external reason, non-obvious consequence. Absent that, it is noise that rots.