mcpField
P
plan-design-review

plan-design-review

github.com/podoDesign & UI29225 installsUpdated 4d ago
Repository

About plan-design-review

plan-design-review is a gstack skill for reviewing a design plan before implementation. It scores completeness and examines seven areas, helping teams identify gaps, discuss decisions, and update the plan before code is written.

Key features

  1. 01Design completeness score
  2. 02Seven-pass plan review
  3. 03Gap discussion and plan updates
  4. 04Optional visual mockups
  5. 05Optional independent design opinions

Use cases

  1. 01Review a product plan before coding
  2. 02Identify missing interaction states
  3. 03Discuss accessibility and responsive gaps
  4. 04Create optional mockups for a plan

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/podo/design-agent-skills --skill plan-design-review

After installing, type/plan-design-reviewin Claude Code to confirm it loaded.

Bundled filesstub.yaml

Details

From the project README

plan-design-review

Catalogue stub — part of garrytan/gstack (plan-design-review)

Decision tree

  1. Is the full skill already installed?

    • f=~/.claude/skills/gstack/plan-design-review/SKILL.md; [ -e "$f" ] && ! grep -qs "^das:" "$f" && echo "installed" || echo "pointer"
    • installed → invoke it and proceed
    • pointer → go to step 2

  2. Install (the skills CLI cannot install this one):

    This skill is part of gstack and calls gstack's shared tooling (~/.claude/skills/gstack/bin/…), so install gstack itself rather than the single skill (--skill plan-design-review fails because the CLI only sees gstack's root router; the subpath form npx skills add garrytan/gstack/plan-design-review installs the instructions without the tooling). ./setup needs Bun, builds binaries, downloads Chromium and registers a Stop hook in your Claude settings (opt out with ./setup --no-timeline-stop-hook); ask the user before running it. Upstream's README also tells agents to add a gstack section to CLAUDE.md after setup.

    git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack
cd ~/.claude/skills/gstack && ./setup

Heads-up

  • Requires: Bun (setup refuses versions older than 1.3.3; upstream tests 1.4.2+), Git and Claude Code; Optional: the gstack design binary plus an OpenAI API key for mockups; Codex CLI for outside design voices
  • License: MIT
  • Download size: ~98 MB.

Invoke after install

  • Skill name: plan-design-review
  • Trigger phrases: "plan design review", "design plan review", "review ux plan", "check design decisions", "AI slop detection"

What it does

A designer's-eye review of a plan, not of a live site: the agent rates the plan's overall design completeness on a 0-10 scale, explains what a 10 would look like, then works through seven passes (information architecture, interaction states, user journey and emotional arc, AI-slop risk, design-system alignment, responsive and accessibility, unresolved decisions), asking you about each gap and adding the decisions you accept to the plan before any code is written. It can optionally render visual mockups (needs gstack's design binary and an OpenAI API key) and ask outside voices for an independent design opinion.

gstack behaviour to know about, per its README: outside reviews are on by default and send the review prompt and the relevant plan or code to a second model provider (Codex, under your own login; turn off with gstack-config set codex_reviews disabled); an update check against GitHub runs by default; usage telemetry is opt-in and asked once.

When NOT to use

  • Reviewing or fixing a live, running UI — use design-review-garrytan
  • Building a design system from scratch — use design-consultation
  • When you do not want to install gstack's tooling (Bun, binaries, Chromium, a Stop hook)

Comments

Markdown supported