review-plan

Reviews implementation plans via a sandboxed Claude Code subprocess for flaws and gaps.

1|Updated Feb 10, 2026
One-click install
npx skills add https://github.com/Amorim33/.agents --skill review-plan-amorim33
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: review-plan
Source: https://github.com/Amorim33/.agents/tree/main/skills/review-plan
Command: npx skills add https://github.com/Amorim33/.agents --skill review-plan-amorim33

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Before executing an implementation plan, it is hard to spot your own blind spots. This Skill gets an independent second opinion by sending your plan to a sandboxed Claude Code subprocess that grades it and lists concrete concerns. ## Core Features & Use Cases - Independent Plan Review: Spawns a claude -p subprocess with tools disabled so the review is analysis-only and cannot execute code or read files. - Structured Feedback: Returns a grade from 0 to 5, an overall assessment, severity-tagged concerns ([Critical], [Important], [Minor]), and a summary of what works well. - Resumable Sessions: Captures the subprocess session ID so you can continue the review conversation with follow-up questions via --resume. - Use Case: You just finished drafting an implementation plan in ~/.claude/plans/. Run the Skill to have a senior-engineer persona check it for missing edge cases, security implications, and dependency ordering problems before you start coding. ## Quick Start Ask the AI to review your latest implementation plan, or provide a specific path such as /review-plan ~/plans/my-plan.md to review a particular file.

Frequently Asked Questions about review-plan

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

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

Run the review-plan Skill with a plan file path, or with no arguments to review the most recent Markdown file in ~/.claude/plans/. It spawns a Claude Code subprocess that grades the plan and lists severity-tagged concerns.

How to get a second opinion on a coding plan with Claude Code?▼

The Skill runs `claude -p` as a subprocess with a senior staff engineer prompt that checks for logical inconsistencies, missing edge cases, security implications, and architectural concerns, returning a structured grade from 0 to 5.

Can the review subprocess execute code or modify files?▼

No. The subprocess is launched with `--tools ""`, which sandboxes it so it cannot execute code or read files. It receives the plan only via stdin redirection and performs analysis only.

How do I ask follow-up questions about a plan review?▼

The Skill captures the session ID printed by the claude subprocess. Run /review-plan --resume <session-id> to continue the existing review conversation and discuss specific concerns or fixes.

What happens if no plan file is found?▼

If no path is given and no Markdown files exist in ~/.claude/plans/, the Skill tells you no plans were found and asks you to provide an explicit path. It also stops if the file is missing or empty.