orc-pr-setup

Plans stacked pull request layers and writes a stack-plan.md file without touching git.

6|1|Updated Jul 4, 2026
One-click install
npx skills add https://github.com/azure-id/orc --skill orc-pr-setup-azure-id
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: orc-pr-setup
Source: https://github.com/azure-id/orc/tree/main/templates/skills/orc-pr-setup
Command: npx skills add https://github.com/azure-id/orc --skill orc-pr-setup-azure-id

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Large pull requests with thousands of lines across dozens of files are effectively unreviewable, leading to rubber-stamp approvals, risky big-bang merges, and painful reverts. This Skill decides where to cut one big change into an ordered chain of small, individually reviewable stacked pull requests. ## Core Features & Use Cases - Layer Planning: Groups changed files into ordered layers (schema → store → logic → adapter → wiring → transport → docs/flag) using a dependency graph, so each layer only depends on layers below it. - Measured Budgets: Uses real git diff --numstat numbers against configurable ceilings (lines per layer, files per layer, max layers) instead of guesses, with exclusions for generated code and lock files. - Uncertainty Gate: When a cut line is ambiguous, it stops and asks one decision at a time with costs and a recommendation, recording every answer in a ## Decisions audit trail. - Use Case: After building a 1,800-line payment feature, run the planner to split it into three reviewable PRs — a database migration, the store and domain logic, and the HTTP handler — each with a purpose, value class, and green-gate commands written into stacked-pr/<slug>/stack-plan.md. ## Quick Start Ask the assistant to plan stacked pull requests for the current change by invoking /orc-pr-setup and providing a ticket number.

Frequently Asked Questions about orc-pr-setup

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

FAQPage Schema
How do I split a large pull request into stacked PRs on GitHub?▼

Run the planner with a ticket number; it reads the real diff numbers, groups files into dependency-ordered layers, and writes a stack-plan.md. A separate driver skill then creates the branches and PRs from that plan.

What are stacked pull requests and when should I use them?▼

Stacked PRs are a chain of small PRs in one repository where each targets the branch below it. Use them when a change exceeds roughly 1000 lines or 20 files, so reviewers can approve small diffs in parallel and you can merge or revert layers independently.

Does stacked PR planning require the GitHub CLI and gh-stack extension?▼

Yes. Preflight checks require gh version 2.0 or newer, an authenticated session, and the github/gh-stack extension. The repository must not be a fork, since GitHub stacks cannot cross forks.

Can stacked pull requests span multiple repositories or forks?▼

No. GitHub stacks live within a single repository, and cross-fork stacks are unsupported. For changes spanning several repos, use a multi-repo planning approach such as /orc-poly instead.

What happens if a change cannot be split into clean layers?▼

The planner never fakes a split. If the smallest coherent unit exceeds the size ceiling, it explains why and asks you to accept an oversized layer; if the change needs too many layers, it recommends multiple stacks or a phased release.

Does the stacked PR planner create branches or commits?▼

No. It only reads git state and writes one markdown plan file. All branch, commit, push, and PR creation is delegated to the separate orc-pr-driver skill after you approve the plan.