Docs · skills/README.md

Design practice skills

Nine skills that carry a product engagement from a raw brief to a developer handoff. They encode one designer's method — Mikel Rosenthal, 23 years, five design systems built from scratch — so the output is the same shape whoever runs it.

Install

Copy the skills/ directory into your Claude project. Each subdirectory is one skill. Claude reads only the description line of each SKILL.md until a task matches, so the whole library costs almost nothing at rest.

Paste PROJECT-INSTRUCTIONS.md into the project's instructions so the house rules apply to everything, not only to skill invocations.

Start here

FileWhat it's for
DEMO.mdA ten-minute live demo runbook, with the exact prompts to type
PROJECT-INSTRUCTIONS.mdProject-level instructions carrying the five house rules
examples/Seven finished artifacts, so the templates aren't the only thing anyone sees

The order they run in

PhaseSkillProduces
Intakebrief-intakeThe structured project file
Evaluate (track A)ds-inventoryComponent inventory, token diff, drift report
Evaluate (track B)heuristic-auditSeverity-rated findings against a live product
Evaluateresearch-synthesisTen insights, each with a design implication
Mapflow-mapFlows plus the full state matrix
Designcopy-standardsErrors, empty states, labels in the product's voice
Designa11y-specFocus order, roles, contrast pairs per screen
DesigncritiqueAn argument against the work before the team sees it
Hand offhandoff-specThe developer package

Two entry points

Evaluating a design system is a counting exercise before it is a taste one — start with ds-inventory, on what actually ships.

A product overview is a people exercise — start with research-synthesis and heuristic-audit, because a perfectly consistent product can still be the wrong one.

brief-intake runs before either.

House rules every skill inherits

  1. Never invent a number. Every quantity traces to a named source, or it is cut.
  2. Say what you could not determine. An honest gap beats a confident guess.
  3. Attach a cost to every finding. Findings without a cost are trivia.
  4. Recommend, don't enumerate. One recommendation, its trade, and the rejected alternative.
  5. Output is a file, not a chat reply. Written artifacts are what survive the call.

The method, written down

Every page here is one file from the skill library. The folder is loadable as a Claude project as-is.