plan-design-review

Reviews design plans through seven scored passes and fixes gaps interactively.

Updated Sep 13, 2026
One-click install
npx skills add https://github.com/abdulazeezoj/monovella-poc --skill plan-design-review-abdulazeezoj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-design-review
Source: https://github.com/abdulazeezoj/monovella-poc/tree/main/.agents/skills/gstack/plan-design-review
Command: npx skills add https://github.com/abdulazeezoj/monovella-poc --skill plan-design-review-abdulazeezoj

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Design plans often ship with vague UI descriptions, missing interaction states, and generic AI-generated patterns that only surface as problems during implementation. This Skill catches those gaps before any code is written by walking through a structured, interactive design critique of the plan. ## Core Features & Use Cases - Seven scored review passes: Rates information architecture, interaction states, user journey, AI slop risk, design system alignment, responsive/accessibility coverage, and unresolved decisions on a 0-10 scale, then proposes fixes to reach 10. - AI slop detection: Applies a blacklist of 11 recognizable AI-generated design patterns (3-column feature grids, purple gradients, generic hero copy) plus hard rejection criteria and litmus checks. - Interactive decision workflow: Fires one AskUserQuestion per finding with recommendations, completeness scores, and tradeoffs, then edits the plan only after approval. - Use Case: Before implementing a new dashboard, run this Skill on the plan to discover it lacks empty-state specs, mobile layout decisions, and DESIGN.md token references, then resolve each gap interactively. ## Quick Start Ask the assistant to review the design plan for the new feature before implementation begins.

Frequently Asked Questions about plan-design-review

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

FAQPage Schema
How do I review a design plan before implementation?

Invoke the plan-design-review skill while in plan mode. It runs seven scored passes over the plan, asks one question per finding with a recommendation, and edits the plan only after you approve each fix.

What design issues does a plan review catch?

It catches missing interaction states (loading, empty, error), vague UI descriptions, AI slop patterns like 3-column feature grids and purple gradients, missing responsive and accessibility specs, and unresolved decisions that would haunt implementation.

Can this skill review a live website design?

No, it works on plans in plan mode, not live sites. For visual audits of a running site, use the /design-review skill instead, which this skill's documentation explicitly points to for that scenario.

Does the design review work with a DESIGN.md file?

Yes. Pass 5 checks plan alignment against DESIGN.md and cites tokens by path when the file has YAML frontmatter. If no DESIGN.md exists, it flags the gap and recommends running /design-consultation first.

What happens if the review finds zero issues?

Each pass with zero findings reports 'No issues found' and moves on. Zero findings across all sections is the only path that skips the interactive question flow and proceeds directly to the completion summary.