review

Critique SPEC.md, PLAN.md, and source files with persona-based lenses.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill ensures that SPEC.md, PLAN.md, and source files receive objective persona-driven critiques that overcome confirmation bias and clarify actionable next steps.

Core Features & Use Cases

  • Persona lenses: Applies specific personas such as Beck, Farley, Feathers, and others to frame findings that highlight simplicity, verification, and safety concerns.
  • Validation & heuristics: Validates requirement structures, mandates Farley for code, proposes lenses lazily, and flags misaligned domain vocabulary or missing acceptance criteria.
  • Use case: Run /review on a feature’s directory after /new-plan + /new-task to catch missing tests, mis-traced requirements, and domain term drift before implementation or release.

Quick Start

Invoke the review skill with /review dev-docs/auth/PLAN.md --lens farley to get a verification-focused critique.

Frequently Asked Questions about review

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

FAQPage Schema
How do I run a persona-based code review on planning artifacts?

To run a persona-based code review, invoke the review skill targeting a directory containing SPEC.md and PLAN.md to surface alignment issues and domain language drift. This applies specific persona lenses like Beck or Farley to frame actionable findings.

What is persona lens heuristic validation for spec files?

Persona lens heuristic validation is a critique mechanism that checks SPEC.md files for missing acceptance criteria and misaligned domain vocabulary. It proposes lenses lazily and mandates specific personas like Farley for code to ensure verification and safety.

How do I check SPEC.md and PLAN.md alignment before implementation?

To check SPEC.md and PLAN.md alignment, run a review on the feature directory after generating your plan and tasks. This process validates requirement structures and flags mis-traced requirements to catch issues before implementation or release.

Does the review skill work with source code files or only planning documents?

The review skill works with both planning documents and source code files. It delivers persona-driven critiques for SPEC.md, PLAN.md, and implementation files, mandating the Farley persona specifically for code to highlight verification concerns.

Can I target a specific persona lens when reviewing a PLAN.md file?

Yes, you can target a specific persona lens when reviewing a PLAN.md file by passing the lens argument. Invoking the review skill with a specific lens like Farley ensures the critique focuses heavily on verification, simplicity, and safety concerns.

What is the best way to overcome confirmation bias during plan reviews?

The best way to overcome confirmation bias during plan reviews is applying objective persona-driven critiques. By using distinct personas such as Beck, Farley, and Feathers, the review process surfaces simplicity and verification issues that clarify actionable next steps.