Skip to content

ericrisco/rsc-harness / skills/design

Use when designing, redesigning, restyling or reviewing a web page or app screen (landing, product site, portfolio, dashboard, docs) or when a UI looks generic or AI-made. Deals a researched direction, takes the idea from the subject, uses real pictures, proves it in a browser. NOT the words (landing-copy), NOT flows or usability (ux).

FileKindSize
IMPECCABLE-LICENSE.txtmarkdown10.5 KB
SKILL.mdskill md6.0 KB
THIRD_PARTY.mdmarkdown1.7 KB
engine/LICENSEother1.0 KB
engine/RUN.mdmarkdown36.6 KB
engine/UPSTREAM.jsonconfig416 B
engine/assets/app.cssother15.5 KB
engine/assets/base.cssother6.4 KB
engine/assets/base.jsscript2.1 KB
engine/assets/charts.jsscript57.3 KB
engine/assets/scenes/stage.cssother1.1 KB
engine/assets/scenes/stage.jsscript7.3 KB
engine/library/app.jsonconfig72.5 KB
engine/library/directions.jsonconfig60.0 KB
engine/library/heroes.jsonconfig105.7 KB
engine/library/motions.jsonconfig8.8 KB
engine/library/palettes.jsonconfig33.9 KB
engine/library/photos.jsonconfig156.9 KB
engine/library/sections.jsonconfig269.7 KB
engine/library/sites.jsonconfig848.7 KB
engine/library/type.jsonconfig80.4 KB
engine/references/app-screens.mdmarkdown83.4 KB
engine/references/colour.mdmarkdown6.7 KB
engine/references/copy.mdmarkdown9.2 KB
engine/references/critique.mdmarkdown10.9 KB
engine/references/imagery.mdmarkdown49.8 KB
engine/references/layout.mdmarkdown17.9 KB
engine/references/motion.mdmarkdown54.1 KB
engine/references/research.mdmarkdown23.7 KB
engine/references/scenes.mdmarkdown9.6 KB
engine/references/tells.mdmarkdown7.2 KB
engine/references/type.mdmarkdown8.3 KB
engine/scripts/assets.mjsscript63.0 KB
engine/scripts/draw.mjsscript52.9 KB
engine/scripts/inspect.mjsscript27.2 KB
engine/scripts/lib/app-draw.mjsscript14.4 KB
engine/scripts/lib/cdp.mjsscript11.6 KB
engine/scripts/lib/probe.mjsscript79.4 KB
engine/scripts/lib/rules.mjsscript36.4 KB
engine/scripts/lint.mjsscript11.5 KB
engine/scripts/scenes.mjsscript8.8 KB
evals/cases.yamlconfig3.0 KB
references/design-md.mdmarkdown1.9 KB
references/finish-review.mdmarkdown2.5 KB
references/modes.mdmarkdown2.7 KB
---
name: design
description: "Use when designing, redesigning, restyling or reviewing a web page or app screen (landing, product site, portfolio, dashboard, docs) or when a UI looks generic or AI-made. Deals a researched direction, takes the idea from the subject, uses real pictures, proves it in a browser. NOT the words (landing-copy), NOT flows or usability (ux)."
tags: [design, ui, ux, landing, dashboard, frontend, taste]
recommends: [landing-copy, ux, accessibility, brand-identity, nextjs]
profiles: [minimal, core, full]
origin: risco
---

# design

A model left to design picks the average of every page it has seen. This skill takes those
decisions away from the model and makes it look at what it built.

- **A script deals the direction.** You choose among researched directions; you never invent one.
- **The idea comes from the subject,** not from the category.
- **Real pictures and full content,** never empty space dressed as restraint.
- **A real browser measures the page** at three widths. A `FAIL` means it is not done.
- **You look at the screenshots,** fix the worst, and look again.

The engine is [taste-skill](https://github.com/Leonxlnx/taste-skill) (MIT), shipped unmodified in
`engine/`. The modes, the fresh review and the design record adapt
[impeccable](https://github.com/pbakaus/impeccable) by Paul Bakaus (Apache-2.0). Credits and what
changed: `THIRD_PARTY.md`.

## 0. Name the surface and its mode

Decide before anything else. The mode is chosen from the surface, not from the product.

| Mode | The visitor… | Surfaces | Run |
| --- | --- | --- | --- |
| **Persuade** | decides and acts | landing, marketing, product site, pricing, event, local business | `engine/RUN.md`, the page run |
| **Experience** | is inside the work | portfolio, gallery, showcase | `engine/RUN.md`, the page run |
| **Operate** | completes a task | dashboard, admin, settings, inbox, editor | `engine/references/app-screens.md` |
| **Read** | understands something | docs, guide, article, changelog | the page run, under the Read rules |

What each mode allows and refuses: [references/modes.md](references/modes.md).

## 1. Brand first, when there is one

Look for an existing identity before dealing anything: `02-DOCS/wiki/brand/`, a `DESIGN.md` in the
repo, or a coherent identity already in the code. If one exists, its colours and faces win: pass
`--keep palette,type` to the draw and take only the composition. If none exists, do not stop to
interview the user about brand; the draw is how a starting point is made.

## 2. Run the engine

Follow [`engine/RUN.md`](engine/RUN.md) step by step. Read it whole before starting. In its commands,
`<skill>` is this skill's `engine/` folder. Nothing in it is optional:

1. Brief and inventory (eight to twelve things only this client has).
2. The argument: one claim per section; no claim, no section.
3. Deal three directions with `draw.mjs`, choose one against the inventory, write why.
4. The idea sentence, the competitor test, and one live thing.
5. The whole copy deck before markup. Never invent proof: customers, quotes, numbers, logos.
6. Build still: tokens, hero, sections, at least four real pictures (`assets.mjs`), the live thing.
7. Gate: `lint.mjs`, then `inspect.mjs` at 1440, 768 and 390. Zero `FAIL`.
8. Look: open every screenshot, critique with `engine/references/critique.md`. At most three rounds.
9. Move: the motion layer, then inspect again.

For a single component or section inside an existing design, skip the draw, inherit the system,
and still run the gate.

## 3. Fresh review

The builder believes its own page. When the gate passes, hand the screenshots to a reviewer with no
history of this conversation (a fresh subagent where the harness has one). It returns one of four
words: `recapture`, `rebuild`, `fix` or `ship`. Act on the word. The packet and the checks:
[references/finish-review.md](references/finish-review.md).

## 4. Record the system

A new or replaced visual system is written to `DESIGN.md` at the project root, from what was built,
so later edits keep the look. Format: [references/design-md.md](references/design-md.md). Extending
an existing surface does not rewrite it.

## When the browser cannot run

`inspect.mjs` and `scenes.mjs` need Node 22+ and an installed Chrome, Edge or Chromium. Without them:
run `lint.mjs` (Node 18+), take screenshots with any browser tool you have, critique those, and
write in the report: **"inspector not run: <reason>"**. Never report a gate as passed that did not
run. Without network, draw the pictures and say the open collections could not be searched.

## Report

Say briefly: the surface and mode; the direction dealt (name and seed) and any redraw with its
reason; the idea sentence and the live thing; the inspector result per width, or that it did not
run; the reviewer's word; every found picture with its credit; sample content to replace before
launch. Do not claim a check you did not run.

## Hand-offs

- The words on a conversion page → `../landing-copy/SKILL.md`.
- Flows, screen states, navigation, forms and usability → `../ux/SKILL.md`.
- Component code and where state lives → `../react/SKILL.md`.
- WCAG conformance work → `../accessibility/SKILL.md`.
- A full brand system (logo, print colours, usage rules) → `../brand-identity/SKILL.md`.
- The App Router build → `../nextjs/SKILL.md`.
- A hero that is a pre-rendered camera flight in video, scrubbed by scroll → `../scroll-film/SKILL.md`.

## Files

| File | What |
| --- | --- |
| `engine/RUN.md` | The run, the house rules and the laws of the craft. |
| `engine/references/` | App screens, type, colour, layout, imagery, motion, scenes, copy, critique, tells, research. |
| `engine/scripts/` | `draw`, `assets`, `lint`, `inspect`, `scenes`. |
| `engine/library/` | The data the draw reads. Never read it whole; use the script. |
| `engine/UPSTREAM.json` | Which upstream versions are shipped here. |
| [references/modes.md](references/modes.md) | The four modes. |
| [references/finish-review.md](references/finish-review.md) | The fresh reviewer. |
| [references/design-md.md](references/design-md.md) | The `DESIGN.md` record. |
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall