ronnasayd/ai-pair-programming/generate-pr-description

Claude Code and agent skill by ronnasayd/ai-pair-programming

Trust tier 3
  • community
Source check pending

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-description

SKILL.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 ====================

  1. Check if .github/pull_request_template.md exists in workspace.
  2. Exists → read content, use as MANDATORY structure for PR description.
  3. 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 ====================

  1. Identify changes to describe:
  • Arguments name a base branch → run git diff origin/<base>...HEAD and 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 --staged empty → run git diff main...HEAD (or default branch) for current branch changes.
  • Still empty → stop and return status: partial with reason: no changes found.
  1. Run git log -n 10 --oneline to understand commit sequence + intent.
  2. Search .taskmaster/ or docs/ for relevant PRDs/task specs matching branch name or commit keywords.

==================== PHASE 3 — GENERATION ====================

Based on analysis, generate PR description:

  1. Follow detected or default template strictly.
  2. Tone professional, content accurate.
  3. 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):

markdown
## Description
This PR introduces a new skill for generating PR descriptions automatically...
## Impact
-Improves developer productivity by automating repetitive documentation tasks.
-Ensures consistent PR descriptions across the project.
## Task
-Create skills/generate-pr-description/SKILL.md
-Implement template detection logic.
-Add language selection support.

==================== 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

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
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/ronnasayd/ai-pair-programming/generate-pr-description/badge)](https://verified-skill.com/skills/ronnasayd/ai-pair-programming/generate-pr-description)

Something wrong with this skill or its page? Tell us.