Skip to content
Back to search

pr-description

MarketplaceWorks with Claude CodeGitHub

A Claude Code skill for consistent pull request titles and descriptions

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/zh10only1--pr-description/badge.svg)](/listings/zh10only1--pr-description)

HTML

<a href="/listings/zh10only1--pr-description"><img src="/api/listings/zh10only1--pr-description/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

As a plugin (recommended)

Inside Claude Code:

/plugin marketplace add zh10only1/pr-description
/plugin install pr-description@pr-description

Update later with `/plugin marketplace update pr-description`.

As a plain skill file

For every project (user level):

mkdir -p ~/.claude/skills/pr-description
curl -fsSL https://raw.githubusercontent.com/zh10only1/pr-description/main/skills/pr-description/SKILL.md \
  -o ~/.claude/skills/pr-description/SKILL.md

For one repo only, so the whole team gets it, put the file at `.claude/skills/pr-description/SKILL.md` in that repo and commit it.

Pick one method. If the skill is installed both ways, Claude sees it twice.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 14 lines
  1. {
  2. "name": "pr-description",
  3. "description": "A Claude Code skill for consistent pull request titles and descriptions",
  4. "owner": {
  5. "name": "zh10only1"
  6. },
  7. "plugins": [
  8. {
  9. "name": "pr-description",
  10. "source": "./",
  11. "description": "Consistent, short, accurate pull request titles and descriptions in any repo: Summary, Behaviour, Deploy, Tests. No commit lists, no AI attribution."
  12. }
  13. ]
  14. }
README.md · README · 70 lines
  1. # pr-description
  2. A [Claude Code](https://claude.com/claude-code) skill that makes every pull request look the same, in any repo and whatever branch it targets: short, accurate, and organised by what changed rather than by commit.
  3. ## What you get
  4. **Title:** `type(scope): what it does, in plain words`, for example `feat(export): download a workspace as CSV`. A release PR (one branch into another) uses `Release: <what ships>`.
  5. **Body:** always the same four short sections:
  6. ```markdown
  7. ## Summary
  8. One or two sentences: what this PR does and why.
  9. ## Behaviour
  10. - What changed, in terms of what users or callers see
  11. - Contract changes and anything a reviewer could trip over
  12. ## Deploy
  13. Migrations, scripts, env vars, deploy order, or "Nothing to run."
  14. ## Tests
  15. What was actually run, and the real results.
  16. ```
  17. **Never in a PR:**
  18. - a list of commits (GitHub's Commits tab already shows them)
  19. - a file-by-file walkthrough
  20. - claims the diff doesn't back up
  21. - a "Generated with Claude Code" footer or Co-Authored-By lines
  22. Claude uses the skill on its own whenever it opens or edits a PR with `gh`. It also uses it when you ask for a title and description to paste yourself, for example "give me the PR title and description".
  23. ## Install
  24. ### As a plugin (recommended)
  25. Inside Claude Code:
  26. ```
  27. /plugin marketplace add zh10only1/pr-description
  28. /plugin install pr-description@pr-description
  29. ```
  30. Update later with `/plugin marketplace update pr-description`.
  31. ### As a plain skill file
  32. For every project (user level):
  33. ```sh
  34. mkdir -p ~/.claude/skills/pr-description
  35. curl -fsSL https://raw.githubusercontent.com/zh10only1/pr-description/main/skills/pr-description/SKILL.md \
  36. -o ~/.claude/skills/pr-description/SKILL.md
  37. ```
  38. For one repo only, so the whole team gets it, put the file at `.claude/skills/pr-description/SKILL.md` in that repo and commit it.
  39. Pick one method. If the skill is installed both ways, Claude sees it twice.
  40. ## Use
  41. Nothing to do. Open PRs as usual ("open a PR for this", "write the PR description") and Claude follows the skill. To call it directly, run `/pr-description`.
  42. To change the rules, edit [`skills/pr-description/SKILL.md`](skills/pr-description/SKILL.md), or your installed copy.
  43. ## License
  44. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.