mcpField
C
creating-pr

creating-pr

github.com/revitalb-portDevelopment081 installsUpdated 11w ago
Repository

About creating-pr

A development skill for preparing and creating reviewable pull requests. It covers branch preparation, title and description conventions, self-review checks, PR creation, and reviewer requests.

Key features

  1. 01Update and inspect the branch before opening a PR
  2. 02Use conventional PR titles and descriptions
  3. 03Review diffs and check tests, types, and lint
  4. 04Create PRs with the GitHub CLI
  5. 05Request reviewers and label the PR

Use cases

  1. 01Prepare a branch for a pull request
  2. 02Check changes and required project validations
  3. 03Write a structured PR description
  4. 04Organize review for large or dependent PRs

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/revitalb-port/skills-registry-demo --skill creating-pr

After installing, type/creating-prin Claude Code to confirm it loaded.

Details

From the project README

Creating a PR

Package work into a pull request that's easy to review and merge.

Workflow

1. Prepare the Branch

Before creating the PR:

# Ensure branch is up to date with base
git fetch origin
git rebase origin/main  # or merge, depending on project convention

# Check what will be in the PR
git log origin/main..HEAD --oneline
git diff origin/main --stat

Squash fixup commits if the project prefers clean history. Keep logical commits separate if the project prefers granular history.

2. Write the Title

Format: <type>: <short description>

TypeWhen
featNew feature
fixBug fix
refactorCode change that neither fixes a bug nor adds a feature
docsDocumentation only
testAdding or fixing tests
choreBuild, CI, deps, or tooling
perfPerformance improvement

Examples:

  • feat: add dark mode toggle to settings page
  • fix: prevent duplicate form submissions on checkout
  • refactor: extract auth middleware into shared module
3. Write the Description

Use this structure:

## Summary

1-3 sentences explaining what this PR does and why.

Closes #123

## Changes

- Added `ThemeToggle` component with system/light/dark options
- Updated `Layout` to read theme from context
- Added theme persistence to localStorage

## Test Plan

- [ ] Toggle between light/dark/system themes
- [ ] Refresh page — theme persists
- [ ] Check no flash of unstyled content on load
4. Self-Review

Before requesting review:

  • Read every line of the diff yourself
  • Remove debug code (console.log, TODO, commented-out code)
  • Verify tests pass: npm test
  • Verify types: npx tsc --noEmit
  • Verify lint: npm run lint
  • Check for files that shouldn't be committed (.env, lockfile conflicts)
5. Create the PR
git push -u origin HEAD
gh pr create --title "<title>" --body "$(cat <<'EOF'
## Summary
...

## Changes
...

## Test Plan
...
EOF
)"
6. Request Review
  • Tag the appropriate reviewers (code owners, domain experts)
  • If the PR is large (>400 lines), add a comment explaining the best order to review files
  • If the PR depends on another PR, note it in the description
  • Label the PR appropriately (feature, bug, breaking change, etc.)

Tips

  • Small PRs get reviewed faster — aim for <300 lines changed
  • If a PR is too big, split it into stacked PRs
  • Screenshots/recordings for UI changes make review much faster
  • Draft PRs are useful for early feedback before the work is complete

Comments

Markdown supported