Create PR

Create a well-structured, product-focused pull request.

Preferences

Read ~/.claude/skills/create-pr/preferences.md using the Read tool. If not found, no preferences are set.

Context

• •Branch: !git branch --show-current 2>/dev/null || echo "not a git repo"
• •Upstream: !git rev-parse --abbrev-ref @{upstream} 2>/dev/null || echo "no upstream"
• •Ahead: !git rev-list --count @{upstream}..HEAD 2>/dev/null || echo "unknown"
• •Repo: !gh repo view --json nameWithOwner -q .nameWithOwner 2>/dev/null || echo "unknown"

Command routing

Check $ARGUMENTS:

• •help → display help then stop
• •config → interactive setup then stop
• •reset → delete ~/.claude/skills/create-pr/preferences.md, confirm, stop
• •anything else (including empty) → create PR

Flags

Parse from $ARGUMENTS:

• •--base <branch> — override base branch
• •--draft — create as draft PR
• •--no-linear — skip Linear integration
• •Remaining text — treated as Linear issue ID if it matches pattern (e.g., AIS-810)

Help

PR — Create a well-structured pull request

Usage:
  /create-pr                         Create PR from current branch
  /create-pr <issue-id>              Create PR and link Linear issue
  /create-pr --base develop          Override base branch
  /create-pr --draft                 Create as draft
  /create-pr --no-linear             Skip Linear linking
  /create-pr config                  Set PR preferences
  /create-pr reset                   Clear preferences
  /create-pr help                    This help

Examples:
  /pr
  /create-pr AIS-810
  /create-pr --base develop --draft
  /create-pr AIS-810 --base main

What it does:
  1. Detects base branch (or uses preference/flag)
  2. Reads commits, diff, and Linear issue
  3. Builds product-focused PR description
  4. Pushes branch if needed
  5. Creates PR and links to Linear

Current preferences:
  (shown above under Preferences)

Config

Use AskUserQuestion:

Q1 — "Default base branch?" (auto-detect (default), main, develop, custom)

• •Auto-detect: checks tracking branch, falls back to repo default branch

Q2 — "Link Linear issues?" (Yes — from branch name (default), No)

Q3 — "PR template?" (standard (default), minimal, detailed)

Q4 — "Auto-push before creating?" (Yes (default), No — just create locally)

Q5 — "Default PR type?" (Ready for review (default), Draft)

Save to ~/.claude/skills/create-pr/preferences.md.

First-time detection

If no preferences file exists, show: "First time using /pr? Run /create-prconfig to set defaults (base branch, template, Linear linking), or continue — I'll auto-detect."

Then proceed.

Steps

1. Gather context

From git:

• •Current branch (pre-injected)
• •Commits on this branch: git log <base>..HEAD --oneline
• •Diff stat: git diff <base>...HEAD --stat
• •Full diff summary: git diff <base>...HEAD (for understanding changes)

Base branch detection (in order):

1. •--base flag if provided
2. •Saved preference if set
3. •Tracking branch upstream
4. •Repo default branch: gh repo view --json defaultBranchRef -q .defaultBranchRef.name

Linear issue (unless --no-linear):

• •Extract issue ID from branch name (pattern: user/ais-NNN-* or ais-NNN-*)
• •If found, fetch via get_issue for title, description, project

Remote check:

• •Is branch pushed? If not, needs pushing.

2. Branch alignment

If a Linear issue was found, check if branch name matches issue.gitBranchName. If mismatch, rename the branch to match (team convention):

git branch -m {old} {new}
git push origin --delete {old}  # if old was pushed
git push -u origin {new}

3. Push if needed

If branch isn't pushed (or was renamed):

git push -u origin {branch}

Skip if --no-push or preference says no.

4. Build PR content

Title format: Under 70 chars, conventional prefix.

• •feat: Description for new features
• •fix: Description for bug fixes
• •refactor: Description for refactoring
• •chore: Description for maintenance

Body template (standard):

## Summary

{1-2 sentences: what this does and why. Product value first.}

**Linear:** [{issue-id}]({url}) (if available)

## What's New

- **{Feature/Change}** — {one sentence, user perspective}
- **{Feature/Change}** — {one sentence}

## How to Test

1. {Step}
2. {Step}
3. {Step}

Body template (minimal):

{1-2 sentences: what and why}

Linear: [{issue-id}]({url})

Body template (detailed):

## Summary

{1-2 sentences}

**Linear:** [{issue-id}]({url})

## What's New

- **{Feature}** — {description}

## Architecture

- {How it's structured}
- {What was reused}
- {Data flow}

## How to Test

1. {Step}
2. {Step}

5. Create the PR

gh pr create --base {base} --title "{title}" --body "$(cat <<'EOF'
{body}
EOF
)"

Add --draft if flag set or preference is draft.

6. Link to Linear

If Linear issue found, attach PR via update_issue with link:

url:   https://github.com/{org}/{repo}/pull/{number}
title: PR #{number} — {title}

7. Report

PR created: {url}

  Base:   {base}
  Head:   {branch}
  Title:  {title}
  Linear: {issue-id} (linked ✓) or "none"
  Type:   Ready / Draft

  Commits: {count}
  Files:   {count}

8. Learn

• •If user changes base branch, save preference
• •If user edits the generated title pattern, save style preference
• •If user consistently uses draft, save as default