---
name: pr
description: Create or revise a draft pull request.
allowed-tools: Bash, Read, Write, Glob
argument-hint: "[pr-number-to-edit]"
---

# Pull request

Use the target repo's committed template, searching `.github/`, the repo root, and `docs/`.
Without one, use this skill's
[.github/pull_request_template.md](.github/pull_request_template.md). Preserve the chosen
template's headings and markers.

Plain register: concrete nouns, no inflated adjectives, no `not just X but Y` framing, no
closing flourish.

Derive problem, outcome, scope, decisions from issue, source, diff, and commits. Never rely
on branch or subjects alone. Open on outcome. Explain behavior and decisions, not files.
Keep proportional. Specific title. Draft unless ready requested.

Visible changes: add useful named before/after captures; recording for motion or flows.
Upload as GitHub user attachments. Read
[references/github-attachments.md](references/github-attachments.md).

Write the body file to an absolute session-scratchpad path, never $TMPDIR: gh runs unsandboxed,
where $TMPDIR is shared and --body-file can read another session's file.

Submit with `gh pr create` or `gh pr edit`, preserving formatting.