pr

Open a reviewable PR/MR for the current branch. The reviewer arrives cold — not a teammate who lived through the work, but someone handed an agent's output. The body is the only bridge between the agent's context and what the human needs to decide.

Multi-repo work is one PR per repo. cd into each repo root before the create command — git CLIs infer the remote project from cwd, not from arguments. Cross-reference paired PRs in the body.

Conventional commits

!cat ~/.claude/skills/conventional-commits.md

CLI invocation

--fill conflicts with explicit title/body in both gh and glab.

Pass the cleanup flag so the source branch is removed on merge.

Updating an existing PR: gh pr edit --body / glab mr update --description take the new body and overwrite — re-render from current truth, don't fetch-and-concat.

PR body

No placeholders, no filler — a ## Summary with [Description of changes] is worse than no Summary at all.

• Task — issue link or one-line of what was asked.
• Summary — what + why. Approach chosen and why over alternatives: "X over Y because Z." 2–4 lines.
• Changes — one bullet per meaningful change, grouped by area. A change list, not a file list.
• Self-Review — what the agent verified ([x]) vs. couldn't ([ ]). Name the evidence per item.
• Human Review — specific things where human judgment is load-bearing.

Template

$(cat <<'EOF'
## Task

## Summary

## Changes

-

## Self-Review

- [x]
- [ ]

## Human Review

- [ ]

EOF
)