Critique UI and UX for usability, accessibility, and distinctiveness with cited, evidence-based findings.

MITAuto-check passedFrontend & Design

Install Design Review

skills CLI
$ npx skills add TheDecipherist/claude-code-mastery-project-starter-kit --skill design-review -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install TheDecipherist/claude-code-mastery-project-starter-kit design-review --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/TheDecipherist/claude-code-mastery-project-starter-kit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/design-review .claude/skills/design-review && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
design-review
GitHub stars
338
Token cost
~712 tokens
SKILL.md length
316 words
Files
1
Skills in repo
24
Repo updated
First seen
Licence
MIT

At a glance

Critique UI and UX for usability, accessibility, and distinctiveness with cited, evidence-based findings.

  • Reviewing a screen
  • SKILL.md covers Stance, Accessibility (pass/fail, not…, Hierarchy and scannability and Consistency, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Asked for feedback on layout

What it does

Design Review is an agent skill from TheDecipherist/claude-code-mastery-project-starter-kit. Critique UI and UX for usability, accessibility, and distinctiveness with cited, evidence-based findings. Use when reviewing a screen, component, mockup, CSS or markup, or design tokens, or when asked for feedback on layout, typography, color, contrast, or user experience. Runs isolated and read-only, reports findings, does not edit.

Its SKILL.md is about 710 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Frontend & Design, covering UX design, Design review and critique and Accessibility. The repository describes itself as: The definitive starting point for Claude Code projects. Based on Claude Code Mastery Guides V1-V5. The licence is MIT.

When your agent uses it

  • Reviewing a screen
  • Asked for feedback on layout
  • User experience

Example prompts

  • “/design-review”

Requirements

  • Pre-approved tools (allowed-tools): Read, Grep, Glob, WebFetch

What it can do on your machine

Read from SKILL.md and the folder at commit 61fbb99. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Grep
    • Glob
    • WebFetch

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Design Review loads about 712 tokens when it runs. Until then it costs about 87 tokens; SKILL.md has 316 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~87
When it runs · the whole SKILL.md, loaded when a task matches
~712

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from TheDecipherist/claude-code-mastery-project-starter-kit at commit 61fbb99, republished under its MIT licence (© TheDecipherist). 316 words, ~712 tokens.

Download SKILL.mdSave it as .claude/skills/design-review/SKILL.md (or your agent's skills folder).
name
design-review
description
Critique UI and UX for usability, accessibility, and distinctiveness with cited, evidence-based findings. Use when reviewing a screen, component, mockup, CSS or markup, or design tokens, or when asked for feedback on layout, typography, color, contrast, or user experience. Runs isolated and read-only, reports findings, does not edit.
allowed-tools
Read, Grep, Glob, WebFetch
when_to_use
- User shares a UI, component, CSS/HTML, or mockup and wants feedback - User asks about layout, type, color, contrast, accessibility, or "does this look…
context
fork

Design Review

You critique interfaces like a senior designer who respects the user's time. Opinionated, evidence-based, specific. You report. You do not edit.

Stance

  • Cite, don't assert. Any claim about user behavior ("users scan the left first," "this fails contrast") points to a source or a measurable standard. If you can't source it, say so and mark it as opinion. Verify a figure before stating it. Never invent a statistic.
  • Distinctive over default. Fight templated "AI slop": the purple gradient, Inter everywhere, a card for everything, centered everything, the same SaaS landing page as every other site. Generic isn't safe, it's forgettable. Push for choices that have a reason behind them.
  • Usability over trend. When a fashionable pattern hurts the user (low-contrast text, unlabeled icons, scroll-jacking, motion that can't be stopped), name the cost.

Accessibility (pass/fail, not opinion)

  • Contrast meets WCAG AA: 4.5:1 for body text, 3:1 for large text. Flag anything under.
  • Every interactive element has a visible focus state.
  • Icon-only buttons have an accessible label; form inputs have real <label>s, not just placeholders.
  • Motion respects a reduced-motion preference.
  • Nothing conveys meaning by color alone.

Hierarchy and scannability

  • The most important thing on the screen is the most prominent. If everything is emphasized, nothing is.
  • Front-load what matters. People scan far more than they read; structure for the scan, not the close read.
  • Group related elements, separate unrelated ones. Spacing is information.

Consistency

  • Reuse existing components and tokens before inventing new ones. Flag a one-off that duplicates something the system already has.
  • Color, spacing, and type come from defined tokens, not hardcoded values scattered in markup.

Output

Every finding in this shape:

[🔴 BLOCKER | 🟡 ISSUE | 🔵 SUGGESTION] location — one line Problem: what's wrong and who it hurts. Fix: the concrete change. Basis: the standard or the sourced research, or "opinion" if it's a judgment call.

Close with the single highest-impact change and whether the surface is ship-ready.

© TheDecipherist, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/design-review of TheDecipherist/claude-code-mastery-project-starter-kit.

Open the folder on GitHubat commit 61fbb99

Compare with similar skills

Design Review next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Design Review compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Design Review this skillTheDecipherist/claude-code-mastery-project-starter-kit338—~712Automated safety check: PassMIT
Frontend Designjwynia/agent-skills170—~3.2kAutomated safety check: PassMIT
Design Standardsrampstackco/claude-skills945—~2.4kAutomated safety check: PassMIT
Replica DesignJakeschincariol/replica-skill1.4k—~994Automated safety check: PassMIT
iOS Design GuidelinesMacMagazine/app-iOS170—~767Automated safety check: PassNone
Interface KitJuliusBrussee/skills1621 repos~5.3kAutomated safety check: PassMIT

Similar skills

  • Frontend Design

    jwynia/agent-skills

    Create distinctive, production-grade frontend interfaces with high design quality.

    170 GitHub stars~3.2k tokensUpdated 7 mo ago
    Frontend & DesignAuto-check passed
  • Design Standards

    rampstackco/claude-skills

    Apply production-grade design standards when building or reviewing pages, components, or UI.

    945 GitHub stars~2.4k tokensUpdated 3 days ago
    Frontend & DesignAuto-check passed
  • Replica Design

    Jakeschincariol/replica-skill

    Rebuilds an app's design system for a clone: colour roles, type scale, spacing, radius, shadows and every component with its states, as design tokens plus component specs, with original assets…

    1.4k GitHub stars~994 tokensUpdated 7 days ago
    Frontend & DesignAuto-check passed
  • iOS Design Guidelines

    MacMagazine/app-iOS

    MacMagazine design reference — theme tokens, card selection, typography, touch targets, accessibility, dark mode.

    170 GitHub stars~767 tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Interface Kit

    JuliusBrussee/skills

    Authoritative guide for implementing stunning, accessible, performant UI.

    162 GitHub starsUsed in 1 repo~5.3k tokens
    Frontend & DesignAuto-check passed
  • Ijfw Design

    FerroxLabs/ijfw

    A skill your agent uses when the user says: 'design', 'redesign', 'UI', 'UX', 'dashboard', 'page', 'component', 'make it look better', 'polish', 'pretty', 'professional', 'user experience'…

    212 GitHub stars~2.2k tokensUpdated 5 days ago
    Frontend & DesignAuto-check passed

More from TheDecipherist/claude-code-mastery-project-starter-kit

All 24 skills in this repo
  • Create Service

    TheDecipherist/claude-code-mastery-project-starter-kit

    Scaffold a new microservice that follows the project's server/handlers/adapters architecture.

    338 GitHub stars~1.8k tokensUpdated 3 mo ago
    Auto-check: notes
  • CSS Structure

    TheDecipherist/claude-code-mastery-project-starter-kit

    Where CSS should live. An agent skill from TheDecipherist/claude-code-mastery-project-starter-kit.

    338 GitHub stars~1k tokensUpdated 3 mo ago
    Auto-check passed
  • Docker

    TheDecipherist/claude-code-mastery-project-starter-kit

    Production Docker best practices for writing Dockerfiles, Compose files, and Swarm stacks.

    338 GitHub stars~1.6k tokensUpdated 3 mo ago
    Auto-check: notes
  • Docker Swarm

    TheDecipherist/claude-code-mastery-project-starter-kit

    Production Docker Swarm deployment rules: what changes when a compose file goes from a single node to a multi-node Swarm.

    338 GitHub stars~1.8k tokensUpdated 3 mo ago
    Auto-check passed
  • Mongodb Backups

    TheDecipherist/claude-code-mastery-project-starter-kit

    Production MongoDB backup and restore practices that the documentation gets wrong.

    338 GitHub stars~1.3k tokensUpdated 3 mo ago
    Auto-check passed
  • Mongodb Replica Sets

    TheDecipherist/claude-code-mastery-project-starter-kit

    Production MongoDB replica-set operation: topology, durability, host tuning, and the container-specific gotchas Claude gets wrong.

    338 GitHub stars~1.6k tokensUpdated 3 mo ago
    Auto-check passed

Questions about Design Review

What does Design Review do?

Critique UI and UX for usability, accessibility, and distinctiveness with cited, evidence-based findings. Design Review is an agent skill from TheDecipherist/claude-code-mastery-project-starter-kit. Critique UI and UX for usability, accessibility, and distinctiveness with cited, evidence-based findings.

When should I use Design Review?

Design Review fits situations like: reviewing a screen; asked for feedback on layout; user experience.

How do I install Design Review in Claude Code?

Run `npx skills add TheDecipherist/claude-code-mastery-project-starter-kit --skill design-review -a claude-code`. Or copy the skill folder (.claude/skills/design-review in TheDecipherist/claude-code-mastery-project-starter-kit) into .claude/skills/design-review in your project. Claude Code loads it when a task matches its description.

How do I install Design Review in Codex?

Run `npx skills add TheDecipherist/claude-code-mastery-project-starter-kit --skill design-review -a codex`. Or copy the skill folder (.claude/skills/design-review in TheDecipherist/claude-code-mastery-project-starter-kit) into .agents/skills/design-review in your project. Codex loads it when a task matches its description.

Can I use Design Review in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add TheDecipherist/claude-code-mastery-project-starter-kit --skill design-review -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/design-review, .gemini/skills/design-review, .github/skills/design-review and .opencode/skills/design-review in your project.

What does Design Review need to run?

SKILL.md names no scripts, command-line tools or credentials: Design Review is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Grep, Glob, WebFetch.

Does Design Review access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Design Review safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Design Review use?

Design Review is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Design Review use?

About 712 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Design Review?

Skills that share tags, products or a category with Design Review: Frontend Design (jwynia/agent-skills, 170 stars), Design Standards (rampstackco/claude-skills, 945 stars), Replica Design (Jakeschincariol/replica-skill, 1.4k stars) and iOS Design Guidelines (MacMagazine/app-iOS, 170 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Design Review?

TheDecipherist (a GitHub user) maintains it in TheDecipherist/claude-code-mastery-project-starter-kit, which has 338 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on June 29, 2026.

Source: TheDecipherist/claude-code-mastery-project-starter-kit on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.