Agent skill
pr-description
Generate professional pull request descriptions from git diff with summary, changes, security impact, and testing notes
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/pr-description
SKILL.md
Pull Request Description Generator
Create the most complete and professional Git merge/pull request description, following established best practices.
Procedure
Phase 1 - Fetch and Analyze Changes
- Get all changes in this branch compared to the default branch since it diverged
- Detect modified files and classify them (e.g., source code, configuration, documentation, tests)
- Identify major functional areas affected (e.g., ui, auth, api, contracts, security)
- Detect breaking changes, dependency updates, and any migration requirements
- Summarize the purpose, major changes, affected components, and any security, dependency, or testing implications
Phase 2 - Generate Merge Request Description
Generate a detailed and professional description in Markdown format:
## Summary
Short high level overview of the purpose.
## Description
Detailed descriptions of all the changes made, their scope, impact and effects.
## Motivation / Context
Why the change is required, including the issue reference if applicable.
## Changes
- [ ] List of major code or feature changes.
- [ ] Highlight of configuration, deployment, or dependency updates.
## Affected Functions
- List `functions` that were added/modified/deleted with brief description
## Security Impact
[icon] Brief summary of security impact
- [ ] List any security-sensitive modifications if any and mitigation strategy if addressed.
## Testing
- [ ] List or summarize test coverage and new test cases.
- [ ] Include steps for manual verification.
## Backward Compatibility
- [icon] Note if any breaking changes exist.
- [icon] Provide migration instructions if needed.
Phase 3 - Refinement
- Use consistent tense and technical clarity
- Enforce line length under 100 characters where possible
- Remove redundant or trivial commit noise (e.g., "fix typo")
- Cross-reference related issues or tickets automatically (Fixes #1234)
Constraints
- Analyze only within the given code. Do not invent missing context or external APIs
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?