pr

Create or update a GitHub pull request following Medox conventions (author spicode-bot, reviewer spideystreet). Invoke manually with /pr — do NOT trigger automatically.

14 stars

Best use case

pr is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Create or update a GitHub pull request following Medox conventions (author spicode-bot, reviewer spideystreet). Invoke manually with /pr — do NOT trigger automatically.

Teams using pr should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/pr/SKILL.md --create-dirs "https://raw.githubusercontent.com/spideystreet/medox/main/.claude/skills/pr/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/pr/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How pr Compares

Feature / AgentprStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Create or update a GitHub pull request following Medox conventions (author spicode-bot, reviewer spideystreet). Invoke manually with /pr — do NOT trigger automatically.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Skill: Pull Request

Create or update a GitHub PR following the conventions defined in `.claude/rules/git.md`.

## Steps

1. **Pre-flight: docs sync** — run `/docs-up` first to ensure docs are up to date with code changes
2. `git log main..HEAD --oneline` — review commits included
3. Push if needed: `git push -u origin <branch>`
4. **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)

Related Skills

We are still matching the closest adjacent skills for this page. In the meantime, continue through the full directory.