describe-pr

Generate pull request descriptions from code diffs and commit history.

1|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/charly-vibes/wai --skill describe-pr-charly-vibes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: describe-pr
Source: https://github.com/charly-vibes/wai/tree/main/.agents/skills/describe-pr
Command: npx skills add https://github.com/charly-vibes/wai --skill describe-pr-charly-vibes

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, and includes scripts (resource) components.

What problem does it solve?

This Skill automates the creation of comprehensive pull request descriptions by analyzing code changes, saving developers time and ensuring crucial context is captured.

Core Features & Use Cases

  • Automated PR Summaries: Generates detailed descriptions based on code diffs.
  • Contextual Analysis: Explains the "what" and "why" behind code changes.
  • Structured Documentation: Produces PR documentation including summary, changes, motivation, implementation details, and testing guidance.
  • Use Case: After pushing a complex feature branch, run this Skill to get a ready-to-use PR description that includes all necessary technical details and reasoning for your reviewers.

Quick Start

Use the describe-pr skill to generate a description for the current pull request.

Frequently Asked Questions about describe-pr

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

FAQPage Schema
How do I generate a pull request description from code diffs automatically?

To generate a pull request description automatically, this Skill analyzes your code diffs and commit history to produce structured markdown documentation covering the summary, motivation, and implementation details for reviewers.

What is the best way to automate GitHub PR documentation for complex feature branches?

Automating GitHub PR documentation is best handled by analyzing commit history and code diffs to explain the what and why of changes, outputting a structured template with testing and security considerations.

Do I need the GitHub CLI installed to automate pull request summaries?

Yes, you need the GitHub CLI (gh) installed, as the Skill integrates directly with it to fetch pull request data and code diffs required for generating the comprehensive descriptions.

Can I use this to explain the motivation behind code changes in my pull request?

Yes, you can use this to explain code change motivations, as the Skill performs contextual analysis on your diffs and commits to articulate the reasoning and implementation details for reviewers.

What sections are included in an automated PR description generated from code?

An automated PR description generated from code includes structured markdown sections for the summary, changes, motivation, implementation details, testing guidance, and security considerations.

Does this automated PR description tool work without manual code review formatting?

Yes, it works without manual formatting by automatically extracting technical details from your code diffs and using a predefined markdown template to structure the final pull request documentation.