pr-descriptionlisted
Install: claude install-skill victorhqc/filbert
# PR description
A PR description tells the reader what the branch brings to `main`. Keep it short.
Keep it true. Read the diff, then write what changed and why.
## 1. Inspect the branch
Do not guess. Look at the actual changes on the branch.
1. Find the base branch (usually `main`).
2. Run a diff to see what this branch adds, removes, or changes:
```sh
git --no-pager diff main...HEAD --stat
git --no-pager log main..HEAD --oneline
```
If the user already has a PR number, use the GitHub tools instead:
`pull_request_read` with `method: get` and `method: get_files`.
3. Read the changed files when you need to understand intent. Do not quote code
back at the reader — they can read the diff.
4. If a spec exists for the change, cite it in MLA form — `(topic NN)`. See
[`writing-specs`](../writing-specs/SKILL.md).
## 2. Write the description
Use the Hemingway approach:
- Short sentences. One idea per sentence.
- Plain words. No jargon when a common word works.
- Active voice. The subject does the thing.
- No filler. "In order to" is just "to". "At this point in time" is "now".
- No marketing. Say what the code does, not how amazing it is.
- No restating the title. The body adds new information.
Write for a teammate who knows the codebase but has not seen this branch yet.
## 3. Template
Fill in each section. Drop a section if it has nothing to say. Do not pad.
```markdown
## Title
<One sentence. What this branch does.>
## Summary
<One to three s