plan-design-review

Reviews implementation plans for UI/UX design gaps and edits the plan to fix them.

Updated Mar 23, 2026
One-click install
npx skills add https://github.com/dhnpmp-tech/project-agent --skill plan-design-review-dhnpmp-tech
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-design-review
Source: https://github.com/dhnpmp-tech/project-agent/tree/main/.claude/skills/gstack/plan-design-review
Command: npx skills add https://github.com/dhnpmp-tech/project-agent --skill plan-design-review-dhnpmp-tech

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Implementation plans often describe backend logic in detail while leaving UI/UX decisions vague or missing entirely, leading to generic, inconsistent interfaces discovered only after code ships. This Skill reviews a plan before implementation, rates each design dimension 0-10, and edits the plan to close the gaps. ## Core Features & Use Cases - Dimension-by-dimension rating: Scores information architecture, interaction states, user journey, specificity, and other design dimensions 0-10, explaining what a 10 would look like and fixing the plan to get there. - Outside design voices: Optionally runs parallel critiques via Codex (hard-rejection rules and litmus checks) and an independent Claude subagent, then synthesizes a consensus scorecard. - Plan editing, not just commentary: Directly updates the plan file with missing empty states, error states, responsive behavior, and accessibility requirements. - Use Case: Before implementing a new dashboard page, run this review to catch that the plan never specified loading states, mobile navigation hierarchy, or empty-state copy — and have those decisions written into the plan. ## Quick Start Ask the AI to run /plan-design-review on the current plan to rate its design completeness and fill in missing UI/UX decisions before implementation.

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 UI/UX gaps before implementation?

Run /plan-design-review while in plan mode. It rates the plan's design completeness 0-10 across dimensions like information architecture and interaction states, explains what a 10 looks like, and edits the plan to add missing decisions.

What design dimensions does a plan design review cover?

It covers information hierarchy, interaction state coverage (loading, empty, error, success), user journey, specificity of UI descriptions, responsive behavior, accessibility, and AI-slop risk such as generic card grids.

Does plan-design-review work on backend-only plans?

No. It detects UI scope first, and if the plan involves no new screens, UI changes, or user-facing interactions, it reports that a design review is not applicable and exits early.

Can I get a second opinion from another AI model during design review?

Yes. The optional outside-voices step runs Codex with hard-rejection rules and litmus checks alongside an independent Claude subagent, then merges results into a consensus scorecard. Codex errors are non-blocking.

When should I use plan-design-review versus a live site design audit?

Use plan-design-review before implementation, while the design exists only as a plan. For auditing an already-built live site visually, the documentation directs you to the separate /design-review skill instead.