review-plan

Evaluate implementation plans and issue READY, NEEDS_REVISION, or BLOCKED verdicts with prioritized findings.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of wasting time and resources on implementation plans that contain hidden feasibility issues, missing verification steps, ordering bugs, or unrecorded decisions that only surface mid-execution, leading to rework and blocked work.

Core Features & Use Cases

  • Structural Plan Validation: Enforces a plan-shape contract requiring machine-readable checkboxes, explicit file touch references, verifiable task steps, appropriate task sizing, and a defined end-state.
  • Content Checklist Review: Evaluates plans against 8 core categories including feasibility, completeness, open questions, task ordering, verification coverage, scope, risk, and improvement opportunities.
  • Clear Verdict Output: Returns a machine-parseable READY / NEEDS_REVISION / BLOCKED verdict with a prioritized findings table and actionable recommendations, usable both standalone and as a pre-execution gate for other skills like implement-plan.
  • Use Case: Before starting work on a new feature implementation plan, run this review to catch if a task references a non-existent file, if two dependent tasks are ordered incorrectly, or if a critical undecided choice like a cache library is unrecorded.

Quick Start

Use the review-plan skill to evaluate your implementation plan file and receive a clear readiness verdict with prioritized fixes before starting any coding work.

Frequently Asked Questions about review-plan

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

FAQPage Schema
What is a pre-flight check for an implementation plan?

A pre-flight check for an implementation plan is a structural validation that identifies feasibility gaps, missing verification steps, ordering bugs, and unrecorded decisions before any coding begins. It produces a machine-parseable READY, NEEDS_REVISION, or BLOCKED verdict to prevent mid-execution rework.

How do I review an implementation plan for feasibility risks before coding?

To review an implementation plan for feasibility risks, evaluate the plan against eight core categories including feasibility, completeness, task ordering, and risk factors. This generates a prioritized findings table with actionable recommended edits to resolve any identified structural contract violations.

Can I use automated plan validation for markdown implementation files?

Yes, automated plan validation applies directly to all software engineering implementation plan markdown files. It enforces a plan-shape contract by requiring machine-readable checkboxes, explicit file touch references, verifiable task steps, appropriate task sizing, and a clearly defined end-state.

What is the best way to catch unrecorded decisions and task ordering bugs in a development plan?

The best way to catch unrecorded decisions and task ordering bugs is to run a content checklist review on the plan. This evaluates verification coverage and scope, returning a prioritized findings table that highlights incorrectly ordered dependent tasks or missing critical choices like a cache library.

Does plan review output a machine-parseable readiness verdict?

Yes, plan review outputs a clear machine-parseable READY, NEEDS_REVISION, or BLOCKED verdict paired with a prioritized findings table. This structured output is usable both standalone and as a pre-execution gate for downstream implementation skills.

When should I not use automated implementation plan review?

You should not use automated implementation plan review if your plan lacks machine-readable checkboxes, explicit file touch references, or verifiable task steps. The structural validation requires this defined plan-shape contract and a clear end-state to generate a meaningful readiness verdict.