create-pr

name	create-pr
description	Runs the full PR workflow — creates a feature branch, commits, pushes, and opens the pull request. Use when the user asks to create or open a PR ("create a PR", "push this up and open a PR").

Create PR

Use this skill when the user asks to create or open a pull request.

PR Granularity

A PR is a reviewable responsibility unit; one PR may contain multiple atomic commits. A branch is not a PR boundary: split independent work into separate PRs and stack only dependent work.

Workflow

1. Inspect the current branch, status, and diff:

   git status --short
   git branch --show-current
   git diff --stat
   

2. If the current branch is main, create a feature branch with a feature/, fix/, or chore/ prefix unless the user requested a different branch name.

3. Review the diff before committing. Exclude unrelated changes, temporary files, secrets, generated junk, and debug-only edits.

4. Commit with the repo-local commit skill using an English Conventional Commit message. When CI is unnecessary and repository instructions permit skipping it, append [ci skip] to the commit message.

5. Prepare a PR title and body proportional to the change:

   • Use a Conventional Commit type such as feat, fix, docs, refactor, or chore in the PR title.
   • For a small focused change, use 2–4 sentences covering what changed and why.
   • For a larger change, include Summary, What Changed, Why, and Testing only when tests were actually run. Add Related Issues only when relevant.
   • Use --body-file - for multi-line bodies. Do not embed \n escape sequences in --body.

6. Publish using the path that matches the PR structure:

   • Use gh-stack only when requested or when the branch is already stacked; verify parent-child ancestry before linking.

   • For an ordinary PR, push the branch and create the PR with:

     git push -u origin <branch-name>
     gh pr create --title "feat(scope): summary" --body-file -
     

7. Report the PR URL. If publishing fails, inspect the error and verify the branch, remote, authentication, or duplicate PR state before retrying.

All commit messages, PR titles, and PR bodies must be in English. Confirm the target branch before creating the PR, and do not call it ready until the relevant checks and review feedback have been inspected.