Skills

Describe PR

Generate comprehensive PR descriptions following repository templates

Install

npx skills add parcadei/Continuous-Claude-v3 --skill describe-pr -g -a claude-code -y
Category
Git and review
Updated
9mo ago
License
MIT
Context cost
Lightabout 1,127 tokens
Runs scripts
No, instructions only

What it does

Generate comprehensive PR descriptions following repository templates

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/pr_description.md exists
    • If it doesn't exist, inform the user they need to create a PR description template at thoughts/shared/pr_description.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 "$CLAUDE_PROJECT_DIR/.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
Read the whole SKILL.md on GitHub

More in Git and review