Agent skill

PR Creation

by TechDufus in TechDufus/oh-my-claude

MUST be used when creating pull requests. An agent skill from TechDufus/oh-my-claude.

MITAuto-check passedDevelopment

Install PR Creation

skills CLI
$ npx skills add TechDufus/oh-my-claude --skill pr-creation -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install TechDufus/oh-my-claude pr-creation --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/TechDufus/oh-my-claude.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/oh-my-claude/skills/pr-creation .claude/skills/pr-creation && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
pr-creation
GitHub stars
174
Token cost
~1.8k tokens
SKILL.md length
585 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
MIT

At a glance

MUST be used when creating pull requests. An agent skill from TechDufus/oh-my-claude.

  • Works in 5 steps: Gather Context → Determine Base Branch → Generate PR Title → …
  • Ready for review
  • SKILL.md covers When This Skill Activates, Complete PR Creation Workflow, Validation Rules and Type Reference, plus 3 more sections
  • Calls git and gh

What it does

PR Creation is an agent skill from TechDufus/oh-my-claude. MUST be used when creating pull requests. Handles context gathering, title generation (conventional commit format), body formatting, and PR creation via GitHub CLI. Creates PRs as drafts by default. Triggers on: 'create PR', 'open PR', 'ready for review', 'push for PR', 'send for review'.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Pull requests and Commit messages. It works with GitHub. The repository describes itself as: Add ultrawork to any prompt for maximum parallel execution. The licence is MIT.

When your agent uses it

  • Ready for review
  • Send for review

Example prompts

  • “create PR”
  • “open PR”
  • “ready for review”
  • “/pr-creation”

Requirements

  • Pre-approved tools (allowed-tools): Bash(git:*), Bash(gh:*), Read, Grep

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Gather Context
  2. Determine Base Branch
  3. Generate PR Title
  4. Generate PR Body
  5. Create PR

What it can do on your machine

Read from SKILL.md and the folder at commit ede75db. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(git:*)
    • Bash(gh:*)
    • Read
    • Grep

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • gh

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git and gh, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

PR Creation loads about 1.8k tokens when it runs. Until then it costs about 75 tokens; SKILL.md has 585 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~75
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from TechDufus/oh-my-claude at commit ede75db, republished under its MIT licence (© TechDufus). 585 words, ~1,789 tokens.

Download SKILL.mdSave it as .claude/skills/pr-creation/SKILL.md (or your agent's skills folder).
name
pr-creation
description
MUST be used when creating pull requests. Handles context gathering, title generation (conventional commit format), body formatting, and PR creation via GitHub CLI. Creates PRs as drafts by default. Triggers on: 'create PR', 'open PR', 'ready for review', 'push for PR', 'send for review'.
allowed-tools
Bash(git:*), Bash(gh:*), Read, Grep

PR Creation

This skill MUST be invoked whenever you are creating a pull request. It handles the complete workflow from context gathering to PR submission with consistent formatting.

When This Skill Activates

Auto-invoke this skill when the user implies a PR should be created:

CategoryTrigger Phrases
Explicit PR"create PR", "open PR", "make PR", "create a pull request"
Review intent"ready for review", "review ready", "send for review"
Push for PR"push for PR", "push and PR", "push and create PR"
Submission"submit for review", "open pull request", "make a pull request"

Key insight: If the user's intent results in gh pr create being run, this skill MUST be used first.

Do NOT run gh pr create without this skill.

Complete PR Creation Workflow

Step 1: Gather Context
bash
git status                              # Check working tree state
git diff HEAD                           # See uncommitted changes (if any)
git log main..HEAD --oneline            # Commits to be included in PR
git diff main...HEAD                    # Full diff against base branch
git branch --show-current               # Current branch name

Important: Ensure all changes are committed before creating PR. If uncommitted changes exist, use the git-commit-validator skill first.

Step 2: Determine Base Branch

Check for common base branch names:

bash
git rev-parse --verify main 2>/dev/null && echo "main" || git rev-parse --verify master 2>/dev/null && echo "master"

Or check remote default:

bash
gh repo view --json defaultBranchRef --jq '.defaultBranchRef.name'
Step 3: Generate PR Title

Format: type(scope): description (conventional commits)

Rules:

  • Max 50 characters
  • Lowercase type from: feat, fix, docs, refactor, test, chore, perf, ci, build, style, revert
  • Optional scope in parentheses
  • Imperative mood ("add" not "added")
  • No period at end

Title should summarize the entire PR, not just the last commit.

Analyze all commits in the PR:

bash
git log main..HEAD --oneline

Synthesize into a single title that captures the overall change.

Step 4: Generate PR Body

Use this exact format:

markdown
## Summary
[1-3 sentences explaining what this PR does and why]

## Changes
- [Bullet list of key changes]
- [Focus on what matters, not every file touched]

## Test Plan
[How changes were validated - tests run, manual verification, etc.]

Closes #123

Body Guidelines:

  • Summary: Brief context for reviewers, focus on WHY
  • Changes: Key modifications, not exhaustive file list
  • Test Plan: How you verified the changes work
  • Issue reference: Include if applicable (Closes, Fixes, Resolves)
Step 5: Create PR

Default: Create as draft (per project standards)

Use HEREDOC for proper body formatting:

bash
gh pr create --draft --title "type(scope): description" --body "$(cat <<'EOF'
## Summary
Brief explanation of what and why.

## Changes
- Key change 1
- Key change 2

## Test Plan
How this was tested.

Closes #123
EOF
)"

For ready-for-review PRs (when user explicitly requests):

bash
gh pr create --title "..." --body "..."

Validation Rules

Title Validation
  1. Max 50 characters - Truncate or rephrase if over
  2. Format check - Must match: ^[a-z]+(\([a-z0-9\-]+\))?!?: .+$
  3. Valid type - One of: feat, fix, docs, refactor, test, chore, perf, ci, build, style, revert
  4. Imperative mood - "add feature" not "added feature"
  5. No period at end
Show full SKILL.md (241 more words)Show less
Body Validation
  1. Has Summary section - Required
  2. Has Changes section - Required (at least one bullet)
  3. Has Test Plan section - Required
  4. Concise - 2-3 paragraphs max in summary
  5. No AI attribution - No "Generated by", "Created with AI", etc.
Pre-flight Checks

Before creating PR:

  1. Branch has commits ahead of base
  2. No uncommitted changes (or commit them first)
  3. Branch is pushed to remote
  4. No existing PR for this branch (unless intentional)
bash
# Check if PR already exists
gh pr list --head "$(git branch --show-current)" --state open

Type Reference

TypeUse For
featNew feature or capability
fixBug fix
docsDocumentation only
refactorCode restructuring (no behavior change)
perfPerformance improvement
testTest additions/fixes
choreMaintenance, deps, config
ciCI/CD changes
buildBuild system changes
styleFormatting (no logic change)
revertReverting previous changes

Examples

Simple Feature PR

Title:

feat(auth): add OAuth2 login support

Body:

markdown
## Summary
Adds Google OAuth2 as an authentication option alongside existing email/password login.

## Changes
- Add OAuth2 provider configuration
- Create OAuth callback handler
- Add "Login with Google" button to login page

## Test Plan
- Tested OAuth flow locally with test credentials
- Verified token refresh works correctly
- Existing email login still works

Closes #45
Bug Fix PR

Title:

fix(api): resolve timeout on large file uploads

Body:

markdown
## Summary
Large file uploads were timing out due to default 30s limit. Increased timeout and added progress tracking.

## Changes
- Increase upload timeout to 5 minutes
- Add upload progress callback
- Better error messages for timeout scenarios

## Test Plan
- Uploaded 500MB file successfully
- Verified timeout error message when server unreachable

Fixes #128
Refactoring PR

Title:

refactor: consolidate auth middleware

Body:

markdown
## Summary
Auth checks were scattered across three middleware files. Consolidated into single auth module for consistency.

## Changes
- Merge auth middleware into single module
- Update route imports
- Remove deprecated auth helpers

## Test Plan
- All existing auth tests pass
- Manual verification of protected routes

Why Draft by Default?

Draft PRs signal the work is ready for early feedback but may not be complete. Benefits:

  • Allows CI to run before requesting reviews
  • Enables async collaboration on in-progress work
  • Prevents accidental merges of incomplete work
  • Clear signal when ready: mark ready for review

To create a non-draft PR, user must explicitly request it.

Error Handling

ErrorResolution
No commits ahead of baseEnsure work is committed
Branch not pushedPush with git push -u origin HEAD
PR already existsShow existing PR URL, ask if update intended
Auth failureRun gh auth login
Title too longShorten or rephrase

© TechDufus, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/oh-my-claude/skills/pr-creation of TechDufus/oh-my-claude.

Open the folder on GitHubat commit ede75db

Compare with similar skills

PR Creation next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

PR Creation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
PR Creation this skillTechDufus/oh-my-claude174—~1.8kAutomated safety check: PassMIT
PR Finalize Reviewmicrosoft/garnet12k—~3.1kAutomated safety check: PassMIT
React Router Pull Request Creatorremix-run/react-router57k—~2.5kAutomated safety check: PassMIT
Verdaccio Pull Request Workflowverdaccio/verdaccio18k—~1.9kAutomated safety check: PassMIT
Gh PR Metadatamodule-federation/core2.7k—~1kAutomated safety check: PassMIT
Draft Pull Request Creatorwordpress-mobile/WordPress-Android3.2k—~881Automated safety check: NotesGPL-2.0

Similar skills

  • PR Finalize Review

    microsoft/garnet

    Official

    Checks that a pull request's title and description match its implementation and reviews the code for Garnet best practices, reporting findings without posting them.

    12k GitHub stars~3.1k tokensUpdated today
    DevelopmentAuto-check passed
  • React Router Pull Request Creator

    remix-run/react-router

    Packages finished React Router work into a draft pull request: branch, commit, push, a written PR body and the right GitHub labels.

    57k GitHub stars~2.5k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Takes a change through a verdaccio pull request: branch, local checks, changeset, title and body, labels, CI and review rounds, and ports to other release lines.

    18k GitHub stars~1.9k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Gh PR Metadata

    module-federation/core

    Update the current GitHub PR title and body for this repository so they match the repo's pull request template and conventional-commit title style.

    2.7k GitHub stars~1k tokensUpdated today
    DevelopmentAuto-check passed
  • Draft Pull Request Creator

    wordpress-mobile/WordPress-Android

    Commits and pushes current changes, writes a pull request title and body from the branch history and template, and opens a draft PR on GitHub after you approve it.

    3.2k GitHub stars~881 tokensUpdated today
    DevelopmentAuto-check: notes
  • Submit PR

    tisfeng/Easydict

    创建或复用当前 checkout 已提交变更的 GitHub PR,必要时推送任务分支。PR 审查使用 review-pr;仅本地提交使用 git-commit。

    15k GitHub stars~595 tokensUpdated yesterday
    DevelopmentAuto-check passed

More from TechDufus/oh-my-claude

All 12 skills in this repo
  • Debugger

    TechDufus/oh-my-claude

    Systematic debugging methodology for diagnosing failures and root cause analysis.

    174 GitHub stars~1k tokensUpdated 2 mo ago
    Auto-check passed
  • Oh My Claude Runtime

    TechDufus/oh-my-claude

    A skill your agent uses when applying oh-my-claude workflow guidance, ultrawork modes, agent orchestration, plan execution, or plugin configuration.

    174 GitHub stars~4.3k tokensUpdated 2 mo ago
    Auto-check passed
  • Ralph Loop Init

    TechDufus/oh-my-claude

    Transform approved plans into ralph loop infrastructure. An agent skill from TechDufus/oh-my-claude.

    174 GitHub stars~4.6k tokensUpdated 2 mo ago
    Auto-check: notes
  • Ralph Plan

    TechDufus/oh-my-claude

    Structured PRD generation with interview, research, and approval workflow.

    174 GitHub stars~2.4k tokensUpdated 2 mo ago
    Auto-check: notes
  • Writing Skills

    TechDufus/oh-my-claude

    Methodology for creating effective skills using TDD principles.

    174 GitHub stars~1.3k tokensUpdated 2 mo ago
    Auto-check passed
  • Init Deep

    TechDufus/oh-my-claude

    Initialize or migrate to nested CLAUDE.md structure for progressive disclosure.

    174 GitHub stars~5.3k tokensUpdated 2 mo ago
    Auto-check: notes

Works with

Categories

Questions about PR Creation

What does PR Creation do?

MUST be used when creating pull requests. An agent skill from TechDufus/oh-my-claude. PR Creation is an agent skill from TechDufus/oh-my-claude. MUST be used when creating pull requests.

When should I use PR Creation?

PR Creation fits situations like: ready for review; send for review.

How do I install PR Creation in Claude Code?

Run `npx skills add TechDufus/oh-my-claude --skill pr-creation -a claude-code`. Or copy the skill folder (plugins/oh-my-claude/skills/pr-creation in TechDufus/oh-my-claude) into .claude/skills/pr-creation in your project. Claude Code loads it when a task matches its description.

How do I install PR Creation in Codex?

Run `npx skills add TechDufus/oh-my-claude --skill pr-creation -a codex`. Or copy the skill folder (plugins/oh-my-claude/skills/pr-creation in TechDufus/oh-my-claude) into .agents/skills/pr-creation in your project. Codex loads it when a task matches its description.

Can I use PR Creation in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add TechDufus/oh-my-claude --skill pr-creation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pr-creation, .gemini/skills/pr-creation, .github/skills/pr-creation and .opencode/skills/pr-creation in your project.

What does PR Creation need to run?

Going by SKILL.md and its folder, PR Creation needs the command-line tools its instructions call (git and gh). Its frontmatter pre-approves these tools: Bash(git:*), Bash(gh:*), Read, Grep.

Does PR Creation access the network?

SKILL.md contains no URLs. Its commands use git and gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is PR Creation safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does PR Creation use?

PR Creation is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does PR Creation use?

About 1.8k tokens (SKILL.md is roughly 7.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to PR Creation?

Skills that share tags, products or a category with PR Creation: PR Finalize Review (microsoft/garnet, 12k stars), React Router Pull Request Creator (remix-run/react-router, 57k stars), Verdaccio Pull Request Workflow (verdaccio/verdaccio, 18k stars) and Gh PR Metadata (module-federation/core, 2.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains PR Creation?

TechDufus (a GitHub user) maintains it in TechDufus/oh-my-claude, which has 174 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on July 13, 2026.

Source: TechDufus/oh-my-claude on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.