skills.rest
sanjanb
sanjanbCOMMUNITY
Explore all skills by this author →
GitHub

plan-review

Reviews implementation plans against citation, completeness, and actionability quality criteria.

1|Updated Jul 23, 2026
Search Tags:#implementation plan#citation verification#plan review#quality checklist#planning workflow#severity classification
One-click install
npx skills add https://github.com/sanjanb/my-agent-harness --skill plan-review-sanjanb
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plan-review
Source: https://github.com/sanjanb/my-agent-harness/tree/main/skills/plan-review
Command: npx skills add https://github.com/sanjanb/my-agent-harness --skill plan-review-sanjanb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Implementation plans often contain vague goals, unsubstantiated architectural decisions, and ambiguous tasks that cause execution failures. This Skill provides a systematic checklist for auditing plan quality before any code is written. ## Core Features & Use Cases - Three-Category Quality Audit: Evaluates Citation Quality, Completeness, and Actionability with concrete pass/fail checks and red-flag examples. - Severity Classification: Assigns Critical, Major, Minor, or Nitpick severity to each finding so reviewers know what must be fixed before execution. - Standardized Output Format: Produces a structured review report with an overall verdict (APPROVE, REQUEST_CHANGES, NEEDS_DISCUSSION), issue lists, and a quality assessment table. - Use Case: Before executing a saved implementation plan, run this review to verify that decisions cite research references, goals are measurable, and every task names a specific file or component. ## Quick Start Review the current implementation plan and report any critical or major issues with citations, completeness, and actionability.

Frequently Asked Questions about plan-review

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

FAQPage Schema
How do I review an implementation plan before execution?▼

Review the plan across three categories: citation quality, completeness, and actionability. Check that decisions reference research sources, the goal is specific and measurable, and each task names a concrete file or component. Classify findings by severity and issue an APPROVE or REQUEST_CHANGES verdict.

What makes an implementation plan task actionable?▼

An actionable task names a specific file or component and has a clear implementation path, such as creating src/auth/jwt.ts with sign and verify functions. Vague tasks like set up the backend or investigate the issue fail the actionability check.

Does plan review check the plan's formatting and structure?▼

No, structural validation such as YAML frontmatter, status markers, and numbering is handled separately by plan_save before storage. The review focuses only on quality aspects: citations, completeness, and actionability.

What severity levels are used in a plan review?▼

Findings are classified as Critical, Major, Minor, or Nitpick. Critical issues like missing citations for key decisions must be fixed before execution, while nitpicks such as wording suggestions are optional.

When should I not use plan review?▼

Do not use it to evaluate code quality, which belongs to code review, or to re-validate plan formatting handled by plan_save. It also does not execute or modify the plan during the review process.

Related Skills

Explore More Software Engineering Skills→
microsoftmicrosoft
1.4k

rpi-plan

Create evidence-based implementation plans and phase details from research and user decisions.

Official
Advanced
bacocobacoco
67

openspec-change-implementation

Implement approved OpenSpec proposals by executing tasks and recording test evidence.

Community
Advanced
iAMv1iAMv1
1

deep-research

Coordinate multi-source research and produce a cited report with confidence levels.

Community
Advanced
amirbironamirbiron

pairing

Builds work in reviewable pieces, pausing for feedback before starting each next piece.

Community
Advanced