pr-summary

Creates comprehensive Pull Request summaries with changes, test plan, and related issues.

13 stars
Complexity: easy

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

$curl -o ~/.claude/skills/pr-summary/SKILL.md --create-dirs "https://raw.githubusercontent.com/abdullah1854/MCPGateway/main/.agents/skills/pr-summary/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/pr-summary/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How pr-summary Compares

Feature / Agentpr-summaryStandard Approach
Platform SupportClaudeLimited / Varies
Context Awareness High Baseline
Installation ComplexityeasyN/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

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)

Related Skills

Claude Skill Development Guide

12
from rootvc/claude-apply-skill

This document explains how the Root Ventures Apply skill is structured and how to create similar Claude skills.

Workflow & ProductivityClaude

VibeCollab — Setup Instructions for AI Assistants

9
from flashpoint493/VibeCollab

You are helping a user set up VibeCollab in their project.

Workflow & Productivity

You are a professional Landing page designer who is very friendly and supportive.

6
from Harmeet10000/skills

Your task is to guide a beginner through planning and designing a landing page or personal portfolio.

Workflow & Productivity

superteam-academy-dev

12
from solanabr/superteam-academy

Superteam Academy — decentralized learning platform on Solana with soulbound XP tokens (Token-2022), Metaplex Core credentials, course registry, achievements, and creator incentives. Covers Anchor program development, testing with LiteSVM/Mollusk/Trident.

Solana Development & CodingClaude

opentestai

10
from jarbon/opentestai

Open-source automated bug detection, persona feedback, and test case generation using 33+ specialized AI testing agent profiles. Analyzes application screenshots, network logs, console logs, and DOM/accessibility trees for issues. Selects relevant virtual tester profiles based on artifact content, then runs each tester's specialized prompt to find high-confidence bugs. Also generates diverse user persona feedback panels for UX/product insight, and creates comprehensive test case suites for any page. Supports quick check, deep check, compliance audit, and diff/comparison modes. Use this skill when the user asks to: "check for bugs", "test this page", "find issues", "audit this", "QA check", "review for issues", "get persona feedback", "user feedback", "persona panel", "what would users think", "generate test cases", "create tests", "write test cases", "test suite", "quick check", "deep check", "compliance audit", "GDPR audit", "accessibility audit", "compare to last run", "diff", or provides screenshots, console logs, network logs, URLs, or DOM content for analysis.

Testing & QAClaude

writing-content

7
from ai-mindset-org/pos-sprint

Интерактивный процесс написания текстов для вайб-маркетинга на основе Julian Shapiro framework. **Новые возможности (v2.0):** - Research & Gap Analysis (Perplexity → WebSearch fallback) - Scoring 0-5 вместо binary (Novelty + Resonance + Hook + Clarity) - AI-Slop Detection на всех этапах (10 типов patterns) - 3 варианта intro с self-scoring - Markdown export всех промежуточных результатов **Русские triggers:** "напиши пост по шапиро", "написать статью по фреймворку шапиро", "создай текст в стиле julian shapiro", "помоги написать контент по методу shapiro", "контент по julian shapiro фреймворку", "пост по julian shapiro", "напиши в стиле шапиро" **English triggers:** "write content using julian shapiro framework", "create post with shapiro method", "write article shapiro style", "help with julian shapiro writing" **Generic triggers:** "напиши статью", "помоги написать контент", "создай текст", "начать писать", "хочу написать пост", "нужна помощь с текстом", "write content", "write article", "создай контент", "придумай идею для статьи", or requests help with content creation process.

Content & DocumentationClaude

test-driven-fix

13
from abdullah1854/MCPGateway

Test-first debugging loop that reproduces bugs with failing tests, then iterates until tests pass. Activates for "write a test first", "test-driven fix", "TDD fix", "reproduce with test", "make it pass", or when fixing bugs that have an existing test suite.

sql-analyzer

13
from abdullah1854/MCPGateway

Analyzes SQL queries for anti-patterns, performance issues, and suggests optimizations.

session-handoff

13
from abdullah1854/MCPGateway

Preserves context across sessions and IDE switches. Activates for "save session", "handoff", "continue later", "switching IDE", "save context", "what did we do", "summarize session", "end session".

seo-recovery

13
from abdullah1854/MCPGateway

SEO traffic recovery protocol for diagnosing and fixing indexing drops, canonical mismatches, hreflang bugs, and toxic sitemaps. Integrates with Google Search Console via MCP Gateway. Includes Hostinger deployment awareness for OPcache/CDN friction. Activates for "SEO", "traffic drop", "indexing", "canonical", "hreflang", "sitemap", "search console", "GSC", "crawl errors", "deindexed", "organic traffic".

infra-deploy

13
from abdullah1854/MCPGateway

Infrastructure deployment for VPS, Docker, and cloud platforms. Activates for "deploy", "setup server", "docker", "coolify", "VPS", "SSH", "nginx", "production", "hosting" requests.

hostinger-deploy

13
from abdullah1854/MCPGateway

Hostinger-specific deployment protocol handling OPcache, CDN caching, and hPanel Git mechanism. Activates for "deploy to hostinger", "hostinger", "redeploy", "publish website", "push to production" when target is Hostinger.