pr-craft

Installation
SKILL.md

pr-craft

Drive a clean PR end to end: branch, stage only the relevant files, conventional-commit, push, open the PR with a structured body.

Flow

  1. Inspect. git status + git diff (and git diff --staged). Identify which changed files belong to this task. Pre-existing modified/untracked files unrelated to the work (lockfiles, config, scratch dirs) are NOT yours — leave them.
  2. Branch. If on the base branch (main/staging/master), create type/short-slug (e.g. fix/marketing-consent-required-signup). Type matches the commit type. If already on a feature branch, stay.
  3. Stage explicitly. git add <file> <file> … — name each relevant file. Never git add . / -A. Re-run git status to confirm only intended files are staged.
  4. Commit. Conventional Commits subject (type(scope): summary, ≤72 chars). Body explains why + bullet the changes. End with Refs task <id> / Refs <ticket> when known. Obey the repo's CLAUDE.md (e.g. no Co-Authored-By trailer if it says so).
  5. Push. git push -u origin <branch>.
  6. Open PR. gh pr create --base <base> --head <branch> --title "<same as commit subject>" --body "$(cat <<'EOF' … EOF)". Base = the branch the user named, else the repo default (staging here, often main elsewhere — check git remote show origin or repo CLAUDE.md if unsure).
  7. Report the PR URL. Offer follow-ups (log time, comment the link on the task).

PR body structure

Only include sections that carry signal — drop empty ones. Concise, no filler.

Installs
1
First Seen
Aug 7, 2026
pr-craft — mqmalagris/agent-skills