Agent skill

Piv Create PR

by coleam00 in coleam00/skills

Push the current feature branch and open a pull request, ready for review.

MITAuto-check passedDevelopment

Install Piv Create PR

skills CLI
$ npx skills add coleam00/skills --skill piv-create-pr -a claude-code

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

GitHub CLI
$ gh skill install coleam00/skills piv-create-pr --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/coleam00/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/piv-create-pr .claude/skills/piv-create-pr && 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
piv-create-pr
GitHub stars
674
Token cost
~968 tokens
SKILL.md length
396 words
Files
1
Skills in repo
34
Repo updated
First seen
Licence
MIT

At a glance

Push the current feature branch and open a pull request, ready for review.

  • Works in 4 steps: Detect the base branch → Validate git state → Gather context for the body → …
  • Tasks that involve Pull requests
  • SKILL.md covers Phase 0 — Detect the base branch, Phase 1 — Validate git state, Phase 2 — Gather context for… and Phase 3 — Push and open the PR, plus 2 more sections
  • Calls git and gh

What it does

Piv Create PR is an agent skill from coleam00/skills. Push the current feature branch and open a pull request, ready for review. Use after a ticket's implementation is committed on its own branch — it detects the base branch, pushes, opens the PR with a clear body (summary · what changed · validation status), and returns the URL to hand to a reviewer.

Its SKILL.md is about 970 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. It works with Git. The repository describes itself as: The agent skills I actually use to build software with coding agents. The PIV loop, planning, worktrees, and the meta-skills for building your own AI Layer. The licence is MIT.

When your agent uses it

  • Tasks that involve Pull requests

Example prompts

  • “/piv-create-pr”

Workflow steps

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

  1. Detect the base branch
  2. Validate git state
  3. Gather context for the body
  4. Push and open the PR

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    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

Piv Create PR loads about 968 tokens when it runs. Until then it costs about 78 tokens; SKILL.md has 396 words of instructions outside code blocks.

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

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 coleam00/skills at commit 847be08, republished under its MIT licence (© coleam00). 396 words, ~968 tokens.

Download SKILL.mdSave it as .claude/skills/piv-create-pr/SKILL.md (or your agent's skills folder).
name
piv-create-pr
description
Push the current feature branch and open a pull request, ready for review. Use after a ticket's implementation is committed on its own branch — it detects the base branch, pushes, opens the PR with a clear body (summary · what changed · validation status), and returns the URL to hand to a reviewer.
argument-hint
[--base <branch>] (default: auto-detected)

Create PR: Open the Pull Request, Hand Off for Review

This is the ship step of the PIV loop: the implementation is committed on a feature branch; now open the PR so it can be reviewed (by the piv-review-pr agentic gate, then a human).

Phase 0 — Detect the base branch

Don't hardcode main. Resolve it:

  1. If $ARGUMENTS contains --base <branch>, use that.
  2. Else: git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's@^refs/remotes/origin/@@'
  3. Fallback: git remote show origin 2>/dev/null | grep 'HEAD branch' | awk '{print $NF}'
  4. Last resort: main. Store as {base}.

Phase 1 — Validate git state

bash
git branch --show-current
git status --short
git log origin/{base}..HEAD --oneline
StateAction
On {base}STOP: "Create a feature branch first (the ticket should be on its own branch)."
Uncommitted changesSTOP: "Commit (or stash) before opening the PR."
No commits ahead of {base}STOP: "Nothing to PR."
Existing PR for this branch (gh pr list --head $(git branch --show-current) --json url)STOP and print the URL.
Clean, commits ahead, no PRPROCEED

Phase 2 — Gather context for the body

  • Project conventions: if .claude/references/conventions.md exists, read its ## pr section — its rules win over the default template below (sections, tone, what must be stated). That file is where a project's specifics live; this skill stays general.
  • Commits: git log origin/{base}..HEAD --pretty=format:"- %s"
  • Files: git diff --stat origin/{base}..HEAD
  • Implementation report (if piv-implement wrote one — .claude/reports/<…>-report.md): pull the summary, validation results, and documented deviations (these belong in the PR body — they tell the reviewer what was intentional).
  • Linked ticket / issue: look for ACC-…, #123, Fixes #… in the commits/branch name.
  • PR template: if .github/PULL_REQUEST_TEMPLATE.md exists, fill it; else use the default below.
Show full SKILL.md (133 more words)Show less

Phase 3 — Push and open the PR

bash
git push -u origin HEAD
bash
gh pr create --base "{base}" --title "{type}: {concise description}" --body "$(cat <<'EOF'
## Summary
{1-2 sentences: what this ticket delivers}

## What changed
{commit summaries}

## Validation
- Tests / type-check / lint: {pass/fail from the implementation report or a fresh run}
- Manual check: {what was exercised, or "pending review"}

## Notes for the reviewer
{documented deviations from the plan — intentional decisions — or "none"}

## Linked
{ticket / issue refs, or "none"}

_Ready for review._
EOF
)"

({type} = feat/fix/refactor/… from the work. Use --draft if the work isn't ready for a real review.)

Output

bash
gh pr view --json number,url,title,baseRefName,headRefName

Report the PR number + URL, the base ← head branches, and "Ready for review → run piv-review-pr <number>, then a human approves." This is the handoff point: the agent's loop ends at an open PR; review and merge are the gates.

Notes

  • Tool-agnostic in spirit: this skill uses GitHub (gh); the same motion is "open a merge request" on GitLab, or "mark ready for review" wherever your team works. Solo with no remote? Skip the PR — commit on {base} and review your own diff before moving on.
  • Sets up parallel work: one branch per ticket → one PR per ticket is exactly what makes worktree parallelism (running independent tickets at once) clean.

© coleam00, 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 .claude/skills/piv-create-pr of coleam00/skills.

Open the folder on GitHubat commit 847be08

Compare with similar skills

Piv Create PR 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.

Piv Create PR compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Piv Create PR this skillcoleam00/skills674—~968Automated safety check: PassMIT
Finishing a Development Branchobra/superpowers297k5 repos~1.9kAutomated safety check: PassMIT
Contributor-First PR MergeHKUDS/OpenHarness16k1 repos~847Automated safety check: PassMIT
Open Code Review CLIalibaba/open-code-review45k—~3.1kAutomated safety check: PassApache-2.0
Create Pull Requestcline/cline70k1 repos~1.6kAutomated safety check: PassApache-2.0
Pull Request Title and Body Writeropeninterpreter/openinterpreter69k2 repos~1.1kAutomated safety check: PassApache-2.0

Similar skills

  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    297k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Merges external GitHub pull requests while keeping the original author credited, and fixes conflicts after the merge instead of rewriting the contribution.

    16k GitHub starsUsed in 1 repo~847 tokens
    DevelopmentAuto-check passed
  • Open Code Review CLI

    alibaba/open-code-review

    Runs the ocr command-line tool to review Git changes, a commit or a branch comparison with an AI model, returning line-level comments and optionally applying fixes.

    45k GitHub stars~3.1k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Opens a GitHub pull request from your current branch with the gh CLI, after reviewing the commits and diff and gathering the details the PR needs.

    70k GitHub starsUsed in 1 repo~1.6k tokens
    DevelopmentAuto-check passed
  • Pull Request Title and Body Writer

    openinterpreter/openinterpreter

    Rewrites the title and body of one or more pull requests with gh, leading with why the change was made, then what changed, and describing only the net result.

    69k GitHub starsUsed in 2 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Understand Diff Analysis

    Egonex-AI/Understand-Anything

    Reads your git changes or a pull request against a prebuilt knowledge graph of the project to explain what changed, which components are affected and what is risky.

    86k GitHub stars~1.4k tokensUpdated today
    DevelopmentAuto-check passed

More from coleam00/skills

All 34 skills in this repo
  • Ablate AI Layer

    coleam00/skills

    Measure whether a repository's AI instructions still earn their place, by running the same real task many times with the layer intact and with it stripped, then grading every rule against what…

    674 GitHub stars~1.9k tokensUpdated 2 days ago
    Auto-check passed
  • Build Dark Factory

    coleam00/skills

    Take a PRD and build a dark factory around it - a repository that takes work in as an issue and ships validated code out with nobody at the keyboard - one component at a time, into the user's actual…

    674 GitHub stars~12k tokensUpdated 2 days ago
    Auto-check passed
  • Drive Screen

    coleam00/skills

    Take real control of the desktop - list and focus windows, type, paste, click, scroll, and screenshot - on Windows, macOS or Linux, and drive other coding-agent sessions running in terminals.

    674 GitHub stars~5.4k tokensUpdated 2 days ago
    Auto-check passed
  • Second Brain Audit

    coleam00/skills

    Audit any second brain, notes folder, or agent memory for facts that have quietly stopped being true, then fix the worst one so it stops recurring.

    674 GitHub stars~4.6k tokensUpdated 2 days ago
    Auto-check passed
  • Build Signal Engine

    coleam00/skills

    Build a personal signal engine from scratch - a system that reads every source someone cares about each day (changelogs and release notes, communities, feeds, videos, papers), makes a quick decision…

    674 GitHub stars~2.9k tokensUpdated 2 days ago
    Auto-check passed
  • Worktree Create

    coleam00/skills

    Create one or more git worktrees for parallel development, each on its own branch with gitignored config copied in, dependencies installed, and a health check, by fanning out a setup subagent per…

    674 GitHub stars~958 tokensUpdated 2 days ago
    Auto-check passed

Works with

Categories

Questions about Piv Create PR

What does Piv Create PR do?

Push the current feature branch and open a pull request, ready for review. Piv Create PR is an agent skill from coleam00/skills. Push the current feature branch and open a pull request, ready for review.

When should I use Piv Create PR?

Piv Create PR fits situations like: tasks that involve Pull requests.

How do I install Piv Create PR in Claude Code?

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

How do I install Piv Create PR in Codex?

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

Can I use Piv Create PR 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 coleam00/skills --skill piv-create-pr -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/piv-create-pr, .gemini/skills/piv-create-pr, .github/skills/piv-create-pr and .opencode/skills/piv-create-pr in your project.

What does Piv Create PR need to run?

Going by SKILL.md and its folder, Piv Create PR needs the command-line tools its instructions call (git and gh).

Does Piv Create PR 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 Piv Create PR 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 Piv Create PR use?

Piv Create PR 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 Piv Create PR use?

About 968 tokens (SKILL.md is roughly 3.9k 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 Piv Create PR?

Skills that share tags, products or a category with Piv Create PR: Finishing a Development Branch (obra/superpowers, 297k stars), Contributor-First PR Merge (HKUDS/OpenHarness, 16k stars), Open Code Review CLI (alibaba/open-code-review, 45k stars) and Create Pull Request (cline/cline, 70k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Piv Create PR?

coleam00 (a GitHub user) maintains it in coleam00/skills, which has 674 GitHub stars. The repository holds 34 skills in this directory. The repository was last updated on October 7, 2026.

Source: coleam00/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.