ship-pr

Create GitHub pull requests after validating diffs against CLAUDE.md and repo conventions.

3|1|Updated Nov 29, 2025
One-click install
npx skills add https://github.com/indrasvat/claude-code-skills --skill ship-pr-indrasvat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ship-pr
Source: https://github.com/indrasvat/claude-code-skills/tree/main/skills/ship-pr
Command: npx skills add https://github.com/indrasvat/claude-code-skills --skill ship-pr-indrasvat

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Create a pull request with a standards-compliance review gate. Reviews the diff against CLAUDE.md and repo conventions before creating the PR, stopping on discrepancies. Supports tiered PR templates (small, standard, complex). Use when the user says "create PR", "open PR", "ship it", "ship PR", "make a pull request", "push and PR", "ready for review", "send for review", "create a pull request", or wants to create a GitHub pull request from the current branch.

Core Features & Use Cases

  • Enforces a standards-review gate before PR creation.
  • Supports tiered templates (small, standard, complex) for PR bodies.
  • Integrates with gh and git to automate inspection, branch handling, commit messaging, and PR creation.

Quick Start

Run the ship-pr workflow on the current branch to create a standards-checked PR.

Frequently Asked Questions about ship-pr

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate GitHub pull request creation with code-review standards validation?

To automate GitHub pull request creation with standards validation, this Skill reviews your diff against CLAUDE.md and repo conventions, blocking creation on discrepancies and applying tiered templates before submitting.

How does a standards-compliance gate work for pull requests?

A standards-compliance gate for pull requests works by inspecting the branch diff against repository conventions and CLAUDE.md rules, halting the PR creation process automatically if the code fails to meet these predefined prerequisites.

Can I use tiered PR templates for small, standard, and complex pull requests?

You can use tiered PR templates for small, standard, and complex pull requests by running the automated PR workflow, which assembles the appropriate structured template based on the changes detected in your current branch.

What are the prerequisites for enforcing repo conventions before opening a GitHub PR?

Prerequisites for enforcing repo conventions before opening a GitHub PR include having CLAUDE.md and repository convention files configured, along with the gh CLI and git installed to handle branch inspection, commits, and PR creation.

Why does my automated pull request get blocked before creation?

Your automated pull request gets blocked before creation because the standards-compliance gate detected discrepancies between your code diff and the repository's CLAUDE.md or convention rules, preventing non-compliant merges.

Does this PR automation tool integrate with git and gh for branch handling?

This PR automation tool integrates directly with git and gh to automate branch inspection, commit messaging, and the final GitHub pull request creation, ensuring standards compliance throughout the workflow.