pr-summary
Creates comprehensive Pull Request summaries with changes, test plan, and related issues.
About this skill
The `pr-summary` skill is designed to automate the creation of well-formatted Pull Request descriptions. It takes a series of inputs such as the PR title, an array of changes implemented, an optional array of test plan items, and an optional array of related issue numbers. The skill then processes these inputs and generates a neatly structured Markdown string that is ready to be used as a PR description. This skill is particularly beneficial for developers and teams aiming to standardize their code review process and improve documentation consistency. By automating the summary generation, it ensures that all essential information — what was changed, how it was tested, and which issues it addresses — is consistently included in every pull request, reducing manual effort and potential oversight. Users would leverage this skill to save time when drafting PRs, enhance the clarity and completeness of their code contributions, and facilitate smoother code reviews. It helps maintain a high standard of communication within development teams and ensures that PRs are always linked back to their respective tasks or bugs, improving project traceability and management.
Best use case
The primary use case for `pr-summary` is to standardize and automate the generation of pull request descriptions within a software development workflow. Developers, particularly those in teams that prioritize consistent documentation and efficient code reviews, benefit significantly by quickly producing clear, comprehensive, and uniformly formatted PR summaries, reducing manual drafting time and ensuring all critical information is present.
Creates comprehensive Pull Request summaries with changes, test plan, and related issues.
A well-formatted, Markdown-based string containing a summary of your pull request, including changes, test plan, and related issues, ready for use in a PR description field.
Practical example
Example input
{"title": "Fix: Implement robust error handling for API endpoints", "changes": ["Added try-catch blocks to all critical API routes", "Standardized error response format (JSON)", "Implemented custom error middleware"], "testPlan": ["Verify all existing API endpoints still function correctly", "Test custom error messages for various failure scenarios", "Ensure proper logging of errors"], "issues": [201, 205]}Example output
## Summary Fix: Implement robust error handling for API endpoints ## Changes - Added try-catch blocks to all critical API routes - Standardized error response format (JSON) - Implemented custom error middleware ## Test Plan - [ ] Verify all existing API endpoints still function correctly - [ ] Test custom error messages for various failure scenarios - [ ] Ensure proper logging of errors ## Related Issues - Closes #201 - Closes #205 --- 🤖 Generated with [Claude Code](https://claude.com/claude-code)
When to use this skill
- When submitting a new pull request for code review.
- To ensure consistent and comprehensive formatting for all PR descriptions.
- When linking a pull request to specific issues or tasks in a project tracker.
- To quickly generate a structured test plan alongside your code changes.
When not to use this skill
- When the PR description requires a completely custom or free-form format not supported by the skill's inputs.
- When you need to interact directly with a Git platform's API (e.g., creating the PR itself, merging, commenting).
- When only a very brief, informal summary is sufficient and structure is not a concern.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/pr-summary/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How pr-summary Compares
| Feature / Agent | pr-summary | Standard Approach |
|---|---|---|
| Platform Support | Claude | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | easy | N/A |
Frequently Asked Questions
What does this skill do?
Creates comprehensive Pull Request summaries with changes, test plan, and related issues.
Which AI agents support this skill?
This skill is designed for Claude.
How difficult is it to install?
The installation complexity is rated as easy. You can find the installation instructions above.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
AI Agents for Coding
Browse AI agent skills for coding, debugging, testing, refactoring, code review, and developer workflows across Claude, Cursor, and Codex.
Best AI Skills for Claude
Explore the best AI skills for Claude and Claude Code across coding, research, workflow automation, documentation, and agent operations.
Top AI Agents for Productivity
See the top AI agent skills for productivity, workflow automation, operational systems, documentation, and everyday task execution.
SKILL.md Source
# pr-summary
Creates comprehensive Pull Request summaries with changes, test plan, and related issues.
## Metadata
- **Version**: 1.0.0
- **Category**: git-workflow
- **Source**: workspace
## Tags
`git`, `pull-request`, `github`
## MCP Dependencies
None specified
## Inputs
- `title` (string) (required): PR title
- `changes` (array) (required): List of changes made
- `testPlan` (array) (optional): Test plan items
- `issues` (array) (optional): Related issue numbers
## Workflow
No workflow defined
## Anti-Hallucination Rules
None specified
## Verification Checklist
None specified
## Usage
```typescript
// Execute via MCP Gateway:
gateway_execute_skill({ name: "pr-summary", inputs: { ... } })
// Or via REST API:
// POST /api/code/skills/pr-summary/execute
// Body: { "inputs": { ... } }
```
## Code
```typescript
const { title, changes, testPlan = ['Verify tests pass', 'Manual testing'], issues = [] } = inputs;
let pr = `## Summary\n${title}\n\n## Changes\n`;
for (const c of changes) pr += `- ${c}\n`;
pr += `\n## Test Plan\n`;
for (const t of testPlan) pr += `- [ ] ${t}\n`;
if (issues.length > 0) {
pr += `\n## Related Issues\n`;
for (const i of issues) pr += `- Closes #${i}\n`;
}
pr += `\n---\n🤖 Generated with [Claude Code](https://claude.com/claude-code)`;
console.log(pr);
```
---
Created: Mon Dec 22 2025 10:36:14 GMT+0800 (Singapore Standard Time)
Updated: Mon Dec 22 2025 10:36:14 GMT+0800 (Singapore Standard Time)