Skip to content
Skills Library
Programming · Automation

create-pr

/create-pr

Create or update pull requests with conventional commits. Use when user says "create a PR for these changes", "submit this for review", "open a pull request", "push these changes and create a PR", "I'm ready to submit this work", or "create PR and link to issue #123".

Repository
ai-toolkit ↗
Licence
MIT
Last repository change
23.10.2026

Assessment and security

84/ 100Class: good
Format9 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 23.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Create or update pull requests with conventional commits. Use when user says "create a PR for these changes", "submit this for review", "open a pull request", "push these changes and create a PR", "I'm ready to submit this work", or "create PR and link to issue #123".

Triggers from the description

create a PR for these changessubmit this for reviewopen a pull requestpush these changes and create a PRm ready to submit this workcreate PR and link to issue #123
Original author description

Create or update pull requests with conventional commits. Use when user says "create a PR for these changes", "submit this for review", "open a pull request", "push these changes and create a PR", "I'm ready to submit this work", or "create PR and link to issue #123".

How it works

  1. What It Does
  2. Error Handling
  3. Conventional Commit Types
  4. PR Description Includes
  5. Commit Policy
  6. Options
  7. Examples
  8. Output
Original SKILL.md headings · 68 lines, 417 words
SKILL.md preview
---
description: Create or update pull requests with conventional commits. Use when user says "create a PR for these changes", "submit this for review", "open a pull request", "push these changes and create a PR", "I'm ready to submit this work", or "create PR and link to issue #123".
allowed-tools: Bash(git:*), Bash(gt:*), Bash(gh:*), Read, Glob, Grep, Task(subagent_type:pr-creator-agent), Task(subagent_type:commit-message-generator-agent)
model: opus
---

# PR Creator

Create or update pull requests with auto-generated conventional commits and descriptions. Supports both standard Git + GitHub CLI (default) and Graphite workflows.

## What It Does

1. **Analyze Diff**: Run `git diff origin/<target>...HEAD` to inspect all changed files
2. **Detect Change Type**: Classify as feat, fix, refactor, etc. based on the diff
3. **Generate Commit**: Use `commit-message-generator-agent` to draft a conventional commit message, then ask user to confirm before staging/committing
4. **Create PR Title**: `<type>(<scope>): <description>`
5. **Write Description**: Comprehensive PR body (summary, modified files, testing notes, linked issues)
6. **Submit**: Use `gt submit` (Graphite) or `gh pr create` (default)

## Error Handling

- **No changes / no commits ahead of target**: Stop and inform the user — there is nothing to submit
- **PR already exists for this branch**: Switch to update mode; run `git push` to publish the latest commits (use `gt submit` for Graphite). If the PR title or body also need updating, **read the live body first** (`gh pr view <n> --json body -q .body`) and edit *from* it — never regenerate the body from scratch. The author may have hand-edited the description or pasted images/screenshots (`![](https://github.com/user-attachments/...)`) that exist only in the live body, not in any file; overwriting silently destroys them. Splice your change into the current body and apply with `gh pr edit <n> --body-file <tmp>`.
- **User rejects commit message**: Re-generate with user-provided guidance, then confirm again before proceeding

## Conventional Commit Types

| Type       | Use              |
| ---------- | ---------------- |
| `feat`     | New feature      |
| `fix`      | Bug fix          |
| `docs`     | Documentation    |
| `style`    | Formatting       |
| `refactor` | Code restructure |
| `perf`     | Performance      |
| `test`     | Tests            |
| `build`    | Build system     |
| `ci`       | CI config        |
| `chore`    | Maintenance      |

## PR Description Includes

- Summary of changes
- List of modified files with rationale
- Testing information
- Related issues

## Commit Policy

**Always asks user before committing.** Never auto-commits.

## Options

- Custom target branch (default: main)
- Breaking change detection
- Issue linking
- PR creation method: standard git + GitHub CLI (default) or Graphite (`--use-graphite`)
- Stack-aware creation (only with Graphite)
- Update existing vs create new

## Examples

```
"Create a PR for these changes"
"Submit this for review"
"Create PR and link to issue #123"
"Mark as breaking change due to API updates"
```

## Output

Provides PR URL after creation for review.

Versions

RepositoryScoreLicence
This page · Uniswap/ai-toolkit84MIT
wanteddev/montage-web100MIT
niekcandaele/claude-helpers100MIT
yonatangross/orchestkit100MIT
microsoft/aspire100MIT
rolemodel/skills100MIT
moeru-ai/airi100MIT
sakuro/dotfiles100MIT
fcakyon/claude-codex-settings100Apache-2.0

Database snapshot: 13.11.2026 · package version 88ee8636b745 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100create-github-pr
    Create GitHub pull requests using the gh CLI. Use when the user wants to create a new PR, submit code for review, or open a pull request. Trigger keywords - create PR, pull request, new PR, submit for review, code review.
  • 100github-pr-creation
    Creates GitHub Pull Requests with automated validation and task tracking. Use when user wants to create PR, open pull request, submit for review, or check if ready for PR. Analyzes commits, validates task completion, generates Conventional Commits title and description, suggests…
  • 100pr
    Create a pull request with conventional format. Use when asked to create a PR, open a pull request, or push changes for review.
  • 100commit-push-pr
    Analyze changes, create categorized conventional commits, push, and open a PR. Use when user asks to open a PR, invokes `/commit-push-pr`, or requests a full commit -> push -> PR flow with CI monitoring.
  • 100git-workflow
    Conventional commits, PR creation, and quality gate verification. Use when: commit, PR, branch, push, conventional commit, create pull request, git.
  • 90submit-pr-from-current-changes
    Create a branch, commit existing local changes, push them, and open a pull request. Use when submitting current work as a PR.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.