| name | pr |
| description | Create or update a GitHub pull request following Medox conventions (author spicode-bot, reviewer spideystreet). Invoke manually with /pr — do NOT trigger automatically. |
| disable-model-invocation | true |
Skill: Pull Request
Create or update a GitHub PR following the conventions defined in .claude/rules/git.md.
Steps
- Pre-flight: docs sync — run
/docs-up first to ensure docs are up to date with code changes
git log main..HEAD --oneline — review commits included
- Push if needed:
git push -u origin <branch>
- Check if a PR already exists for the current branch:
- Use
mcp__github__list_pull_requests with head: "spideystreet:<branch>" and state: "open"
- If a PR exists → update it (step 5b)
- If no PR exists → create it (step 5a)
5a. Create PR
- Use
mcp__github__create_pull_request:
title: <type>(<scope>): <summary>
head: current branch
base: main
body: see Body format below
- Add reviewer:
gh pr edit <number> --add-reviewer spideystreet
5b. Update PR
- Use
gh pr edit <number> to update --title and/or --body if commits changed the scope
- Push new commits (already done in step 3)
- Report the existing PR URL to the user
Body format
## Summary
- <bullet points from commits>
## Test plan
- [ ] `uv run pytest <tests> -v`
- [ ] Manual: <scenario>
🤖 Generated with [Claude Code](https://claude.ai/claude-code)
Rules
- Always prefer GitHub MCP tools (
mcp__github__*) over gh CLI for GitHub operations (create PR, list issues, add comments, etc.)
- Use
git CLI only for local operations (log, push, diff, status)
- Use
gh pr edit for updating title/body (no MCP equivalent)