Write a customer-readable pull request description in Claude Code
Describe the business background and user-visible outcome in two English sections, leaving implementation details to engineering records.
中文Install in Claude Code
A Claude Code workspace with the Radiofy ticket background and verified customer impact.
- Review `.claude/skills/pr-writing/SKILL.md` and its requirements at the pinned GitHub commit.
- Create `.claude/skills/pr-writing/` in your project and save the reviewed file as `.claude/skills/pr-writing/SKILL.md`.
- Start Claude Code from that project's root, then select `/pr-writing` in the slash menu.
Example task
The fictional ticket says `{background:'weekly playlist repeats songs',outcome:'each track appears once'}`. The confirmed change deduplicates synchronized weekly playlists.What to check
Use `[Background, What this change does]`. In Background, say that weekly playlists showed tracks more than once. In the outcome, state that each track now appears once.
Original SKILL.md on GitHub · Updated
Frequently asked question
How do I make a pull request description understandable to a customer?
Start with the ticket's problem, then explain what the reader can see or do after the change. Use the project's English section headings.