pr

Create Pull Request

Push branch and create a PR with a concise, issue-linked description.

IMPORTANT: This skill MUST be used for ALL pull request creation — even when the user says "create pr" without /pr. Never create a PR without following these steps.

Current Branch Context

• Branch: !git branch --show-current
• Commits: !git log main..HEAD --oneline 2>/dev/null
• Changed files: !git diff main..HEAD --stat 2>/dev/null

Arguments

• $ARGUMENTS - Issue reference (optional, e.g., #42 or 42). If provided, the PR will be linked to this issue.

Instructions

1. Review the branch context above — the commits and changed files are already loaded.

2. MANDATORY: Update CHANGELOG.md — Read CHANGELOG.md and check the ## Unreleased section. If the changes from this branch are NOT already listed there, you MUST update it before proceeding. Do NOT skip this step. Do NOT proceed to push without verifying.

• Add entries under the appropriate subsection (### Added, ### Changed, ### Fixed, etc.)
• Reference issue numbers where applicable (e.g., (Issue #123))
• Commit the update:

  git add CHANGELOG.md && git commit -m "docs: update changelog"
  

1. Push branch:

git push -u origin HEAD

• The pre-commit hook runs tests, shellcheck, and linting automatically on commit. Ensure all checks passed before pushing.
• If push fails, read the output, fix the issue, commit the fix, and retry. Do NOT use --no-verify to bypass.

1. Generate PR title:

• If $ARGUMENTS contains an issue number, fetch the issue title:

  gh issue view <number> --json title -q '.title'
  

• PR title format: <type>(<scope>): <short description> (conventional commit style, under 70 chars)
• Derive the type from the branch prefix (feat/ → feat, fix/ → fix, docs/ → docs)

1. Create PR using the template from .github/PULL_REQUEST_TEMPLATE.md:

gh pr create --title "<title>" --assignee @me --label "<label>" --body "$(cat <<'EOF'
## 🤔 Background

Related #<issue-number>

<1-2 sentences: motivation and context for the changes>

## 💡 Changes

- <bullet 1: what changed and why>
- <bullet 2>
- <bullet 3> (optional)
- <bullet 4> (optional)
EOF
)"