describing-pull-requests

Generate GitHub PR descriptions from diffs, commits, and templates.

Updated Mar 8, 2026
One-click install
npx skills add https://github.com/ReadyStateChange/agents --skill describing-pull-requests
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: describing-pull-requests
Source: https://github.com/ReadyStateChange/agents/tree/main/skills/describing-pull-requests
Command: npx skills add https://github.com/ReadyStateChange/agents --skill describing-pull-requests

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Draft clear PR descriptions that explain changes, rationale, and verification requirements, enabling faster reviews and consistent templates.

Core Features & Use Cases

  • Generates or updates PR descriptions from diffs, commits, and repository templates
  • Enforces a standard structure with Summary, Changes, How To Verify, and Notes
  • Supports applying the final description to the PR via GitHub CLI when requested

Quick Start

Describe a PR by providing the PR number or URL and indicate whether to update the PR body or draft it.

Frequently Asked Questions about describing-pull-requests

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

FAQPage Schema
How do I generate a pull request description from a diff?

To generate a pull request description from a diff, provide the PR number or URL along with the diff and commit data. The tool drafts structured PR bodies with sections like Summary, Changes, and How To Verify.

Can I automatically update my GitHub PR body from commits?

Yes, you can automatically update your GitHub PR body from commits. The tool can apply the final drafted description directly to the PR using the GitHub CLI when you request an update.

What's the best way to draft a code review template for software development workflows?

The best way to draft a code review template for software development workflows is using repository templates to enforce a standard PR structure. This ensures changes, rationale, and verification requirements are clearly documented.

Does this PR description generator require GitHub CLI to apply changes?

No, the PR description generator does not require GitHub CLI to draft content, but you need GitHub CLI if you want to automatically apply the final generated body directly to the pull request.

What do I need to provide to draft a clear PR body from a diff?

To draft a clear PR body from a diff, you need to provide the PR number or URL and indicate whether to update the PR body or draft it. Access to PR data like diffs, commits, and metadata is required.

Why should I use a standard structure for pull request descriptions?

You should use a standard structure for pull request descriptions to enable faster code reviews and consistent templates. A standard format with Summary, Changes, and How To Verify sections clarifies rationale and verification requirements.