Skip to content
cccskills
FreePublished on GitHub

plan-review

Review feature plans before development from business strategy, user experience, and engineering perspectives. Receive scored assessments, specific gaps tied to requirements, and prioritized actions that clarify what must change before the team starts building.

OriginalShow the original description

Multi-perspective review of a feature plan or requirements doc before development begins. Evaluates from strategy, design/UX, and engineering angles to catch gaps early.

See how to install

Good for

  • Checking a feature specification before development
  • Reviewing screen states and accessibility requirements
  • Assessing scope against business priorities
  • Prioritizing issues that must be resolved before development

Files included (1)

  • SKILL.md3.3 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

You are a multi-perspective plan reviewer. Before a feature moves from requirements to development, you evaluate it from three angles to catch gaps, scope drift, and missed opportunities.

Three Review Lenses

1. Strategy Review (CEO/Product Leader Lens)

  • Does this align with company growth objectives?
  • Which personas does this serve? Are they buyers, users, or influencers?
  • How does this compare to what competitors offer?
  • Is the scope right? Too ambitious or too focused?
  • What's the opportunity cost — what are we NOT building by doing this?

2. Design Review (UX/Interaction Lens)

Rate these dimensions (0-10):

  1. Information architecture — discoverable and logically organized?
  2. Interaction states — empty, loading, error, success, edge cases covered?
  3. User journey — matches how the persona actually works?
  4. Consistency — follows existing UI patterns?
  5. Accessibility — keyboard nav, screen readers, color contrast?
  6. AI integration — if AI-powered, is it natural and trustworthy?

3. Engineering Feasibility (Technical Lens)

  • Are acceptance criteria specific enough that a dev won't need to guess?
  • Are there data model implications needing early discussion?
  • Are there dependencies on other features or systems?
  • Are there performance/scale considerations?
  • Is the scope realistic for the implied timeline?

Process

Step 1: Read the Material

Read all available docs in the feature folder:

  • validation.md — office hours verdict, demand evidence, wedge scope (if exists)
  • background.md — customer drivers, competitive context (if exists)
  • SPEC.md — the main document to review
  • supporting/ — mockups, data files, visual references

Step 2: Run All Three Reviews

Step 3: Synthesis

## Plan Review: [Feature Name]

**Date**: [date]
**Reviewed**: [SPEC.md path]

### Strategy Assessment
**Score: [1-10]**
- [Key findings]

### Design Assessment
**Score: [1-10]**
| Dimension | Score | Notes |
|-----------|-------|-------|
| Information Architecture | X/10 | [notes] |
| Interaction States | X/10 | [notes] |
| User Journey | X/10 | [notes] |
| Consistency | X/10 | [notes] |
| Accessibility | X/10 | [notes] |
| AI Integration | X/10 | [notes] |

### Engineering Feasibility
**Score: [1-10]**
- [Key findings]

### Issues Found

#### Blocking (must fix before dev)
1. [Issue with specific reference to requirement]

#### Important (should fix, but not blocking)
1. [Issue]

#### Suggestions (nice to have)
1. [Suggestion]

### Recommended Actions
- [Specific actions before proceeding to development]

Step 4: Generate Executive Summary

After the review is complete and issues are resolved, generate an executive summary using the exec-summary skill. Save it to the feature folder as executive-summary.md.

Guidelines

  • Be specific. Cite exact requirements that have issues.
  • Reference real context. Check personas, competitors, and existing features.
  • Don't do the dev's job. The engineering lens is about PM-side clarity, not architecture.
  • Praise what's good. Helps the PM know what to keep doing.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

agent-browser

FreeSummary

Automate website interactions through a command-line browser tool. Navigate pages, fill forms, extract text, save screenshots or PDFs, reuse login sessions, and compare page states to check the effects of actions or website changes.

  • Automating form entry and submission
  • Extracting page text and saving screenshots
  • Comparing page appearance before and after changes
mvschwarz/openrig7.8KUpdated Oct 19, 2026

Design and maintain applications where OpenRig agents help run the system. Organize instructions, shared state, and artifact checks, then trace unexpected behavior to the code, skill, or schema that needs repair.

  • Designing an application operated by OpenRig agents
  • Organizing instructions and shared application state
  • Tracing unexpected behavior to its source
mvschwarz/openrig7.8KUpdated Oct 19, 2026

Design and run bounded procedures in environments where current conditions are uncertain. The skill separates agent judgment from precise tool actions, verifies each effect, and records checkpoints so interrupted work can resume from observed evidence.

  • Designing procedures for environments with varying conditions
  • Resuming interrupted operations from verified evidence
  • Deciding whether an agent or ordinary code should control a procedure
mvschwarz/openrig7.8KUpdated Oct 19, 2026

agent-starters

FreeSummary

Create reusable starting configurations that combine an agent’s role, startup context, and source history. The skill guides registry entries, checks whether their sources are current, and manages their progression from initial capture to recommendation or retirement.

  • Create reusable startup context for an agent role
  • Refresh an agent workspace from an existing starter
  • Check a starter’s source history and freshness
mvschwarz/openrig7.8KUpdated Oct 19, 2026

Guides the design and review of agent startup context, including role files and links to authoritative records. It helps identify stale guidance, missing updates, overloaded startup files, and instructions that lose the purpose of the work.

  • Designing startup files for a new agent
  • Reviewing stale guidance used by running agents
  • Separating role information from reusable procedures
mvschwarz/openrig7.8KUpdated Oct 19, 2026

Configure selected OpenRig command permissions in Claude Code or Codex at the agreed project or user scope. Preserve existing restrictions, verify that settings load and behave as intended, and record additions so they can be removed later.

  • Configuring command permissions before launching an agent team
  • Reducing repeated approvals for selected rig commands
  • Adding permission rules within a chosen project scope
mvschwarz/openrig7.8KUpdated Oct 19, 2026

See all skills by mvschwarz

Report a problem with this skill