Agent skill

create-pr

Commit changes and open a pull request with safe metadata

View SKILL.md on GitHub Repository
Stars 10,372
Forks 1,251

Install this agent skill to your Project

npx add-skill https://github.com/elie222/inbox-zero/tree/main/.claude/skills/create-pr

SKILL.md

Open a PR

Important: Steps 2 and 3 require required_permissions: ['all'] because:

  • Pre-commit hooks need access to global npm/node paths outside the workspace
  • gh CLI has TLS certificate issues in sandboxed mode

Critical Rules

NEVER include PII (Personally Identifiable Information) in:

  • Commit messages
  • PR titles or descriptions
  • Branch names
  • File paths or names mentioned in commits/PRs
  • Any text that will be publicly visible

PII includes: names, email addresses, phone numbers, physical addresses, usernames, account IDs, API keys, tokens, passwords, or any other sensitive personal data.

Step 1: Check state (ONE command)

bash
git branch --show-current && git status -s && git diff HEAD --stat
  • Always create a new branch for each PR unless you're already on the correct branch for the current changes.
  • If on main OR if the current branch doesn't match the work you're committing: create a branch using the appropriate prefix:
    • feat/<description> - new features
    • fix/<description> - bug fixes
    • chore/<description> - maintenance, refactoring, etc.
bash
git checkout -b feat/<description>

Note: git checkout -b requires required_permissions: ['git_write']

Step 2: Commit + Push (required_permissions: ['all'])

If uncommitted changes exist:

If staged files exist (respect user's selection):

bash
git commit -m "<msg>" && git push

If unstaged files exist (add specific files, NOT git add .):

bash
git add <file1> <file2> ... && git commit -m "<msg>" && git push

Step 3: Create PR (required_permissions: ['all'])

Format:

<feature_area>: <Title> (80 chars max)

<TLDR> (1-2 sentences)

- bullet 1
- bullet 2

Without skip-review:

bash
gh pr create --title "<title>" --body "<body>"

With skip-review (user says "skip review", "#skipreview", etc.):

bash
gh pr create --title "<title>" --body "<body>" && gh pr comment $(gh pr view --json number -q .number) --body "#skipreview"

Display the returned PR URL as a markdown link on its own line, formatted as: [PR #<number>](<url>) so it's clickable. Display the name of the branch you created.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

elie222/inbox-zero

qa-new-flow

Create a new browser QA flow file from the template

10,372 1,251
Explore
elie222/inbox-zero

llm

Guidelines for implementing LLM (Language Model) functionality in the application

10,372 1,251
Explore
elie222/inbox-zero

fullstack-workflow

Complete fullstack workflow combining GET API routes, server actions, SWR data fetching, and form handling. Use when building features that need both data fetching and mutations from API to UI.

10,372 1,251
Explore
elie222/inbox-zero

write-tests

Write focused unit tests for backend and utility logic

10,372 1,251
Explore
elie222/inbox-zero

e2e

Run and debug E2E flow tests. Use when triggering E2E tests, checking test status, debugging failures with Axiom logs, or setting up local E2E testing.

10,372 1,251
Explore
elie222/inbox-zero

prisma

How to use Prisma

10,372 1,251
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results