Creates pull requests by automatically selecting the correct template, title format, and labels based on branch type and project configuration.

Install

mkdir -p .claude/skills/pr-create && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/15070" && unzip -o skill.zip -d .claude/skills/pr-create && rm skill.zip

Installs to .claude/skills/pr-create

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Create a pull request with title, body, labels, and template
60 charsno explicit “when” trigger
Beginner

Key capabilities

  • Determine PR title from branch type
  • Select appropriate PR template based on work type
  • Determine and assign labels (type, topic, area)
  • Determine target branch based on scenario
  • Write a summary for the PR body
  • Document validation and add links in the PR body

How it works

The skill orchestrates the PR creation process by determining configuration details like title, template, labels, and target branch, then composes the PR body with summary, scope, validation, and links.

Inputs & outputs

You give it
Branch changes and project configuration
You get back
A composed PR body preview and a created pull request

When to use pr-create

  • Open a pull request for a new feature branch
  • Generate a hotfix PR with a specific emergency template
  • Standardize PR titles and labels across a team repository
  • Attach issue references and validation summaries to PR descriptions

About this skill

PR Create

Uses Orchestrator. Create a pull request with appropriate title, template, labels, and description.

Prerequisites: Branch exists with commits, changes pushed to remote, verification passed (build, tests)


Phase 1: Determine Configuration

PR Setup

  1. Determine PR title from branch type: <type>(<scope>): <description>
  2. Select template based on work type:
Work TypeTemplate
Featurespr.md
Bug fixespr.md
Documentationpr.md
Maintenancepr.md
Hotfixespr-hotfix.md
Releasespr-release.md
  1. Determine labels (type, topic, area)
  2. Determine target branch:
ScenarioTarget
Standalone workmain
Part of epic/phaseEpic/phase branch
Hotfixmain
  1. Note merge method for reviewer context (default: merge commit; read project.merge-method from workspace.config.yaml)

Phase 2: Compose PR Body

Write Description

  1. Write summary (what and why)
  2. List scope (files changed, areas affected)
  3. Document validation (build passes, tests pass)
  4. Add links (closes issue, related ADRs)
  5. Fill in the selected template

Output

## Context Anchors

- **Issue:** #<number> - <title>
- **Branch:** `<branch>` → `<target>`
- **Phase:** 2 — Compose PR Body

## PR Configuration

| Property     | Value                            |
| ------------ | -------------------------------- |
| Title        | `<type>(<scope>): <description>` |
| Template     | `<template>.md`                  |
| Target       | `<target-branch>`                |
| Merge method | <method from config>             |
| Labels       | `type:...`, `topic:...`          |

## PR Body Preview

<full body content>

## Next Step

Awaiting approval to create PR.

**Approval Required:** Yes

⛔ CHECKPOINT

STOP. Do not create PR until human explicitly approves:

  • PR title and labels
  • Target branch
  • PR body content

Phase 3: Create and Report

Execute PR Creation

  1. Write PR body to .tmp/scratch/pr-body.md
  2. Execute the forge's PR creation operation with:
    • Base: target branch (from Phase 1)
    • Head: feature branch
    • Title: <type>(<scope>): <description>
    • Body: from .tmp/scratch/pr-body.md
    • Labels: from Phase 1
  3. Update board status to In Review for the linked issue
  4. Report PR number and URL

Board Integration

Read workspace.config.yaml for board field IDs. Set issue status to In Review (board.status_options.in-review.option_id).

Output

## Context Anchors

- **PR:** #<pr-number> - <title>
- **Issue:** #<issue-number>
- **Status:** Open, awaiting review

## Next Step

PR created. Awaiting review.

**Approval Required:** No

Error Handling

ErrorRecovery
Branch not pushedPush first, then retry
Build/tests not passingFix issues before PR
Missing issue linkConfirm issue number
Forge not authenticatedCheck authentication status

When not to use it

  • When the branch does not exist with commits
  • When changes have not been pushed to remote
  • When verification (build, tests) has not passed

Limitations

  • Requires branch to exist with commits.
  • Requires changes to be pushed to remote.
  • Requires verification (build, tests) to have passed.

How it compares

This skill automates the structured creation of a pull request by analyzing branch type, selecting templates, and generating a detailed body, providing a standardized and efficient process compared to manual PR creation.

Compared to similar skills

pr-create side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
pr-create (this skill)05moNo flagsBeginner
resolve-conflicts818moReviewIntermediate
git-advanced-workflows112moReviewAdvanced
nx-workspace46moReviewBeginner

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry