Ui craft minimal
Skill educlopez/ui-craft/cli/assets/codex/skills/ui-craft-minimal
Design engineering system for AI coding agents — ship UI with craft-level quality. Install as an agent skill.
npx -y skills add educlopez/ui-craft --skill ui-craft-minimalAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
What its author says it does
Copied from the file, not written here
Minimal / clean / Linear / Notion / Vercel / whitespace-heavy UIs. Locked knobs: CRAFT=8, MOTION=3, DENSITY=2. Monochrome + one accent, Inter/Geist, hairline borders over shadows. Trigger on: minimal, clean, Linear-like, Notion-like, Vercel-like, whitespace-heavy.
SKILL.md
4.7 KB, ~1.2k tokens by cl100k_base, as published. Nobody here has run it
UI Craft — Minimal
Pre-committed minimal style: editorial clean, Linear / Notion / Vercel. Whitespace is the composition. One accent, hairline borders, almost no motion.
Knobs (locked)
- CRAFT_LEVEL = 8 — minimal aesthetics only work when executed precisely; Polish Pass is mandatory.
- MOTION_INTENSITY = 3 — hover + modal enter/exit only. No scroll reveals, no page transitions, no stagger.
- VISUAL_DENSITY = 2 — whitespace-heavy, 1-2 items per row, generous gutters.
Do not re-ask these in Discovery. Skip straight to accent + font confirmation if ambiguous.
Style anchors
- Black or near-black type on white or near-white canvas. Monochrome + ONE accent.
- Inter / Geist for body — never a display font.
- Section padding 120-200px vertical, 40-80px gutters.
- Hairline borders
1px solid oklch(92% 0.005 250)in place of shadows. - Typography is the hierarchy. No decorative gradients, patterns, or glass.
- Single-column hero default. Asymmetry via one supporting element, not layout tricks.
- Motion is punctuation, not spectacle.
- Every pixel deliberate. When in doubt, cut it.
Base rules (inherited)
All rules in ../ui-craft/SKILL.md apply. This file overrides knob defaults and adds style-specific guidance below. The anti-slop and craft tests still apply in full.
Style-specific overrides
Typography
- Body: Inter or Geist, 400 weight. UI emphasis: 500. Never 600/700 in body copy.
system-ui, -apple-systemas fallback stack.- Headings:
tracking-tight/-0.02emabove 24px, 500 or 600 max. text-wrap: balanceon headings,text-wrap: prettyon paragraphs.- No display serifs. No geometric display sans. No mixing two sans families.
Color
- Surface:
oklch(99% 0 0)(light) /oklch(14% 0.005 250)(dark). - Text:
oklch(18% 0.01 250)primary,oklch(46% 0.01 250)secondary. - Accent reserved for: primary CTA, active nav item, one key metric. That is it.
- Borders:
oklch(92% 0.005 250)light /oklch(24% 0.008 250)dark. No colored borders.
Spacing & layout
- Section vertical:
py-24 md:py-32 lg:py-40(96 / 128 / 160px) minimum; 200px for hero on large screens. - Container:
max-w-5xltypical;max-w-3xlfor reading content. - One accent placement per viewport preferred; two max.
- No card grids with more than 2 columns on desktop.
Borders & elevation
- Default chrome = 1px hairline border, no shadow.
- Elevation only for floating UI (menus, toasts, modals) — single soft ambient shadow, not layered.
- Radius: 6px inputs, 8px cards, 12px modals. Keep the scale narrow.
Motion
- Allowed: hover (opacity / border color, 120-150ms), modal + dialog enter/exit (180-220ms ease-out), focus ring.
- Forbidden at this intensity: scroll-triggered reveals, stagger, page transitions, parallax, magnetic cursor, entrance choreography.
- Any animation must honor
prefers-reduced-motion.
Composition
- Hero: left-aligned or centered headline, ONE supporting element (social proof line, screenshot, single chip). No floating badges, orbs, blobs.
- Features: stacked rows with a single real visual each. No 3-up uniform icon grids even when tempting.
- Nav: text-only links, current state = accent underline or weight 500. No pill backgrounds.
Reference files to read first
Keep the reading list tight. Load only these from ../ui-craft/references/:
layout.md— spacing, hierarchy, compositiontypography.md— scale, readability, weightcolor.md— monochrome scales, OKLCH, dark modeaccessibility.md— focus, contrast, keyboard
Skip dashboard.md, stack.md, sound.md unless explicitly relevant.
Anti-patterns for THIS style
- Multiple accent colors. One accent, period.
- Display serifs, geometric display sans, or mixing two sans families.
- Decorative gradients, mesh backgrounds, noise overlays, glass panels.
- Scroll-triggered reveals, stagger, page transitions — even "subtle" ones.
- Uniform 3-column icon-heading-text feature grids.
- Colored shadows or glows as affordances.
- Dense layouts. If density feels right, this is the wrong variant — switch to
ui-craft-dense-dashboard. - Pill backgrounds on nav links or buttons by default; prefer text + underline.
- Section padding under 96px on desktop.
Gives 0 of the 12 instructions most design frontend skills give in ~1.2k tokens
Counted across 1,169 of the 1,878 authors here whose files we hold, read 2026-08-07
- use css variables for color consistencyin 72 of 1169, across 23 files
- commit to one bold aesthetic direction before codingin 72 of 1169, across 27 files
- match implementation complexity to the aesthetic visionin 70 of 1169, across 20 files
- add atmospheric background effects and texturesin 57 of 1169, across 9 files
- use unexpected spatial compositions and layoutsin 56 of 1169, across 8 files
- implement real working codein 55 of 1169, across 7 files
- vary themes and aesthetics across different designsin 48 of 1169, across 7 files
- launch chromium in headless modein 47 of 1169, across 4 files
- close the browser when donein 47 of 1169, across 4 files
- run provided scripts with help flag firstin 47 of 1169, across 4 files
- wait for network idle statein 47 of 1169, across 4 files
- use descriptive selectors for elementsin 47 of 1169, across 4 files
Said here and by no other author read
- use Inter or Geist for body
- use hairline borders instead of shadows
- keep section padding above 96px
- limit desktop grids to two columns
- reserve accent for primary CTA, active nav, or one metric
- use single soft ambient shadow for floating UI only
Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.