plan-design-review

Reviews implementation plans for UI/UX gaps and generates visual mockups before coding.

107|7|Updated Mar 29, 2026
One-click install
npx skills add https://github.com/no-session/pstack --skill plan-design-review-no-session
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-design-review
Source: https://github.com/no-session/pstack/tree/main/plan-design-review
Command: npx skills add https://github.com/no-session/pstack --skill plan-design-review-no-session

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Plans often describe backend logic in detail while leaving design decisions vague, which leads to generic AI-looking interfaces and missing states discovered only after code is written. This Skill reviews a plan with a designer's eye, rates its design completeness, and fixes gaps before implementation starts. ## Core Features & Use Cases - Design completeness rating: Scores the plan 0-10 across seven design dimensions, explains what a 10 looks like, and rewrites weak sections of the plan. - Visual mockup generation: Uses the pstack designer binary to generate real PNG mockups, style variants, and comparison boards from the plan's design brief, with a cross-model vision quality check. - Edge case and AI-slop detection: Flags missing empty states, error states, responsive behavior, accessibility specs, and generic generated-looking layouts. - Use Case: Before building a new settings page, run this Skill on the plan to get mockup variants, a rated critique of the interaction design, and an updated plan with concrete typography, spacing, and state coverage. ## Quick Start Ask the AI to run /plan-design-review on your current plan to rate its design completeness and generate visual mockups 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's UI design before writing code?

Run /plan-design-review on the plan file. It rates design completeness 0-10, generates visual mockups from the plan's brief, and edits the plan to add missing states, hierarchy, and interaction details before implementation begins.

What is the difference between plan-design-review and design-review?

plan-design-review evaluates a written plan before any code exists and outputs an improved plan. design-review audits a live, running site visually. Use the plan version during planning and the live version after shipping.

Does plan-design-review work without the pstack designer binary?

Yes. If the DESIGN_READY check fails, it falls back to HTML wireframe sketches instead of generated PNG mockups. Mockups are a progressive enhancement, not a hard requirement for the review.

When should I skip a design review of a plan?

Skip it when the plan has zero UI scope, such as pure backend, API-only, or infrastructure changes. The Skill detects this automatically and exits early rather than forcing a design review on non-visual work.

Where are the generated design mockups saved?

All mockups, comparison boards, and approval files are saved to ~/.pstack/projects/<slug>/designs/, never inside the project repository. Design artifacts are treated as user data that persists across branches and sessions.