Pr description generator

Skill dcs-soni/skills/pr-description-generator

A collection of custom Claude Code Skills to supercharge your development workflow.

Install

npx -y skills add dcs-soni/skills --skill pr-description-generator

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

4.1 KB, as published. Nobody here has run it

PR Description Generator

Generate structured, comprehensive Pull Request descriptions from your git changes.

Why This Matters

Good PR descriptions:

Speed up reviews - Reviewers understand context instantly
Reduce bugs - Testing instructions catch issues early
Create documentation - Git history becomes useful

Quick Start

PR Description Workflow:
- [ ] Step 1: Analyze changes (diff + commits)
- [ ] Step 2: Detect PR type
- [ ] Step 3: Generate description
- [ ] Step 4: Copy to PR

Workflow

Step 1: Analyze Changes

Run the analysis script to understand what changed:

python scripts/analyze_changes.py --base main

What it extracts:

Files added, modified, deleted
Commit messages and authors
Issue references (#123, fixes #456)
Change statistics (lines added/removed)

Step 2: Detect PR Type

The script auto-detects the type based on:

Type	Detection
Feature	New files, `feat:` commits
Bugfix	`fix:`, `bug:` commits, issue refs
Refactor	`refactor:` commits, same file count
Docs	Only `.md` files, `docs:` commits
Chore	Config files, `chore:` commits

Step 3: Generate Description

Generate a complete PR description:

python scripts/generate_description.py --base main --output pr.md

Output includes:

Summary (auto-generated from commits)
Type of change checkboxes
Detailed changes list
Testing instructions
Related issues
Review checklist

Step 4: Copy to PR

Copy the generated markdown to your PR:

GitHub: Paste into description field
GitLab: Paste into MR description
Bitbucket: Paste into PR description

Utility Scripts

Script	Purpose
`analyze_changes.py`	Parse git diff and commits
`generate_description.py`	Generate PR description markdown

Configuration

Customize base branch:

python scripts/generate_description.py --base develop
python scripts/generate_description.py --base origin/main

Output to file:

python scripts/generate_description.py --output pr_description.md

Example

User: "Generate a PR description for my changes"

Generated Output:

## Summary

Adds user authentication with JWT tokens and password hashing.

## Type of Change

- [x] ✨ New feature
- [ ] 🐛 Bug fix
- [ ] ♻️ Refactoring
- [ ] 📝 Documentation

## Changes Made

- Added `POST /auth/login` endpoint with JWT token generation
- Added `POST /auth/register` endpoint with validation
- Added bcrypt password hashing
- Added JWT middleware for protected routes

## Files Changed

| Status   | File                    |
| -------- | ----------------------- |
| Added    | src/auth/login.ts       |
| Added    | src/auth/register.ts    |
| Modified | src/middleware/index.ts |

## Testing Instructions

1. Register: `curl -X POST /auth/register -d '{"email":"[email protected]","password":"secret"}'`
2. Login: `curl -X POST /auth/login -d '{"email":"[email protected]","password":"secret"}'`
3. Access protected route with `Authorization: Bearer <token>`

## Related Issues

Closes #42

## Checklist

- [ ] Tests added/updated
- [ ] Documentation updated
- [ ] No breaking changes

Templates

See TEMPLATES.md for PR templates by change type.

Related Skills

codebase-onboarding — Understand the codebase before reviewing
stale-todo-finder — Ensure no stale TODOs in changed files