Frameworks for giving and receiving code review feedback effectively. Use for PR comments, review strategies, handling disagreements, and balancing thoroughness with kindness.
This skill provides frameworks for effective code review communication - both giving feedback that lands well and receiving feedback without defensiveness.
A labeling system that makes the intent of each comment crystal clear.
Format: [label] (decoration): explanation
Labels:
| Label | Meaning | Action Required |
|---|---|---|
praise | Highlight good work |
| None - encouragement |
nitpick | Minor style/preference issue | Optional |
suggestion | Improvement idea | Consider but not required |
issue | Must be addressed | Required before merge |
question | Need clarification | Response required |
thought | Sharing perspective | None - FYI only |
Decorations:
(non-blocking) - Explicitly optional(blocking) - Must be resolved(if-minor) - Only if the fix is trivialExamples: