Agent skill · writing content · parcadei
describe-pr
Generate comprehensive PR descriptions following repository templates
Why this skill is useful
Adds a structured approach to generating PR descriptions that incorporates repository-specific templates and comprehensive analysis, which the AI wouldn't reliably generate on its own.
What it needs
Requires gh installed locally. About 3k tokens when loaded. Last updated 2026-01-26. 3,881 stars on the source repository.
What this skill does
Generate PR Description You are tasked with generating a comprehensive pull request description following the repository's standard template. Steps to follow: 1. Read the PR description template: First, check if thoughts/shared/prdescription.md exists If it doesn't exist, inform the user they need to create a PR description template at thoughts/shared/prdescription.md Read the template carefully to understand all sections and requirements 2. Identify the PR to describe: Check if the current branch has an associated PR: gh pr view --json url,number,title,state 2>/dev/null If no PR exists for the current branch, or if on main/master, list open PRs: gh pr list --limit 10 --json number,title,headRefName,author Ask the user which PR they want to describe 3. Check for existing description: Check if thoughts/shared/prs/{number}description.md already exists If it exists, read it and inform the user you'll be updating it Consider what has changed since the last description was written 4. Gather comprehensive PR information: Get the full PR diff: gh pr diff {number} If you get an error about no default remote repository, instruct the user to run gh repo set-default and select the appropriate repository Get commit history: gh pr view {number} --json commits Review the base branch: gh pr view {number} --json baseRefName Get PR metadata: gh pr view {number} --json url,title,number,state 4b. Gather reasoning history (if available): Check if reasoning files exist: ls .git/claude/commits//reasoning.md 2>/dev/null If they exist, aggregate them: bash "$CLAUDEPROJECTDIR/.claude/scripts/aggregate-reasoning.sh" main This shows what approaches were tried before the final solution Save the output for inclusion in the PR description 5. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills parcadei/describe_pr