pr-description-writer

Generate structured pull request descriptions from git diffs, commits, or change summaries.

1|Updated May 19, 2026
One-click install
npx skills add https://github.com/thomasmartinsen/talks --skill pr-description-writer-thomasmartinsen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pr-description-writer
Source: https://github.com/thomasmartinsen/talks/tree/main/20260519%20-%20Agentic%20engineering/primitives/skills/dev-docs/skills/pr-description-writer
Command: npx skills add https://github.com/thomasmartinsen/talks --skill pr-description-writer-thomasmartinsen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Pull requests often ship with missing, thin, or jargon-heavy descriptions that slow down code review and leave future developers without useful context. This Skill turns a git diff, commit list, or rough notes into a complete, well-structured PR description that explains both what changed and why. ## Core Features & Use Cases - Structured PR Templates: Produces descriptions with Summary, Changes, Testing, Breaking Changes, and Related sections, including checkbox-style testing evidence. - Dual Tone Modes: Adapts output for internal reviewers or stakeholder-facing audiences, with an extended template covering migration guides, timelines, and business-value-first summaries. - Assumption Flagging: Ends each draft with a note listing gaps (missing ticket links, unconfirmed tests, unspecified breaking-change impact) so the author knows exactly what to fill in. - Use Case: After finishing a feature branch, paste your git log --oneline output and a one-line summary, and receive a review-ready PR body that flags the DB migration as a breaking change and prompts you to confirm integration test status. ## Quick Start Ask the assistant to write a PR description from your git diff or a short summary of what changed and why.

Frequently Asked Questions about pr-description-writer

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

FAQPage Schema
How do I write a good pull request description?

Start with a 1-3 sentence summary explaining what the PR does and why, then list changes grouped by area, document how it was tested, and call out breaking changes. This Skill generates that structure automatically from a git diff or plain-language summary.

How to generate a PR description from a git diff?

Provide the git diff, git log output, or a list of changed files as input. The Skill identifies what changed, why, the affected scope, and any breaking changes, then drafts a complete structured description you can refine.

What should a stakeholder-facing PR description include?

Lead with the business value in the first sentence, describe changes in non-technical terms, present breaking changes in a table with required actions, and include a migration guide and timeline. Technical details like stack traces go in collapsible sections.

Should database migrations be listed as breaking changes in a PR?

Yes. Schema changes such as column renames, table drops, and default changes are breaking changes even when migrations run automatically. They should appear in the Breaking Changes section in addition to any mention in the changes list.

What if I only have a rough draft or ticket number for my PR?

A rough draft, ticket title, or plain-language summary is sufficient input. The Skill drafts the full description and appends a note flagging assumptions, such as missing ticket links or unconfirmed testing, so you know what to complete.