pr-describe

Generates ICEA-traceable pull request descriptions from git diffs for Azure DevOps or GitHub.

1|Updated Jun 27, 2026
One-click install
npx skills add https://github.com/vickysrawat/AI-Assisted-development --skill pr-describe-vickysrawat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pr-describe
Source: https://github.com/vickysrawat/AI-Assisted-development/tree/main/skills/pr-describe
Command: npx skills add https://github.com/vickysrawat/AI-Assisted-development --skill pr-describe-vickysrawat

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing pull request descriptions that accurately map every code change to its approved requirements is tedious and error-prone, and reviewers often cannot tell whether a change matches the agreed scope. This Skill automates that by reading the actual git diff against the base branch and producing a structured, ICEA-traceable PR description. ## Core Features & Use Cases - Diff-driven generation: Automatically resolves the base branch (Azure DevOps or GitHub), reads the git log and diff, and extracts the ADO work item ID from the branch name. - ICEA traceability: Maps every changed file to Acceptance Criteria, builds a scenario-coverage table, and flags scope creep when code exists without a matching requirement. - Reviewer-ready output: Produces a complete PR description with per-layer change summaries, test evidence, a Definition of Done checklist, and a self-review checklist. - Use Case: A developer finishes a feature branch, asks for a PR description, pastes the approved ICEA, and receives a complete description where each Acceptance Criterion links to the implementing file and each ICEA scenario links to its test. ## Quick Start Ask the assistant to write a PR description for your current branch and paste the approved ICEA for the linked ADO work item.

Frequently Asked Questions about pr-describe

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

FAQPage Schema
How do I generate a pull request description from my git diff?

Ask for a PR description on your feature branch and the skill reads the git log and diff against the resolved base branch automatically. It then maps each changed file to your ICEA Acceptance Criteria and outputs a complete reviewer-ready description.

Does this work with Azure DevOps and GitHub pull requests?

Yes, both hosting platforms are supported and auto-detected. The base branch policy differs: Azure DevOps uses dev-or-ask, while GitHub uses the remote default branch, and ADO work item IDs are extracted from the branch name either way.

How does the PR description map changes to acceptance criteria?

It applies a shared traceability-mapping spec that builds a bidirectional correspondence between the diff and the ICEA Acceptance Criteria. Each criterion is marked implemented only when corresponding code is found, with file and line evidence.

What happens if my branch has no commits or an empty diff?

The skill refuses to generate a description and reports that no changes were detected between your branch and the base branch. It suggests running git diff against the base branch to verify your branch has commits.

Can it detect scope creep in my pull request?

Yes, after generating the description it runs the code-to-requirement direction of the traceability mapping. Any code change without a matching ICEA requirement is flagged in a scope-creep warning block rather than silently included.