pr-workflow_skill

Overview

This skill automates and enforces a consistent pull request workflow for my personal Claude Code and OpenAI Codex setup. It guides branch creation, commit analysis, documentation updates, and PR creation using /pr-creator or gh commands to produce reviewer-friendly PRs. The skill focuses on clear titles, comprehensive PR bodies, and inline source links for fast review.

How this skill works

It inspects staged and local changes, ensures you are on a feature branch (creates one if needed), and analyzes the complete diff against the target base branch. It helps update docs, formats a multi-commit PR body with inline file/line links and examples, and runs the selected PR creation command (/pr-creator or gh pr create) with standard flags (title, body, assignee, reviewers).

When to use it

• When you want to open a new pull request from your current branch or staged changes
• After finishing a set of commits that need a consolidated PR message covering all commits
• When you need to ensure documentation or README updates accompany code changes
• When you want consistent PR titles and bodies with inline source links and examples
• When you prefer automating reviewer selection or self-assignment via CLI or agent commands

Best practices

• Confirm staged changes with git diff --cached --name-only before creating a PR
• If on main/master, create a feature branch named feature/brief-description or fix/brief-description
• Describe the full changeset using git diff <base>...HEAD, not just the last commit
• Start PR titles with a capitalized verb and avoid prefixes like fix: or feat:
• Use bullets with inline source links and include before/after examples for significant refactors
• Assign yourself and add reviewers via gh pr list to find likely reviewers

Example use cases

• Push local commits and create a PR that summarizes several commits and links to changed lines
• Refactor authentication to async with a before/after code example in the PR body
• Update API or config and include docs/README changes plus external sources for verification
• Run /pr-creator to auto-generate a title, body, and self-assign the PR using project conventions
• Use gh pr create with -t and -b flags prefilled by the skill for quick CLI-driven PRs