create-pr

name	create-pr
description	Create a pull request from the current branch with structured summary
user-invocable	true
workflow	{"version":1,"steps":[{"id":"verify-branch","role":"system","intent":"Verify not on main/develop, check for uncommitted changes, get commits ahead of main.","produces":["branch-name","branch-state","commit-list"]},{"id":"gather-context","role":"system","intent":"Collect diff stats, run tests and lint for PR description context.","requires":["branch-state"],"produces":["diff-summary","test-result","lint-result"]},{"id":"generate-description","role":"system","intent":"Build structured PR description from commits, diff stats, and test results.","requires":["commit-list","diff-summary","test-result","lint-result"],"produces":["pr-description","pr-title"],"gate":true},{"id":"create-pr","role":"system","intent":"Push branch to origin and create PR via gh CLI.","requires":["pr-description","pr-title","branch-name"],"produces":["pr-url"]},{"id":"post-creation","role":"system","intent":"Display PR URL and suggest next steps.","requires":["pr-url"],"produces":["summary"],"gate":true}]}

Create PR

Creates a pull request from the current feature branch with a structured summary, test results, and change description. Closes the pipeline loop: init -> build-feature -> create-pr.

When to use

• After completing a feature with /build-feature
• When you have changes on a feature branch ready for review
• To create a well-structured PR without manual formatting

Usage

/create-pr

Process

Step 1 -- Verify branch state

1. Confirm you are NOT on main or develop -- refuse to create PR from default branches
2. Run git status to check for uncommitted changes -- if any, warn the user and ask whether to commit first
3. Run git log main..HEAD --oneline to get the list of commits that will be in the PR
4. If there are no commits ahead of main, report that there is nothing to PR

Step 2 -- Gather context

Collect the information needed for the PR description:

1. Commits: git log main..HEAD --oneline -- list of all commits on this branch
2. Diff summary: git diff main..HEAD --stat -- files changed with line counts
3. Test results: Run project tests (e.g., npm test) and capture pass/fail
4. Lint results: Run project lint (e.g., npm run lint) and capture pass/fail
5. Branch name: Extract feature name from the branch (e.g., feature/dark-mode -> dark-mode)

If tests or lint fail, warn the user but allow them to proceed (some PRs are draft/WIP).

Step 3 -- Generate PR description

Build a structured PR description:

## Summary
[2-4 bullet points describing what this PR does, derived from commit messages]

## Changes
[File-level summary from git diff --stat]

## Test plan
- [x] Tests: [pass/fail] ([count] tests)
- [x] Lint: [pass/fail]
- [ ] [Any manual verification steps if applicable]

Step 4 -- Create the PR

1. Push the branch to origin: git push -u origin [branch-name]
2. Create the PR using gh pr create:
   • Title: derived from branch name or first commit message (max 70 chars)
   • Body: the generated description from Step 3
   • Base: main (or the project's default branch)
3. Report the PR URL to the user

Step 5 -- Post-creation

1. Display the PR URL
2. Suggest next steps:
   • "Request review from a teammate"
   • "Run /code-review for an AI code review"
   • "Merge when ready with gh pr merge [number]"

Example Session

User: /create-pr

Checking branch state...
Branch: feature/dark-mode (4 commits ahead of main)
Tests: 82 passed, 0 failed
Lint: 0 errors

Creating PR...
PR #42: "feat: add dark mode toggle to settings"
https://github.com/org/repo/pull/42

Next steps:
- Request review from a teammate
- Run /code-review for AI code review
- Merge when ready

Notes

• The PR title should be concise (under 70 characters) and follow conventional commits format when the project uses it
• If the branch has wip: commits from build-feature checkpoints, consider squashing them before creating the PR
• This skill does NOT merge the PR -- that is a manual step or a separate command