revise
Installation
SKILL.md
Revise: feedback is a claim, not a command
Every finding is a hypothesis to test, not an instruction to follow. Reviewers, human or agent, often lack the project's context and this PR's priorities. A well-argued finding can still be wrong. The goal is a right PR, not a happy reviewer.
Required references
Paths are relative to this file. <plugin root> is two directories above it. Read each
file at the step named.
| File | Read at | Holds |
|---|---|---|
references/triage.md |
step 2 | cross-validation per claim, the scope fence, the premature-optimization test |
references/respond.md |
step 5 | the decision table, per-thread replies, ticket drafts, the report |
../../assets/writing.md |
step 5, before writing any reply or the report | the writing rules for every text a person reads |
references/rationalizations.md |
when tempted to just accept, silently drop, or drive-by | why each shortcut fails |