writing-pr-descriptions - Write clear, reviewable pull request descriptions
Shapes a complete PR body that explains the need, changes, evidence, risks, and review-relevant details without relying on the diff.
Tags
Updated: 2026-10-16Capabilities
Typical Inputs
Typical Outputs
What this skill does
- Preserve existing PR content
- State the underlying need
- Describe visible changes
- Route facts to suitable forms
- Add evidence and media
- Check title and opening lines
- Remove unnecessary detail
- Mark unsupported claims
Inputs
- Existing PR body
- Pull request diff
- Request or issue
- Discussion thread
- Measurement or evidence
- Pull request number
- Running application
- Storybook story
Outputs
- PR description body
- Edited GitHub PR body
- Screenshots or feature reels
- Tables or diagrams
- Evidence links
- Review notes on risks
Requirements
- GitHub pull request access
- GitHub CLI
- hogli image upload command
- Running app or Storybook for visual changes
- Headless browser for screenshots