plan-design-review

Reviews implementation plans for missing UI/UX design decisions and edits them to completeness.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Implementation plans often describe backend logic while leaving UI design decisions unspecified, leading engineers to ship generic layouts, missing empty states, and unhandled edge cases. This Skill reviews a plan before implementation, rates its design completeness across seven dimensions, and fixes gaps directly in the plan. ## Core Features & Use Cases - Seven-Pass Design Review: Rates information architecture, interaction states, user journey, AI slop risk, design system alignment, responsive/accessibility, and unresolved decisions on a 0-10 scale, then edits the plan to reach 10. - Interactive Decision Resolution: Surfaces each genuine design choice as a single question with recommendations, effort estimates, and consequences of deferral. - Design Debt Tracking: Produces a completion summary, a NOT-in-scope list, and structured TODOS.md entries for deferred design work. - Use Case: Before implementing a new dashboard feature, run this Skill on the plan to catch missing empty states, unspecified mobile layouts, and vague descriptions like "clean, modern UI" before any code is written. ## Quick Start Ask the AI to review the design completeness of the current implementation plan using the plan-design-review skill.

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 plan for missing UI design decisions before implementation?

Run this Skill against the current plan or branch diff. It rates design completeness 0-10 across seven dimensions, explains what a 10 looks like, and edits the plan directly to add missing specifications like empty states, responsive behavior, and accessibility requirements.

What design dimensions does a plan design review cover?

The review covers seven passes: information architecture, interaction state coverage (loading/empty/error/success), user journey and emotional arc, AI slop risk, design system alignment, responsive and accessibility specs, and unresolved design decisions.

Does plan design review work without a DESIGN.md file?

Yes, but it flags the missing design system as a gap and recommends running a design consultation first. Without DESIGN.md, the review proceeds using universal design principles instead of project-specific tokens and components.

When should I not use a plan design review?

Skip it when the plan has no UI scope, such as pure backend or infrastructure changes. The Skill detects this automatically and exits early rather than forcing a design review on non-visual work. For live site audits, use a visual design review instead.

How does the review handle deferred design decisions?

Each deferred decision is recorded in a NOT-in-scope section with rationale, and design debt items are proposed individually as TODOS.md entries with what, why, pros, cons, context, and dependencies. Unresolved questions are never silently defaulted.