# Pr

> Creates or updates a pull request with summary and test plan. Use when the user asks to open a PR, push for review, or says /pr. Only push when explicitly asked (or when invoked as Phase 0 of a requested release).

- Skill: `axidify/pr` (Agent Skill)
- Install (CLI): `npx skillmds@latest add axidify/pr`
- Raw SKILL.md: https://api.skillmd.com/api/skills/axidify/pr/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Axidify (https://skillmd.com/u/axidify)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/axidify/pr

---


# Pull request

Run **review** (three passes; and **test** if not already) before opening when changes are substantive. Use **security** or **performance** when those risks dominate.

## Checklist

1. **Branch state** — `git status`; branch tracks remote; commits ahead of base
2. **Base branch** — confirm `main` / `develop` per project convention
3. **Diff scope** — `git diff [base]...HEAD`; summarize all commits on the branch
4. **Push** — only if the user explicitly asked (`git push -u origin HEAD`), or
   when this skill runs as **release** Phase 0
5. **Create PR** — use `gh pr create` when GitHub is the host

## PR body (adapt to project template if one exists)

```markdown
## Summary
- …

## Test plan
- [ ] …
```

## Rules

- NEVER update git config
- Do not force-push `main` / `master` without explicit user request and warning
- Return the PR URL when created
- Link related issues (`Fixes #123`) when the user provides IDs

**release** owns the full ship sequence: this skill (Phase 0) → merge → version/tag.
When the user says **release**, do not stop after opening the PR.

## User shorthand (with **release**)

| User says | Agent does |
| --------- | ---------- |
| **go** | This skill — open PR only |
| **merge** | Merge PR + sync `main` (**release** Phase A) |
| **release** / **ship** | **release** Phase 0 → A → B (PR, merge, then release) |
| **merge and release** | **release** Phase A → B (Phase 0 if no PR yet) |

## Related skills

- **review** — run before opening
- **test** — evidence for test plan
- **ci** — fix red checks before or after PR
- **release** — after PR: merge + version/tag when user asks to ship
- **plan-driven-implementation** — update plan Progress/Issues logs when PR implements `docs/plans/`