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

references/modes.md

View on GitHub
# The four modes

Adapted from impeccable by Paul Bakaus (Apache-2.0); rewritten and shortened. The mode names what
the visitor's success looks like on this surface. Pick it from the surface, never the product: a
developer tool's landing page is Persuade, a fashion house's docs are Read.

## Persuade

The visitor decides and acts. The design is what they judge.

- The first screen makes the offer clear and shows **the action visitors came to take, working**: a
  flight search, open appointment slots, add to cart. A button that points somewhere else is not it.
- The subject's world carries the page; it is never painted over it as a poster with no working parts.
- Refuse both ends: the poster, and the stock product page (headline, subline, button, a row of
  equal cards; or the split hero with a badge row under it).

## Experience

The visitor is inside the work: portfolio, gallery, showcase. The work leads from the first
viewport and the interface recedes. Same page run as Persuade.

## Operate

The visitor completes a task. Someone who uses tools like this should know where everything is
before they notice the style.

- The direction lends four things only: **type, palette, density and one signature move** (service
  health drawn as a transit map, a schedule in a timetable's column rhythm). Never the layout, the
  navigation model or the controls.
- Every control is the standard one the visitor already knows. No costume of a terminal, an
  instrument bezel or ledger paper.
- Colour does real jobs: a committed shell, state colours, data series, selection. A grey screen
  with one accent is the category default without its polish.
- Realistic data with units and one state worth seeing (an alert, a degraded service, an empty
  filter). Never grey placeholder bars.
- The bar is the cleanest product in its category; the signature move adds to that, never replaces it.

The run, rules and checks for these screens: `../engine/references/app-screens.md`
(`draw.mjs --app`, `inspect.mjs --app`).

## Read

The visitor understands something: docs, guide, article, changelog.

- The style owns **the frame**: masthead, rail, ground, title and section openers, how code and
  tables are set. That is where palette, type and the signature move commit fully.
- The reading column stays calm: a reading face, real contrast, about 60–75 characters at about
  16px. No monospace prose. Nothing performs behind the text.
- The style never supplies the reading order or replaces the navigation with something to learn.
- Check: can a reader tell where they are, where to go next, and read comfortably? Cover the name:
  could this be any other product's docs? Then the frame has not taken the style yet.
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