Skip to main content
skill CX Codex

design-screen — Claude Code skill for UI design and setup

The design-screen Claude Code skill plans and builds screens, websites, and interfaces from a request. It routes dense dashboards, redesigns, and screenshot-based work to more specific skills.

MIT ★ 3,216 updated 2026-11-10

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add plugin87/ux-ui-agent-skills
/plugin install ux-ui-agent-skills@ux-ui-agent-skills
Open on GitHub

What design-screen does

The skill takes a new interface from a brief to a build. The agent first records decisions about audience, mood, and layout, then chooses a visual direction and turns it into design tokens. After the build, it runs checks and critiques the result.

Checks require the complete UX/UI Agent Skills kit, including its design-system library, references, and gate scripts. Installing only the skill folder with npx [email protected] add leaves it in guidance-only mode: gates do not run and it returns no verdict. Dense dashboards, existing interfaces, and image-matching tasks go to other skills.

What it helps with

  • design a settings screen from scratch
  • build a landing page from a written request
  • choose a visual direction and interface tokens
  • run gate checks on a completed screen

Example prompts for the agent

  • Design a new settings page for my app.
  • Build a landing page for this service and choose its visual direction.
  • Create an onboarding screen for new users.

How to install design-screen

1Plugin marketplace

/plugin marketplace add plugin87/ux-ui-agent-skills
/plugin install ux-ui-agent-skills@ux-ui-agent-skills

This installs the whole ux-ui-agent-skills plugin with all its skills

2Skills CLI (Vercel)

npx skills add plugin87/ux-ui-agent-skills --skill design-screen -a claude-code

3Manually: put the files in place

~/.claude/skills/design-screen/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/design-screen/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about design-screen

How do I install design-screen in Claude Code?

Add the marketplace with /plugin marketplace add plugin87/ux-ui-agent-skills, then install the plugin with /plugin install ux-ui-agent-skills@ux-ui-agent-skills.

What does design-screen do?

It guides the creation of a new interface from initial design decisions through implementation, checks, and critique. It routes redesigns, dense dashboards, and image-matching tasks to other skills.

What does design-screen need to run?

Running checks requires the complete UX/UI Agent Skills kit, with its gate scripts, references, and design-system library. Installing just the skill folder with npx [email protected] add enables guidance only; gates do not run.

Source text

SKILL.md · MIT
---
name: design-screen
description: 'Design or build a page, screen, landing page, website, app or UI from a request - the whole job, end to end. Use this for "design a landing page", "build a settings screen", "make me a website", "design the onboarding", "ออกแบบหน้าเว็บ", "ทำหน้า landing", "ออกแบบ UI", "ทำแอป". It runs the pipeline no single skill covers: the house doctrine, a written Brief Inference so the result is not the statistical mean, a committed visual direction, tokens, build, the objective gates, then an adversarial critic. Hands off to data-dashboard for dense data screens, redesign for existing UI, and image-to-code when a reference image is given.'
---

# Skill: Design a screen

## Do this first, before anything else

**Write the Brief Inference block into your reply now.** Not after reading the
rest of this file, not in your head, not "once the layout is clearer" - now,
before any markup, any file, any tool call.

```
Domain:           fintech | editorial | dev-tool | healthcare | consumer | ...
Audience & tone:  expert vs first-time, calm vs energetic, premium vs utilitarian
Mood:             the one adjective the result must earn - "expensive", "precise", "warm", "brutal"
Motion depth:     none | subtle feedback | expressive choreography
Layout family:    the section sequence you will use, named, varied per section
Reference anchor: an archetype, or a named system - see step 3
```

Fill in every line with a decision. `Mood: clean` is not a decision; `Mood:
expensive` is. If you cannot name the mood and the layout family, you have not
decided anything yet and whatever you generate will regress to the mean.

**The stop condition:** if you are about to write markup, create a file, or call
a tool that produces UI, and this block is not already in your reply, stop and
write it first. Measured on 2026-10-07, one run in three skipped it - the skill
loaded, the block did not get written, and the result was a screen designed by
nobody. This section is at the top of the file because it was previously below
twenty-nine lines of background, and background is not an instruction.

Everything below is how to execute the decisions above.

---

## Requirements

This skill needs the full UX/UI Agent Skills kit: the gates, the references and
the design-system library. Install it with `npx [email protected] init`
or as the Claude Code plugin. `npx [email protected] add` copies the skill folder and
nothing else. Installed that way, this skill runs in **guidance-only mode**: no gate
runs, so it gives no verdict.

> **Step 0: is the kit here?** Check once:
> `ls ${CLAUDE_SKILL_DIR}/../../../tokens >/dev/null 2>&1 && echo KIT_OK || echo KIT_MISSING`
> On `KIT_MISSING`, open your reply with: "Guidance-only mode: the UX/UI Agent
> Skills kit is not installed here, so no gate ran and nothing below is
> measured." Then work from this file and general practice, under three rules.
> Do not guess or cite the contents of a kit file you could not open. State no
> measured number (no contrast ratio, no N/N, no "passes WCAG"): write "not
> verified" where one would go. End with a line `Skipped (kit not installed):`
> that names every gate script this file tells you to run, then the install
> command above.

## Hand off instead, when the work is actually

| The request | Use |
|---|---|
| A dashboard, terminal, console, or any screen whose job is many numbers at once | `data-dashboard` |
| An existing site or app to improve | `redesign` |
| A screenshot, mockup or reference image to match | `image-to-code` |
| One component's spec, not a screen | `design-component` |
| A brand foundation from scratch, before any screen | `brandkit` |

Otherwise, continue.

---

## 1. Taste preflight

The block at the top of this file. If it is not in your reply yet, go back and
write it before reading further - the rest of this skill executes decisions it
assumes you have already made.

Full version and the reasoning: `${CLAUDE_SKILL_DIR}/../../../taste/design-taste.md`.

### Banned defaults: break each one deliberately

These are the tells that make UI read as generated. They are defects, not
starting points.

- **Three or four identical equal-weight cards.** One thing leads: more size,
  more weight, or its own row. A grid of equals gives the eye nowhere to land.
- **Everything centered.** Use asymmetry and a real grid. Center sparingly.
- **The same left-text / right-image row repeated.** Vary composition per section.
- **Display type that is just bold body text.** The largest heading is at least
  2.5x the body size, short, on a wide measure (18-24ch).
- **Generic drop shadow on every box.** Most things are flat; elevation is layered
  and rare.
- **Pure `#000` on `#fff`.** Off-black on warm-white, from the theme.
- **A rainbow of accents.** One primary, one accent at most; neutrals carry it.
- **Emoji anywhere** - icons, bullets, status dots, labels. Use lucide inline SVG
  with `currentColor`, or plain words. This is a hard gate, not a preference.
- **Em-dashes in UI copy**, marketing filler ("elevate", "seamless", "unlock"),
  hollow triads ("powerful, intuitive, beautiful"), fake labels ("SECTION 01",
  lorem ipsum). Say the concrete thing or say nothing.
- **A colored border on one side only** of a card, alert, toast or callout. The
  tinted 3-4px strip is a generated-UI cliche. Full hairline border or surface
  separation, and status carried by a real icon plus text, never colour alone.
- **Cramped vertical rhythm.** Generous macro-whitespace between sections.

---

## 2. Doctrine

Load `design-doctrine` and follow it. The parts that decide this job: token by
intent, one shared theme, the eight states on every interactive element, one
thing leads, zero emoji, and never state a number you did not measure.

## 3. Direction into tokens

Pick the reference anchor from
`${CLAUDE_SKILL_DIR}/../../../taste/aesthetic-systems.md` or a named system
(`node ${CLAUDE_SKILL_DIR}/../../../scripts/library.mjs get <name>` fetches its
spec and prints where it is), then resolve it into
tokens rather than styling screens directly. One CSS-variable layer, imported
once. If a brand colour fails contrast, adjust it: taste serves tier 4 and never
overrides accessibility.

Reference output to match for quality:
`${CLAUDE_SKILL_DIR}/../../../examples/showcase/` and
`${CLAUDE_SKILL_DIR}/../../../examples/templates/`.

## 4. Build

**Mobile is the base**, not an afterthought: write the phone layout as the base
styles and layer wider screens on with `min-width`. `max-width` is fine for a
narrow refinement, never as the way mobile gets supported. Every value a token. Every interactive element ships all eight
states. Content first, then the layout that serves it.

## 5. Gate: run it, never claim it

```bash
node ${CLAUDE_SKILL_DIR}/../../../scripts/accuracy_report.mjs
```

Report the real `N/N` line. For a single file, at minimum:

```bash
node ${CLAUDE_SKILL_DIR}/../../../scripts/gate.mjs verify_states.mjs <file> [--dark]
node ${CLAUDE_SKILL_DIR}/../../../scripts/gate.mjs verify_responsive.mjs <file> --scale=1.25
DS_REQUIRE_BROWSER=1 node ${CLAUDE_SKILL_DIR}/../../../scripts/slop_tells.mjs --strict <file>
DS_REQUIRE_BROWSER=1 node ${CLAUDE_SKILL_DIR}/../../../scripts/taste_audit.mjs --strict <file>
```

A render gate with no browser prints SKIPPED and exits 0. That is not a pass.
Set `DS_REQUIRE_BROWSER=1` when you run one on its own and intend to trust it.

## 6. Render and look

Gates pass while a screen is still visibly broken. Screenshot it, look at every
state, and click each control to confirm something actually changed.

## 7. Critic

Run `/critique`. It is adversarial on purpose and it sees the work, not your
reasoning. A passing gate is never evidence of taste.

---

## What you deliver

The Brief Inference block, the files, the real gate output, and the critic's
verdict. If a gate was not run, say which and why - an unmeasured result is
reported as unmeasured, never as a pass.

© Thientan Soparat · MIT · plugin87/ux-ui-agent-skills

Similar skills

All skills for Design →

From the same set35

The whole set →
critique The critique Claude Code skill challenges a finished interface and finds grounds to reject it. Run it after the project gates pass. CX Codex +1 ★ 3,216repo stars design-critic design-critic — a subagent for Claude Code reviews rendered UI screens as an adversarial design director looking for reasons to reject the build. Runs after automated test gates pass. CX Codex ★ 3,216repo stars grill-me The grill-me Claude Code skill asks about a project before implementation and records unanswered decisions as assumptions. Run it before building an interface. CX Codex +1 ★ 3,216repo stars tokens-and-color tokens-and-color is a Claude Code rule for creating, extending, or auditing tokens and choosing interface colors. It defines token layers and contrast requirements. CX Codex +1 ★ 3,216repo stars design-doctrine design-doctrine is a Claude Code skill that enforces UI rules and runs verification gates. It runs before writing markup, reviewing components, or editing design tokens. CX Codex +1 ★ 3,216repo stars data-dashboard The data-dashboard Claude Code skill shapes dense dashboards with charts and tables. It activates for analytics consoles, trading terminals, and monitoring views. CX Codex +1 ★ 3,216repo stars components components loads when you design, specify, or review a component. Covers atomic design, composition, and spacing decisions—details that slip past code gates but show up in the rendered interface. CX Codex +1 ★ 3,216repo stars ux-ui-agent-skills The ux-ui-agent-skills plugin for Claude Code adds design tokens, specs, and 52 quality gates to test UI output against WCAG 2.2. ★ 3,216repo stars

Project sponsors

Companies that keep this analytics open