gh-plan-review

Inspect GitHub implementation plans and surface risks without mutating code or git state.

3|2|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/beeman/skills --skill gh-plan-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gh-plan-review
Source: https://github.com/beeman/skills/tree/main/gh-plan-review
Command: npx skills add https://github.com/beeman/skills --skill gh-plan-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Review, challenge, pressure-test, or refine an implementation plan tied to a GitHub issue, GitHub PR, or active branch. Use when Codex needs to inspect the authoritative GitHub state and local repo context, run a scope challenge, identify material plan risks, surface real tradeoffs, and finish with a fixed review summary without mutating code or git state.

Core Features & Use Cases

  • Ground the review in the authoritative GitHub state and local repository context, run a Scope Challenge, identify risks and tradeoffs, and deliver a clear, mutation-free assessment.
  • Boundaries and safety: explicitly refrain from editing code, issues, PRs, or branch state during the review.
  • Use Case: before starting implementation, when evaluating plan feasibility, risks, or deployment strategy, or when an execution plan needs a formal, decision-ready summary.

Quick Start

Provide the GitHub issue/PR/branch details and let the skill generate a pressure-tested, mutation-free review summary.

Frequently Asked Questions about gh-plan-review

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

FAQPage Schema
How do I pressure-test a GitHub implementation plan before writing any code?

To pressure-test a GitHub implementation plan, provide the issue, PR, or branch details to generate a mutation-free review summary. The assessment grounds itself in the authoritative GitHub state and local repository context to surface material risks and tradeoffs without altering code or git state.

What is a scope challenge for a GitHub issue or PR?

A scope challenge for a GitHub issue or PR is a formal plan review that identifies material risks and real tradeoffs. It inspects the authoritative GitHub state and local repository context to deliver a decision-ready summary before coding begins.

Can I review a GitHub branch for deployment risks without mutating git state?

Yes, you can review a GitHub branch for deployment risks without mutating git state. The review explicitly refrains from editing code, issues, PRs, or branch state, ensuring a safe, mutation-free assessment of plan feasibility and risks.

How do I get a decision-ready summary for a GitHub execution plan?

To get a decision-ready summary for a GitHub execution plan, run a scope challenge against the issue, PR, or branch. This produces a fixed review summary with clear findings, identifying real tradeoffs and material risks before you commit changes.

When should I run a plan review on a GitHub PR?

Run a plan review on a GitHub PR before starting implementation or when evaluating plan feasibility, risks, or deployment strategy. It provides a formal, decision-ready summary by inspecting the authoritative GitHub state and local repository context.

What are the limitations of a mutation-free GitHub plan review?

A mutation-free GitHub plan review is limited to inspecting and challenging implementation plans; it explicitly refrains from editing code, issues, PRs, or branch state. It delivers a fixed summary with clear findings but does not apply any changes to the repository.