plumbeer-pr-pitch

Write pull request titles and descriptions focused on why the change exists.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/marioplumbeer/skills --skill plumbeer-pr-pitch-marioplumbeer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plumbeer-pr-pitch
Source: https://github.com/marioplumbeer/skills/tree/main/.agents/skills/plumbeer-pr-pitch
Command: npx skills add https://github.com/marioplumbeer/skills --skill plumbeer-pr-pitch-marioplumbeer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Pull request copy often narrates implementation details instead of explaining the motivation behind a change, forcing reviewers to reverse-engineer intent from the diff. This Skill produces titles and descriptions grounded in the why — the user pain, business need, or outcome — rather than what files changed. ## Core Features & Use Cases - Why-focused titles: Generates one imperative sentence under 72 characters describing the motivation or outcome, not the mechanism. - SAR-structured descriptions: Writes Situation, Action, Result sections that explain the problem, the intent-level approach, and the observable result. - Automatic context gathering: Runs git diff main...HEAD --stat and git log main...HEAD --oneline to infer intent when no summary is provided, asking one focused question only when the why is genuinely ambiguous. - Use Case: You finished a branch fixing silent logouts from expiring auth tokens. Instead of writing "Refactor token refresh logic", the Skill produces "Fix silent logout when auth token expires" with a description explaining the user impact. ## Quick Start Ask the assistant to write the PR title and description for your current branch, optionally pasting a diff or a short summary of the change.

Frequently Asked Questions about plumbeer-pr-pitch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a good PR title and description?▼

Write the title as one imperative sentence answering why the PR exists, kept under 72 characters. Structure the description with Situation, Action, and Result sections that explain the problem, the intent-level approach, and the observable outcome.

How to generate PR descriptions from a git diff?▼

Run git diff main...HEAD --stat and git log main...HEAD --oneline to gather context, then infer the intent behind the changes rather than cataloging them. The Skill does this automatically when you do not provide a summary.

Does this require git to be installed?▼

Yes, git is required because the Skill uses git diff and git log to gather context when none is provided. If you paste a diff or describe the change directly, the Skill can work from that input instead.

How do I write a PR description for a pure refactor?▼

State honestly that no behavior changed and explain why the refactor matters, such as making future changes easier, reducing incident surface, or improving testability. Do not list the new classes or pretend the change is invisible.

What if my PR is very large or the git history is noisy?▼

Scope the description to the single most important why rather than listing everything. When merge commits or rebases obscure intent, rely on git diff --stat and ask the user one focused question about the problem being solved.