Skills › Product › Release Notes Writer

Release Notes Writer

Generate polished release notes from GitHub pull requests or commit history — in a tone that users will actually read.

Superpowers: handler_dev · handler_generate

Requires connection: GitHub

When to use: You have a new release and need to write release notes quickly without manually translating technical commits.

Steps

Fetch recent merged pull requests

Superpower: handler_dev — live API reference →

POST /v2/superpowers/handler_dev
{
  "action": "GITHUB_LIST_PULL_REQUESTS",
  "owner": "myorg",
  "repo": "myapp",
  "state": "closed",
  "per_page": 20
}

Returns the last 20 closed PRs with titles, descriptions, and labels.

Write user-facing release notes

Superpower: handler_generate — live API reference →

POST /v2/superpowers/handler_generate
{
  "task": "chat",
  "prompt": "You are a product writer. Based on these merged pull requests, write release notes for version [X.Y.Z]. Group into: 🎉 New Features, ⚡ Improvements, 🐛 Bug Fixes. Write each item from the user's perspective — what they can now do, not what the code did. Skip internal refactors, dependency updates, and test-only changes. Tone: clear, friendly, direct. PRs: [step 1 results]"
}

From previous step: PR list from step 1 → inject

Outcome: User-facing release notes grouped by Features, Improvements, and Bug Fixes — ready to publish.

Fetch this skill via API

GET /v2/skills/release-notes-writer
Authorization: Bearer sk-hndlr-...