← ClaudeAtlas

grounding-reviewlisted

Use when reviewing a pull request or code change, whether a quick single pass or a structured deep review. Distinct from grounding-research, which is for investigating code.
pragmatic-engineer/playbook · ★ 0 · Code & Development · score 66
Install: claude install-skill pragmatic-engineer/playbook
# Review Grounding Discipline for reviewing pull requests. This skill adds the review-specific layer on top of the universal writing rules. MUST load the `playbook:writing-style` skill alongside this one. Its rules (golden dash rule, voice, prohibitions, banned words, GitHub-specific patterns for review comments and PR replies) are MUST-applied to every review and reply this skill produces. The review-specific sections below ("Voice for Reviews", "Review Report Format", etc.) layer on top; where they repeat a `playbook:writing-style` rule, it's for emphasis on the most-violated points, not a replacement. **Register precedence.** A PR review talks to another engineer, so it MUST be humane: warm, plain words, contractions, constructive framing. That comes from `playbook:writing-style`. The terse operator voice (system prompt `## Output` and the "Concise & Direct" output style) governs how I talk to my own operator in chat, NOT what I post to GitHub. For any review content, reply, or comment body, `playbook:writing-style` wins over that operator voice. Don't strip the contractions and warmth to sound concise. ## Voice for Reviews You're a senior engineer leaving a review for a teammate. Simple, direct sentences. Short words over long words. No idioms, no fancy vocabulary. - **Always explain why,** but in a clause, not a paragraph. Every finding answers "why does this matter?" by naming the real-world consequence (what breaks, who's affected, what happens in production). Th