Back to Skills

creating-pr

verified

Create GitHub pull requests with standardized title format and draft status. Use when the user requests to create a PR. This skill uses gh command to create PRs with specific title format '[base-branch] type: description' and generates concise bullet-point descriptions from git changes.

View on GitHub

Marketplace

my-marketplace

kkhys/claude-code-marketplace

Plugin

base

Repository

kkhys/claude-code-marketplace
1stars

plugins/base/skills/creating-pr/SKILL.md

Last Verified

January 21, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/kkhys/claude-code-marketplace/blob/main/plugins/base/skills/creating-pr/SKILL.md -a claude-code --skill creating-pr

Installation paths:

Claude
.claude/skills/creating-pr/
Powered by add-skill CLI

Instructions

# Creating PR

## Overview

Create GitHub pull requests following a standardized format with proper Conventional Commits types and draft status.

## PR Creation Workflow

### 1. Analyze Current State

Check the current branch and merge target:

```bash
# Get current branch
git branch --show-current

# Check remote tracking and base branch
git status
```

### 2. Gather Change Information

Collect information about the changes:

```bash
# Get commit history from base branch
git log origin/main..HEAD --oneline

# Get detailed diff from base branch
git diff origin/main...HEAD --stat
git diff origin/main...HEAD
```

Replace `origin/main` with the actual base branch (e.g., `origin/master`, `origin/develop`).

### 3. Analyze Changes and Determine Type

Analyze the changes and determine the appropriate Conventional Commits type:

- Read [commit-types.md](references/commit-types.md) for detailed type selection guidelines
- Consider the primary purpose of the changes
- Follow the priority order: feat > fix > perf > refactor > test > docs > chore

### 4. Create PR Title

Format: `[base-branch] type: description`

**Components:**
- `[base-branch]`: The target branch name (e.g., `main`, `master`, `develop`)
- `type`: Conventional Commits type (feat, fix, chore, docs, refactor, test, perf, style, ci, build)
- `description`: Concise summary of changes in lowercase

**Examples:**
- `[main] feat: add user authentication system`
- `[main] fix: resolve null pointer in login handler`
- `[develop] refactor: extract validation logic`

### 5. Create PR Description

Generate a concise bullet-point list of main changes:

**Format:**
```markdown
- Main change 1
- Main change 2
- Main change 3
```

**Guidelines:**
- Focus on user-facing or significant technical changes
- Keep each point concise (one line)
- Limit to 3-5 main points
- Use imperative mood (e.g., "Add", "Fix", "Update")

**Example:**
```markdown
- Add JWT authentication middleware
- Implement user login and logout endpoints
- Ad

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
4903 chars