Skills › Engineering › PR Description Writer

PR Description Writer

Automatically draft a clear, well-structured pull request description from commit history and changed files.

Superpowers: handler_dev · handler_generate

Requires connection: GitHub

When to use: You've finished a feature or fix and need a proper PR description without spending 20 minutes writing it.

Steps

Get the commits on the branch

Superpower: handler_dev — live API reference →

POST /v2/superpowers/handler_dev
{
  "action": "GITHUB_LIST_COMMITS",
  "owner": "myorg",
  "repo": "myapp",
  "sha": "feature/my-branch"
}

Returns all commits on the branch with messages and authors.

Draft the PR description

Superpower: handler_generate — live API reference →

POST /v2/superpowers/handler_generate
{
  "task": "chat",
  "prompt": "Write a pull request description for this set of commits. Include: (1) ## Summary — 2-3 sentences on what this PR does and why, (2) ## Changes — bullet list of key changes (not a commit-by-commit repeat), (3) ## How to test — 3-5 testing steps, (4) ## Notes — anything reviewers should be aware of. Tone: technical and direct. Commits: [step 1 results]"
}

From previous step: commit list from step 1 → inject

Outcome: Well-structured PR description: summary, change list, testing steps, and reviewer notes.

Fetch this skill via API

GET /v2/skills/pr-description-writer
Authorization: Bearer sk-hndlr-...