gh:pr-description

What problem does it solve?

Write or regenerate a value-first pull-request description (title + body) for the current branch's commits or for a specified PR. Use when the user says 'write a PR description', 'refresh the PR description', 'regenerate the PR body', 'rewrite this PR', 'freshen the PR', 'update the PR description', 'draft a PR body for this diff', 'describe this PR properly', 'generate the PR title', or pastes a GitHub PR URL / #NN / number. Also used internally by git-commit-push-pr (single-PR flow) and gh-pr-stack (per-layer stack descriptions) so all callers share one writing voice. Input is a natural-language prompt. A PR reference picks a specific PR; anything else is treated as optional steering for the default 'describe my current branch' mode. Returns structured {title, body_file} for the caller to apply via gh pr edit or gh pr create — this skill never edits the PR itself and never prompts for interactive confirmation.

Core Features & Use Cases

• Generate a conventional-commit-style PR title and a value-first body describing the work done in the PR.
• Accept a PR reference in multiple formats (URL, pr:NN, #NN, or bare number) or describe the current branch when omitted.
• Return a structured {title, body_file} for the caller to apply via gh pr edit or gh pr create, without mutating the PR.

Quick Start

Provide a natural-language prompt to generate the PR title and body.