ronnasayd/ai-pair-programming/generate-pr-description
Claude Code and agent skill by ronnasayd/ai-pair-programming
- community
Checking that the SKILL.md file is still in the repository.
Generate structured Pull Request descriptions from git diffs (staged or branch) and commit history. Auto-detects .github/pull_request_template.md; falls back to Description/Impact/Task sections. Use when user says 'generate PR description', 'write PR description', 'create pull request description', 'draft the PR description', or 'summarize this branch for a PR'. Requires the output language as an argument; ask the user before invoking if not specified.
Install
npx vskill@latest install ronnasayd/ai-pair-programming/generate-pr-descriptionSKILL.md
The same SKILL.md was published earlier as ronnasayd/ai-pair-programming/generate-pr-description.
Language: $ARGUMENTS
This skill runs as an isolated subagent: it has no conversation history and cannot ask the user anything. It only reads and reports; it does not change code. MANDATORY: language above is empty → stop and return status: partial with reason: missing language, so the caller can ask and invoke again.
Objective: generate professional, comprehensive PR description by analyzing staged changes + recent commit history.
==================== PHASE 1 — TEMPLATE DETECTION ====================
- Check if
.github/pull_request_template.mdexists in workspace. - Exists → read content, use as MANDATORY structure for PR description.
- Not exist → use default topics as sections:
- ## Description: High-level overview of what PR does.
- ## Impact: Technical + functional impact of changes.
- ## Task: List of specific tasks or user stories addressed.
==================== PHASE 2 — CONTEXT GATHERING ====================
- Identify changes to describe:
- Arguments name a base branch → run
git diff origin/<base>...HEADand use only it; ignore staged and uncommitted changes, they are not part of the PR. - Run
git diff --staged. Not empty → use as primary source. git diff --stagedempty → rungit diff main...HEAD(or default branch) for current branch changes.- Still empty → stop and return
status: partialwithreason: no changes found.
- Run
git log -n 10 --onelineto understand commit sequence + intent. - Search
.taskmaster/ordocs/for relevant PRDs/task specs matching branch name or commit keywords.
==================== PHASE 3 — GENERATION ====================
Based on analysis, generate PR description:
- Follow detected or default template strictly.
- Tone professional, content accurate.
- Generate entire description in the specified language.
==================== PHASE 4 — VALIDATION ====================
Run python3 skills/generate-pr-description/scripts/validate_pr_description.py --message "<generated description>" before presenting it. FAIL (exit 1) → fix flagged sections (missing/empty/placeholder text) and re-run until it passes.
==================== PHASE 5 — OUTPUT ====================
Your final response must contain the complete PR description verbatim in a Markdown block, alongside any other fields your final response requires.
Example Output (Default Template):
==================== WORKFLOW ====================
- Always verify PR template exists before proposing structure.
- Use commit history to add context not obvious from diff alone.
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/generate-pr-description/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/ronnasayd/ai-pair-programming/generate-pr-description)