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
  • --fix anywhere 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.

Installs
8
GitHub Stars
1
First Seen
Sep 23, 2026