messaging-framework
Installation
SKILL.md
Messaging Framework
Core principles for writing commits, PR descriptions, branch names, and technical documentation.
Two Goals
| Goal | Purpose |
|---|---|
| Inform | Help the reader understand and remember what the work is about |
| Advertise | Argue the value so review effort feels worthwhile |
The Pain-Point Pattern
Structure messages around real pain points only:
- Observed problem
- Downstream implication
Do not write solution-heavy PR bodies. Reviewers will inspect the diff. Do not add test plan sections just to restate what is already visible in the changes.