Skip to content

Anti-AI-slop design skill for Claude Code, Cursor, and Codex.

CSS

Theme specs for the 16 spec-less catalog themes

Youssef123599dd1c76
diff --git a/skills/hallmark/references/themes/almanac.md b/skills/hallmark/references/themes/almanac.md
new file mode 100644
index 0000000..2523d63
--- /dev/null
+++ b/skills/hallmark/references/themes/almanac.md
@@ -0,0 +1,145 @@
+# Theme - Almanac
+
+Editorial-reference register. The page for a **data yearbook, a field guide, a reference manual, a technical handbook, an index or catalogue of entries** - the almanac / whole-catalog school, executed in **cool bond-grey, not white**, with **tables and figures as the hero**. A cool paper ground (`oklch(94% 0.008 245)`), ruler-drawn hairlines, tabular figures that line up to the decimal, and one **deep bookish ink-blue** that never gets loud. It reads like a trusted reference: dense, indexed, exact.
+
+Loaded eagerly by SKILL.md Step 3 when the catalog pick is `almanac`. Tokens: [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="almanac"]`.
+
+## Axes (diversification)
+
+- **Paper band** - light **cool** (`L 94%`, hue 245, chroma 0.008). A grey *bond paper*, a full notch darker than an engineered near-white - distinct from Cobalt's `98.5%` and from Newsprint's warm `92%`.
+- **Display style** - **grotesk-sans**, Hanken Grotesk `600`, tight tracking `-0.014em`. A workmanlike Swiss grotesk, not a serif and not geometric-Geist.
+- **Accent hue** - **deep ink-blue** (`oklch(38% 0.135 250)`) - dark and quiet, a library-stamp blue. Explicitly *not* Cobalt's electric `L58`; Almanac's signal is bookish, never live.
+
+## Reference register
+
+Works in Progress · Our World in Data · Stripe Press · Low-Tech Magazine · Whole Earth Catalog · The Pudding · Baymard · Poor Richard's Almanack. The aesthetic: the reference yearbook and the data almanac - a cool indexed canvas, hairline tables, tabular figures, a sticky side-rail of contents, mono entry-numbers. **Never name any of these in the output.**
+
+**Patron-saint reference (internal):** *an old farmer's almanac reset in a Swiss grid* - its tables kept honest by hairlines and tabular figures, its entries numbered in mono. When in doubt ask "does this read like a trusted reference, or like a brochure?" Keep the former.
+
+## Required dependencies
+
+1. **Fonts** - **Hanken Grotesk** (display + body, 400/500/600), **Newsreader** (serif, running entries + body emphasis, optical-sizing), **IBM Plex Mono** (entry numbers, units, table headers, UPPERCASE labels). Google Fonts:
+ ```html
+ <link href="https://fonts.googleapis.com/css2?family=Hanken+Grotesk:wght@400;500;600;700&family=Newsreader:ital,opsz,wght@0,6..72,400;0,6..72,500;1,6..72,400&family=IBM+Plex+Mono:wght@400;500;600&display=swap" rel="stylesheet" />
+ ```
+2. **A reveal + number-tick script** - one `IntersectionObserver` adding `.is-in` (fade + ~8px rise, ease-out, `0.85×` speed - functional, not showy). Plus **number-tick counters** that count `0 → final` for stats, dates, prices on first reveal, then hold.
+3. **A sticky side-rail with scroll-spy** - the left index (N3) stays pinned; the active section highlights as you scroll. `role="navigation"`, keyboard-reachable, reduced-motion safe.
+
+## Signature moves
+
+1. **Cool bond paper, never `#fff`** - `oklch(94% 0.008 245)`, with `paper-2` (`91%`) for alternating table rows and `paper-3` (`86%`) for the side-rail well and callout blocks. Ink is cool near-black `oklch(16% 0.020 245)`, never `#000`; muted meta sits at `oklch(46% 0.014 245)`.
+
+2. **Tables and figures are the hero** - the almanac *is* its data. Hairline-ruled tables with `font-variant-numeric: tabular-nums`, right-aligned numerics, decimals that line up, units in mono. Lead with a data block, an index, or a spec table - never a photograph.
+
+3. **Two rule weights, used deliberately** - light hairline `--color-rule` (`oklch(74% 0.012 240)`) draws the grid and row separators; the dark `--color-rule-2` (`oklch(38% 0.018 240)`) draws the one emphatic line under a section head or table `thead`. **No boxed cards, no shadows.** Depth is rules, not blur.
+
+4. **Three-column encyclopedia density** - reference chunks in a three-column-equal grid, scannable, each entry numbered. Dense by design, not airy. This is the almanac's body posture; a single luxe hero column is wrong here.
+
+5. **Sticky side-rail index (N3)** - a pinned left rail listing sections/entries with mono numbers, active item in the ink-blue accent. The page is navigated like a book's contents, not scrolled like a brochure. **Not a floating pill, not a masthead.**
+
+6. **Mono entry-numbers and labels** - IBM Plex Mono, UPPERCASE, `0.06em` tracking (`--tracking-label`) for eyebrows, entry numbers (`§ 01`, `No. 214`), units, dates, table headers. The machine-readout voice against the Hanken Grotesk display.
+
+7. **Newsreader for the running entry** - the one serif carries long-form entry prose and pull-ledes at the `64ch` measure, italic reserved for in-paragraph emphasis only (never a heading). Grotesk sets structure; serif sets reading.
+
+8. **One deep ink-blue, sparingly** (< 5% of any viewport) - `oklch(38% 0.135 250)` on links, the active rail item, one figure or the single primary control. Dark and quiet; everything else is ink-on-bond-grey. The accent is a stamp, not a flood.
+
+## Motion
+
+Functional and sparse, like turning a reference page. Section reveals fade + rise at `0.85×` ease-out; number-tick counters run once to their final value on reveal, then hold; the side-rail active item shifts as sections cross. **No bounce, no parallax, no autoplay, no marquee.** Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static, counters at final value, fully visible.
+
+## Anti-patterns
+
+- **No electric blue.** Almanac's accent is dark bookish `L38`; the live `L58` cobalt is a sibling's lane.
+- **No pure `#fff` / `#000`.** Cool bond-grey paper, cool near-black ink.
+- **No warm paper.** Warm grey is Newsprint's; Almanac is cool (hue 240-250).
+- **No boxed cards, no drop-shadows, no glassmorphism.** Hairline tables and two rule weights carry every surface.
+- **No photographic or image-led hero** - data, tables, or an index lead; images are small, outlined, inline to the measure.
+- **No single luxe centered hero column** (that is Atelier/Garden) - Almanac is dense, three-column, left-biased.
+- **No justified newspaper columns** - that is Newsprint's broadsheet; Almanac is an encyclopedia grid, ragged-right.
+- **No pill / gradient CTA.** One quiet ink-blue control or a typographic link; name the destination.
+
+## Macrostructure affinity / rejection
+
+**Almanac loves.**
+
+- **Long Document** - a reference manual or guide: prose, tables, a running index.
+- **Catalogue** - the almanac as an indexed run of numbered entries.
+- **Stat-Led** - a data yearbook: tabular figures, number-tick, sourced tables.
+- **index-first** - a contents-led page navigated by the side-rail.
+- **Specimen** - a dense data/spec specimen with hairline spec tables.
+
+**Almanac refuses.**
+
+- **Marquee Hero** - too kinetic; Almanac opens on an index or a table, not a sweep.
+- **Photographic** - image-led; Almanac leads with data and type.
+- **Manifesto** - too loud; Almanac is neutral, trusted reference.
+- **Letter** - too intimate; Almanac is a reference, not a note.
+
+## Voice fixtures
+
+Declarative, dated, exact. Cite the figure, the edition, the source.
+
+- *"Everything worth knowing about the harvest, indexed."*
+- *"Edition 2026. 214 entries, cross-referenced."*
+- *"Sunrise 6:12. Sunset 20:41. First frost by the 14th."*
+- *"Figures updated quarterly. Sources at the foot of each table."*
+- *"Look it up once. Trust it after."*
+
+Never any of: *seamless, revolutionary, magical, effortless, game-changing, cutting-edge, supercharge, unlock*. Never "click here." Cite the entry, the unit, the number.
+
+## How Almanac differs from neighbouring themes
+
+| vs | difference |
+|---|---|
+| **Newsprint** (editorial, light, dense) | Newsprint is warm `92%` paper + roman-serif display (Playfair) + brick accent + justified broadsheet columns + a masthead. Almanac is cool `94%` bond + grotesk display (Hanken) + ink-blue + a ragged three-column encyclopedia grid + a side-rail. Broadsheet vs reference book settles it. |
+| **Cobalt** (modern-minimal, cool, blue) | Same cool + blue + mono labels, but Cobalt is `98.5%` engineered near-white + **electric** `L58` cobalt + Space Grotesk + code-as-hero + a dark graphite band + ⌘K. Almanac is greyer bond + **deep** `L38` bookish blue + a Newsreader serif + tables-as-hero + a side-rail. Reference book vs dev-tool. |
+| **Garden** (editorial, light) | Garden is warm `95.5%` + roman-serif (Young Serif) + leaf-green + marginalia + generous negative space + calm springs. Almanac is cool + grotesk + ink-blue + dense three-column + functional `0.85×` motion. Botanical calm vs data density. |
+
+## Test brief expectations
+
+Almanac should be a candidate when the brief mentions:
+
+- *almanac · yearbook · field guide · reference · handbook · manual · index · catalogue · encyclopedia · data · figures · tables · statistics · research · dataset · records · directory · glossary · compendium · specifications*
+- Product categories: *data / research site · reference manual · field guide · knowledge base · directory · public dataset · technical handbook · editorial data journalism*
+- Emotional tone: *exact · indexed · trusted · dense · scholarly · matter-of-fact · reference-grade · cool*
+
+Briefs that are warm / broadsheet / image-led / atmospheric route elsewhere (Newsprint for the newspaper, Garden for the warm serif, the atmospheric themes for mood). When the brief is a **reference full of data** and wants to *show the tables*, it is Almanac.
+
+## Build hint
+
+```css
+html, body { overflow-x: clip; }
+body { background: var(--color-paper); color: var(--color-ink);
+ font-family: var(--font-body); font-weight: 400; }
+
+/* Two rule weights: hairline grid + one emphatic head rule */
+.rule { border-top: 1px solid var(--color-rule); }
+.head-rule { border-bottom: 2px solid var(--color-rule-2); }
+
+/* Tables are the hero - tabular, right-aligned, hairline-ruled */
+table { border-collapse: collapse; font-variant-numeric: tabular-nums; }
+thead th { border-bottom: 2px solid var(--color-rule-2);
+ font: 500 var(--text-sm)/1 var(--font-mono);
+ text-transform: uppercase; letter-spacing: var(--tracking-label); }
+td.num { text-align: right; font-variant-numeric: tabular-nums; }
+tbody tr:nth-child(even) { background: var(--color-paper-2); }
+
+/* Mono labels + entry numbers */
+.label { font: 500 var(--text-xs)/1 var(--font-mono);
+ text-transform: uppercase; letter-spacing: var(--tracking-label);
+ color: var(--color-muted); }
+
+/* Newsreader for the running entry; deep ink-blue as the one signal */
+.entry { font-family: var(--font-serif); max-width: var(--measure); }
+a, .rail__item[aria-current] { color: var(--color-accent); }
+
+/* Functional reveal - 0.85x, no showmanship */
+.reveal { opacity: 0; transform: translateY(8px);
+ transition: opacity .5s ease-out, transform .5s ease-out; }
+.reveal.is-in { opacity: 1; transform: none; }
+@media (prefers-reduced-motion: reduce) {
+ .reveal { opacity: 1; transform: none; transition: none; }
+}
+```
+
+Plus the Hanken Grotesk + Newsreader + IBM Plex Mono link and the reveal / number-tick / scroll-spy script.
diff --git a/skills/hallmark/references/themes/atelier.md b/skills/hallmark/references/themes/atelier.md
new file mode 100644
index 0000000..2eab29b
--- /dev/null
+++ b/skills/hallmark/references/themes/atelier.md
@@ -0,0 +1,130 @@
+# Theme - Atelier
+
+The considered-object page: a fashion house, a fragrance, a gallery or exhibition, a furniture / ceramics / architecture studio, a made-in-small-numbers brand story. The Aesop / couture-masthead / gallery-placard school, rendered in **warm plaster and umber** - not cream, not grey. A near-neutral plaster ground (`oklch(94% 0.005 60)`), one **fat high-contrast Didone masthead** (Playfair Display 900, optical 144), grotesk captions, wide-tracked mono placards, and a single amber ember for the only warm signal. It reads hand-set and unhurried: an object *presented*, never sold.
+
+Loaded eagerly by SKILL.md Step 3 whenever the catalog pick is `atelier`. The OKLCH palette + font stack live in [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="atelier"]`.
+
+## Axes (diversification)
+
+- **Paper band** - light (94%). Plaster near-neutral: `oklch(94% 0.005 60)`, steps to `oklch(91% 0.006 60)` and `oklch(87% 0.008 55)`. Warm hue 60 held at almost-zero chroma - unbleached linen, distinct from Garden's oat (chroma 0.022) and Newsprint's tan (0.045).
+- **Display style** - high-contrast serif (Playfair). Playfair Display at weight **900**, optical size **144**, tracking `-0.018em` - a fatface Didone (hair-thin serifs against fat verticals). Not Specimen's light Fraunces (340), not a thin Vogue-hairline cut.
+- **Accent hue** - warm umber (~40 deg, low chroma). The `--color-accent` is nearly ink-dark umber `oklch(22% 0.060 40)`; the one *visible* signal is `--color-accent-ink` / `--color-focus` = amber `oklch(45% 0.13 60)`.
+
+## Reference register
+
+Aesop · a couture / fashion-house masthead · gallery + museum exhibition pages · Kinfolk / Cereal editorial · Studio Nicholson, The Row, Toteme · Frama, Byredo, Le Labo · an architecture-studio portfolio.
+
+The aesthetic: the object presented under a dramatic serif crown with a spec-sheet caption - warm plaster canvas, hairline structure, one amber ember, imagery treated like a gallery print. **Never name any of these in the output.**
+
+**Patron-saint reference (internal):** *Aesop's product-as-object restraint* + *a couture magazine masthead*, recoloured plaster-and-umber. When in doubt ask "does this read like a gallery placard, or like a product ad?" Keep the former.
+
+## Required dependencies
+
+1. **Fonts** - **Playfair Display** (display, 900, optical axis), **Hanken Grotesk** (body, 400/500/600), **IBM Plex Mono** (labels/meta, UPPERCASE). Google Fonts:
+ ```html
+ <link href="https://fonts.googleapis.com/css2?family=Playfair+Display:opsz,[email protected],400..900&family=Hanken+Grotesk:wght@400;500;600;700&family=IBM+Plex+Mono:wght@400;500;600&display=swap" rel="stylesheet" />
+ ```
+2. **A small reveal script** - one `IntersectionObserver` adding `.is-in` (fade + ~10px rise, ease-out ~600ms). Optionally a one-shot masked curtain-wipe (clip-path) on the masthead, then static.
+
+## Signature moves
+
+1. **Plaster paper, warm near-neutral, never white.** `--color-paper: oklch(94% 0.005 60)`, surfaces to `91%` / `87%`. Ink is warm near-black umber `--color-ink: oklch(12% 0.024 40)`; body sits at `--color-neutral: oklch(28% 0.014 45)`. The whole page reads unbleached-linen warm - not grey, not cream, never `#fff`.
+
+2. **The Didone masthead is the hero.** Playfair Display at weight `var(--display-weight)` = 900, `font-variation-settings: "opsz" 144`, tracking `-0.018em`, clamped to `6.25rem` via `--text-display`. One large fatface line, set LEFT or broadsheet-centred, carries the page's entire gravity. Nothing competes with it.
+
+3. **Monochrome-umber, amber only as a whisper.** `--color-accent: oklch(22% 0.060 40)` is nearly ink-dark - use it as a fill/ink block or a heavy rule, **not** a bright pop. The single warm signal is amber `oklch(45% 0.13 60)` (`--color-accent-ink` / `--color-focus`): a link underline, a focus ring, a drop-cap, one `<mark>`. Keep it under 4% of any viewport - the page is warm-monochrome with one ember.
+
+4. **Wide-tracked mono placards.** Eyebrows, section numbers, captions, spec meta in IBM Plex Mono (`--font-label`), UPPERCASE, tracking `0.24em` (`--tracking-label`). The machine-precise gallery-placard voice under the couture Didone - material, dimensions, year, edition.
+
+5. **Grotesk body under the serif crown.** Hanken Grotesk 400/500 body at `--lh-normal: 1.55` / `--lh-relaxed: 1.7`, `--measure: 56ch`. The triad - fat Didone display + neutral grotesk body + wide mono labels - **is** Atelier. Never set running body in the serif (that move belongs to Newsprint).
+
+6. **Hairlines, generous air, asymmetric columns.** 1px `--color-rule: oklch(78% 0.006 55)` for fine rules, `--color-rule-2: oklch(56% 0.008 50)` for a section divider or double-rule. No boxed cards, no drop-shadows, no glass. `--section-gap: 6.5rem`, `--page-max: 64rem`. Depth comes from rules + whitespace only.
+
+7. **The object presented, not sold.** Compose like a lookbook or exhibition index: a named object, a drop-cap opening, a numbered index, imagery treated as a gallery print (generous margin, hairline frame). CTAs are text-underline or a hairline-outline at a small (2-4px) radius - never a filled amber blob.
+
+## Motion
+
+Quiet and orchestrated. One entrance: the masthead's masked curtain-wipe (or a plain fade), section reveals fade + rise, an amber underline-grow on link hover. **No bounce, no parallax, no autoplay, no marquee.** Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static + fully visible.
+
+## Anti-patterns
+
+- **No bright saturated pop.** The umber accent is near-ink; amber is a whisper. No orange (Specimen), no oxblood red (Newsprint), no green (Garden / Studio).
+- **No serif running body.** Body is Hanken Grotesk. Playfair in paragraphs reads broadsheet - that is Newsprint, wrong theme.
+- **No warm-tan or cream newspaper stock.** Atelier's paper is near-neutral plaster (chroma 0.005), not oat (0.022) or tan (0.045).
+- **No thin / hairline Didone masthead.** Atelier's Playfair is FAT (900). A light cut collides with Specimen's Fraunces 340 and reads generic-luxury.
+- **No boxed cards, drop-shadows, or glassmorphism.** Hairlines + air carry every surface.
+- **No filled-pill or gradient CTA.** Underline or hairline-outline at small radius. Name the object / the collection.
+- **No pure `#fff` / `#000`, no centred three-icon-tile feature grid, no background texture or pattern.**
+
+## Macrostructure affinity / rejection
+
+**Loves:** **Specimen** (the Didone as its own subject) · **Photographic** (lookbook / gallery imagery, object-led) · **Catalogue** (a numbered index of objects or works) · **Letter** (intimate, hand-set; Ft6 letter close) · **Long Document** (a considered magazine feature or essay).
+
+**Refuses:** **Bento Grid** (modular tiles fight the broadsheet restraint) · **Stat-Led** (big-number KPI dashboards are enterprise, not gallery) · **Workbench / component-playground** (instrument-panel dev-tool shape is Cobalt's) · **Marquee Hero** (kinetic scroll is too loud for one quiet curtain).
+
+## Voice fixtures
+
+Hand-set, literary, object-precise, couture-calm. Verbs over adjectives; name the object.
+
+- *"Made in small numbers, by hand, in Lisbon."*
+- *"One coat. Twelve hours. A finish that keeps."*
+- *"The 04 chair, in oiled ash."*
+- *"We compose a scent the way a printer composes a page."*
+- *"Nothing added that the object did not ask for."*
+
+Never: *seamless, elevate, curated, bespoke, luxury, effortless, game-changing, must-have.* Never "shop now" / "buy now" - say "See the collection" or name the piece.
+
+## How Atelier differs from neighbouring themes
+
+| vs | what settles it instantly |
+|---|---|
+| **Newsprint** (shares Playfair Display) | Newsprint is Playfair **700** + Crimson Pro **serif body** + warm-tan stock (`oklch(92% 0.045 50)`) + oxblood accent - a broadsheet. Atelier is Playfair **900** fatface + **grotesk body** (Hanken) + near-neutral plaster + amber whisper. Body face + paper warmth settle it. |
+| **Specimen** (serif-display sibling) | Specimen is **light** Fraunces (340) + bright **orange** (`#FC4C02`) on warm paper - a type showcase. Atelier is **fat** Playfair (900) + warm-monochrome umber. Display weight + accent hue settle it. |
+| **Garden** (same 94% paper band) | Garden is Young Serif + oat cream + living **leaf-green**, botanical and organic. Atelier is a high-contrast Didone on near-neutral plaster with **no green** - gallery, not garden. |
+
+## Test brief expectations
+
+Atelier is a candidate when the brief mentions:
+
+- *fashion · atelier · couture · fragrance / perfume · gallery · exhibition · museum · ceramics · furniture · homeware · architecture studio · design studio · lookbook · collection · made by hand · craft · small-batch · editorial feature · brand story*
+- Product categories: *fashion / apparel brand · fragrance house · gallery or museum · furniture / homeware · architecture or interior studio · design-studio portfolio · considered B2C brand story*
+- Emotional tone: *refined · hand-set · warm-monochrome · gallery-quiet · considered · understated · unhurried*
+
+Briefs that are developer / enterprise / dashboard route elsewhere (Cobalt, Almanac); loud-maximalist editorial routes to Carnival; broadsheet news routes to Newsprint.
+
+## Build hint
+
+The first lines of CSS establish Atelier's anchor moves:
+
+```css
+html, body { overflow-x: clip; }
+body { background: var(--color-paper); color: var(--color-neutral);
+ font-family: var(--font-body); font-weight: 400; line-height: var(--lh-normal); }
+
+/* The fatface Didone masthead - the page's whole gravity */
+.masthead { font-family: var(--font-display); font-weight: var(--display-weight);
+ font-variation-settings: "opsz" var(--display-optical);
+ font-size: var(--text-display); letter-spacing: var(--tracking-display);
+ line-height: var(--lh-tight); color: var(--color-ink); }
+
+/* Wide-tracked mono placard */
+.placard { font: 500 0.75rem/1 var(--font-label); text-transform: uppercase;
+ letter-spacing: var(--tracking-label); color: var(--color-muted); }
+
+/* Hairlines + the one amber ember */
+.rule { border: 0; border-top: 1px solid var(--color-rule); }
+a { color: inherit; text-decoration-color: var(--color-accent-ink); }
+:focus-visible { outline: 2px solid var(--color-focus); outline-offset: 2px; }
+
+/* Reveal - the whole motion engine */
+.reveal { opacity: 0; transform: translateY(10px);
+ transition: opacity .6s cubic-bezier(0.16,1,0.3,1),
+ transform .6s cubic-bezier(0.16,1,0.3,1); }
+.reveal.is-in { opacity: 1; transform: none; }
+
+@media (prefers-reduced-motion: reduce) {
+ .reveal { opacity: 1; transform: none; transition: none; }
+}
+```
+
+Plus the Playfair Display + Hanken Grotesk + IBM Plex Mono link and the small reveal script.
diff --git a/skills/hallmark/references/themes/aurora.md b/skills/hallmark/references/themes/aurora.md
new file mode 100644
index 0000000..8d696fa
--- /dev/null
+++ b/skills/hallmark/references/themes/aurora.md
@@ -0,0 +1,128 @@
+# Theme - Aurora
+
+Atmospheric, after-dark register. The page for a **dev tool, an AI or generative product, a model playground, a rendering pipeline you open at night** - but rendered in **cold blue-green light, not the genre's warm firelight**. A near-black cyan-tilted canvas (`oklch(11% 0.025 200)`), cool near-white ink, one cyan signal, and - the identity move - **two overlapping cool blooms curtaining the ground like the northern lights**. Weighty Geist display for confidence; a **Sentient serif body** to keep the cold canvas from reading clinical. It should feel like the moment after a deploy goes green.
+
+Loaded eagerly by SKILL.md Step 3 when the catalog pick is `aurora`. Tokens: [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="aurora"]`. No canonical build yet; mirror the moves below.
+
+> **Why the bloom, not the glow.** Midnight is the cluster's one *diffuse azure glow*; Aurora is the one *paired bloom curtain*. The genre licenses up to two blooms - Aurora is the theme that spends the whole budget: cyan + teal-green, overlapping, so the ground reads as an aurora, not a single light. That two-hue cold curtain plus a serif body is the differentiator, not a recolour.
+
+## Axes (diversification)
+
+- **Paper band** - **near-black, cyan-tilted** (`oklch(11% 0.025 200)`). The *deepest* ground in the cluster (Midnight 15%, Lumen Night 13%). Elevation climbs to `paper-2` `oklch(15% 0.028 200)` and `paper-3` `oklch(18% 0.030 200)`. The 0.025 chroma at hue 200 is load-bearing: cold blue-green, never `#000`.
+- **Display style** - **geometric-sans, weighty** (Geist `--display-weight: 600`, tracking `-0.035em`, up to `5.75rem`). Confident and heavy - the opposite of Midnight's airy thin 300.
+- **Accent hue** - **cyan** (`oklch(72% 0.170 200)`) with a **teal-green** secondary (`oklch(64% 0.150 175)`). Both cold; hue 200 sits ~50deg green of Midnight's azure 250 and 65deg of Lumen's violet 265. Cyan is the UI signal; teal-green lives in the second bloom.
+
+## Reference register
+
+Linear (dark) · Vercel after-dark · Raycast · Resend dark · Railway · Supabase dark · Planetscale · northern-lights dev landings.
+
+The aesthetic: the cool-dark product page where the canvas glows blue-green behind confident sans display, one cyan signal, serif reading voice. Hand-built, moody, cold but not clinical.
+
+**Patron-saint reference (internal):** *Linear's dark restraint* + *the northern lights over a cold coast* + *the calm right after a green deploy*. Ask "does this feel like blue-green light on a night sky, or a warm-lit room?" Keep the former. Never name any of these in the output.
+
+## Required dependencies
+
+1. **Fonts** - **Geist** (display 600, plus 400/500), **Sentient** (body + serif accent, 400/500, Fontshare), **Geist Mono** (labels):
+ ```html
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+ <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=Geist+Mono:wght@400;500&display=swap" rel="stylesheet" />
+ <link href="https://api.fontshare.com/v2/css?f[]=sentient@400,500&display=swap" rel="stylesheet" />
+ ```
+2. **A reveal script** - one `IntersectionObserver` adding `.is-in` (fade + ~10px rise, ease-out ~600ms). Fade is the whole motion budget; the blooms are static.
+
+## Signature moves
+
+1. **Two cool blooms - the aurora itself.** Fixed-attached radial gradients: **cyan** (hue 200) top-right + **teal-green** (`--color-accent-2`, hue 175) bottom-left, each ~25-30% footprint, low chroma, overlapping toward the centre so the ground curtains. No animation. This paired cold curtain is the theme; one lonely glow is Midnight, not Aurora.
+2. **Deepest near-black cyan ground, never black** - `--color-paper: oklch(11% 0.025 200)`. Ink is cool near-white `--color-ink: oklch(96% 0.010 200)`; body sits at `--color-ink-2: oklch(82% 0.012 200)`. The cyan tilt runs through every neutral.
+3. **Sentient serif body - the cluster's one serif reading voice.** `--font-body`/`--font-serif` = Sentient (soft-contrast variable serif) for lede and running text. It warms the cold canvas; Midnight and Terminal are all-sans, so the serif is instantly Aurora. **Roman only** (italic in headers is a global AI tell, banned).
+4. **Weighty Geist display** - `--display-weight: 600`, `--tracking-display: -0.035em`, `--text-display: clamp(3rem, 6vw + 1rem, 5.75rem)`. Heavy sans confidence against the serif body. Never the thin 300 that owns Midnight.
+5. **One cyan signal, used sparingly** (< 5% of any viewport) - `--color-accent: oklch(72% 0.170 200)` on the eyebrow tick, a link hover, the one primary button, focus rings, a status chip, an active nav item. Buttons fill cyan with `--color-accent-ink` (= paper) text. Everything else is ink-on-dark. Teal-green stays in the bloom, never a second UI flood.
+6. **Elevated dark surfaces + faint hairlines.** Cards ride `paper-2`/`paper-3`, seamed by 1px `--color-rule: oklch(28% 0.022 200)` (or `rule-2` for a brighter edge). Genre glow-lift on hover (soft cyan shadow, `translateY(-4px)`) - no drop-shadow theatre.
+7. **Wide-tracked mono eyebrows** - `--font-label` (Geist Mono), UPPERCASE, `--tracking-label: 0.10em`. The machine-readout voice between the heavy Geist display and the calm Sentient prose.
+8. **Centred, breathing hero** - genre gate 6 loosened; `--section-gap: 6.5rem`. The bloom field frames the type; let the void carry it.
+
+## Motion
+
+Fade only, composed and slow. Section reveals fade + rise once. Hover: cyan underline-grow on links, a 1px border shift to `--color-accent` and a soft cyan glow-lift on cards. No slide, no bounce, no parallax, no autoplay - the blooms are fixed and never animate. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static and fully visible.
+
+## Anti-patterns
+
+- **No warm accent** (amber, orange, terracotta, gold) - that is Bloom and Lumen-Night. Aurora is cyan + teal-green, hue 200/175.
+- **No single azure glow at hue 250** - that is Midnight. Aurora is *two* blooms and greener (hue 200).
+- **No all-sans body** - the body is Sentient serif; never set running text to Geist. The serif is the theme's warmth.
+- **No thin display** - Geist 600, not Midnight's 300.
+- **No pure black / `#111`** - the ground is cyan-tilted `11% 0.025 200`.
+- **No italic anywhere, no gradient text, no glassmorphism** (global gates). Sentient runs roman.
+- **No built apparatus or leader-line diagram** - that focal grammar is Lumen. Aurora's canvas treatment is ambient blooms, not a machined object.
+- **No rainbow aurora** - the curtain is two cold hues (cyan + teal-green) only, never a full spectrum.
+
+## Macrostructure affinity / rejection
+
+**Aurora loves:** Marquee Hero (one heavy Geist hero over the bloom field, canonical) · Manifesto (the cold canvas argues a statement) · Stat-Led (cyan numerics glowing on near-black) · Feature-stack (capabilities on layered dark surfaces) · Quote-Led (the Sentient serif carries a pulled line).
+
+**Aurora refuses:** Bento Grid (tile collage fights the diffuse curtain) · Catalogue (too commercial and busy for the calm dark) · Workbench (clinical, tool-first - route Cobalt) · Conversational FAQ (too casual for the after-dark register).
+
+## Voice fixtures
+
+Cool, after-dark, dev-fluent, warmed by the serif. Name the thing plainly.
+
+- *"Ship after dark."*
+- *"The moment after the deploy goes green."*
+- *"Cool by default. Warm where it reads."*
+- *"Built for the late shift."*
+- *"Green across the board, coast to coast."*
+
+Never any of: *seamless, cutting-edge, revolutionary, supercharge, unlock, leverage, synergy, robust*. Never italics. Never "click here"; name the command or the number.
+
+## How Aurora differs from neighbouring themes
+
+| vs | what settles it instantly |
+|---|---|
+| **Midnight** (cool-dark sibling) | Midnight is one diffuse azure glow (hue 250), all-Geist sans, thin 300, restrained. Aurora is **two** cyan + teal-green blooms (hue 200/175), a **Sentient serif body**, heavy Geist 600. Paired-cold-curtain-with-serif vs single-glow-all-sans. |
+| **Lumen** (atmospheric) | Lumen is warm brass-on-violet with a *built apparatus* + Instrument Serif *display* + blueprint grid. Aurora is cool cyan *ambient blooms* + Geist sans display + Sentient body. Machined-artefact vs atmospheric-curtain; warm vs cold. |
+| **Bloom** (atmospheric, canonical light) | Bloom is warm cream light paper, expressive consumer copy. Aurora is near-black cyan dark, dev-after-dark copy. Warm-light vs cold-dark settles it at a glance. |
+
+## Test brief expectations
+
+Aurora is a candidate when the brief mentions:
+
+- *dev tool · AI tool · generative · model playground · render · pipeline · observability · deploy · ship · dark mode · after-hours · late-night · nocturnal · moody · cool · aurora · northern lights · blue-green · cold-clarity*
+- Product categories: *AI creative tool · generative model UI · dev tool with a moody register · data / observability console · cool nocturnal SaaS*
+- Emotional tone: *cool · after-dark · atmospheric · calm-confident · cold-but-not-clinical · post-deploy*
+
+Warm / consumer / editorial / light briefs route elsewhere (Bloom or Lumen-Night for warm atmospheric, Cobalt for a light code tool). When the brief wants dark, cold, and a glowing canvas, it is Aurora.
+
+## Build hint
+
+```css
+html, body { overflow-x: clip; }
+body { background: var(--color-paper); color: var(--color-ink-2);
+ font-family: var(--font-body); font-weight: 400; }
+
+/* The two cool blooms - the whole canvas treatment, fixed and static */
+body::before { content: ""; position: fixed; inset: 0; z-index: -1; pointer-events: none;
+ background:
+ radial-gradient(38% 32% at 82% 12%, oklch(72% 0.17 200 / 0.20), transparent 70%),
+ radial-gradient(40% 34% at 12% 92%, oklch(64% 0.15 175 / 0.16), transparent 72%); }
+
+/* Weighty Geist display + wide-tracked mono eyebrow */
+.display { font-family: var(--font-display); font-weight: var(--display-weight);
+ letter-spacing: var(--tracking-display); font-size: var(--text-display); }
+.eyebrow { font-family: var(--font-label); text-transform: uppercase;
+ letter-spacing: var(--tracking-label); color: var(--color-accent); }
+
+/* The one cyan signal */
+.btn--primary { background: var(--color-accent); color: var(--color-accent-ink);
+ border-radius: 999px; }
+a:hover { color: var(--color-accent); }
+
+/* Reveal - fade only */
+.reveal { opacity: 0; transform: translateY(10px);
+ transition: opacity .6s ease, transform .6s ease; }
+.reveal.is-in { opacity: 1; transform: none; }
+@media (prefers-reduced-motion: reduce) {
+ .reveal { opacity: 1; transform: none; transition: none; }
+}
+```
+
+Plus the Geist + Geist Mono + Sentient link and the small reveal script.
diff --git a/skills/hallmark/references/themes/bloom.md b/skills/hallmark/references/themes/bloom.md
new file mode 100644
index 0000000..07c2e97
--- /dev/null
+++ b/skills/hallmark/references/themes/bloom.md
@@ -0,0 +1,136 @@
+# Theme - Bloom
+
+The **light-paper** atmospheric theme: a generative AI-creative tool (music, video, image, voice) rendered in **warm daylight** instead of the usual nocturnal dark. A calm warm off-white ground (`oklch(97% 0.010 72)`), a soft terracotta bloom that reads like dawn light through a studio window, Geist geometric-sans display, Instrument Serif as a warm counterpoint, Geist Mono machine labels. It reads like a sunlit studio: inviting, expressive, made-not-manufactured. The daytime, optimistic face of the genre - Suno / Runway warmth pulled into the light.
+
+Loaded eagerly by SKILL.md Step 3 when the catalog pick is `bloom`. Tokens: [`site/css/tokens.css`](../../../../site/css/tokens.css) `[data-theme="bloom"]`. No canonical build yet - mirror the atmospheric genre defaults.
+
+## Axes (diversification)
+
+- **Paper band** - light warm off-white (`L 97%`, hue 72, very low chroma `0.010`). `oklch(97% 0.010 72)`. The documented light-paper exception in a mostly-dark genre; distinct from every dark atmospheric ground and from Cobalt's cool near-white.
+- **Display style** - **geometric-sans** (Geist `600`, `--tracking-display: -0.022em`, roman). Plain-English and confident. Distinct from serif themes and from Cobalt's grotesk.
+- **Accent hue** - **restrained terracotta-coral** (`oklch(56% 0.13 35)`) with a soft warm companion (`oklch(64% 0.09 55)`) used only in the bloom tint. Warm ~35 deg; sits clear of Lumen's brass (~50) and any cool blue.
+
+## Reference register
+
+Suno . Udio . Runway . Luma . Pika . Krea . Ideogram . Playground . Kittl . consumer-facing generative-creative studios. The aesthetic: a warm, sunlit creative canvas where the generated output is the hero, plain-English expressive display, one warm accent on small surfaces. **Never name any of these in the output.**
+
+**Patron-saint reference (internal):** *dawn light falling across a fresh studio canvas* - the atmospheric bloom recoloured from midnight to morning. When in doubt ask "does this feel like a studio at 9am, or a nightclub at midnight?" Keep the former.
+
+## Required dependencies
+
+1. **Fonts** - **Geist** (display + body, `400/500/600`), **Instrument Serif** (roman counterpoint only), **Geist Mono** (labels + meta). Google Fonts:
+ ```html
+ <link rel="preconnect" href="https://fonts.googleapis.com" />
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+ <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600&family=Instrument+Serif&family=Geist+Mono:wght@400;500&display=swap" rel="stylesheet" />
+ ```
+2. **A small reveal script** - one `IntersectionObserver` adding `.is-in` (fade only, optional <=8px rise, reveal-once/unobserve). Reduced-motion ships static + fully visible.
+3. **Optional one-shot type-in** of a single prompt line in the hero demo, then static. No looping.
+
+## Signature moves
+
+1. **Warm bloom on warm light paper** - the name move. Paper is `--color-paper` `oklch(97% 0.010 72)`, never `#fff`. One or two **fixed, un-animated** radial blooms sit behind the content: `--color-accent` (terracotta 35 deg) at ~8-10% alpha and `--color-accent-2` (55 deg) at ~6-8%, each ~25-40% footprint. It reads like sunlight on paper - Bloom **emits warm light from a light ground**, the genre's documented light-paper exception.
+
+2. **Geist geometric-sans display, plain and confident** - `--font-display` at `--display-weight: 600`, `--tracking-display: -0.022em`, `--lh-tight: 1.06`, sized to `--text-display` (clamp to `5.75rem`). Roman, never italic. Expressive plain-English headline. A **near-centred hero is allowed** here (genre loosens the left-bias gate); the bloom frames the type.
+
+3. **Warm near-black ink, never `#000`** - `--color-ink` `oklch(20% 0.022 40)` for headlines, `--color-ink-2` `oklch(30% 0.022 46)` for body, `--color-muted` `oklch(50% 0.018 58)` for meta. Every neutral carries a warm cast (hue 40-72). The whole page is warm-tinted, top to bottom.
+
+4. **Instrument Serif as a warm counterpoint (roman only)** - `--font-serif` appears as **one** serif gesture: a lede sentence, a pull-quote, or a large numeral. Roman always, never in the H1, never italic in any heading. This dual voice (geometric sans + one serif line) separates Bloom from all-Geist dark siblings without turning editorial.
+
+5. **Geist Mono machine-readout labels** - `--font-label` UPPERCASE, `--tracking-label: 0.12em`, for eyebrows, tags, model names, prompt chips, meta. The dry technical voice set against the warm expressive display.
+
+6. **Pill CTA with a warm terracotta glow** - genre allows accent-fill pills. The one primary button fills `--color-accent` `oklch(56% 0.13 35)` with `--color-accent-ink` `oklch(98% 0.010 72)` text; hover adds a soft warm glow shadow (accent at low alpha) - the atmospheric lift. Accent stays a **signal** (< ~8% of any viewport); it is "used sparingly" per the token.
+
+7. **Elevated warm surfaces, not hairlines** - atmospheric depth. Cards use `--color-paper-2` / `--color-paper-3` over a soft warm shadow with a `--color-rule` hairline; on hover they lift toward the reader with a warm glow. Depth comes from warm elevation, never from cool blur or glass.
+
+8. **The generated output is the specimen** - the focal artefact is a hand-built CSS/SVG output card sitting in the bloom: a warm-lit prompt bar, a generated frame strip, a waveform, an image tile. It names the tool's verb (make, hum, compose, render) and shows the result, warmly lit - not a stock photo, not a glowing orb.
+
+## Motion
+
+Fade-in only; the atmosphere does the work. Section reveals fade (optional <=8px rise), reveal-once. The bloom is **static and fixed** - never animated, never a drifting blob. Hover adds a warm glow on the CTA and a lift on cards. Optional one-shot prompt type-in, then static. No slide, no bounce, no parallax, no autoplay. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static and fully visible.
+
+## Anti-patterns
+
+- **No dark canvas.** Bloom is the light-paper atmospheric theme; a dark ground is Midnight / Terminal / Lumen-Night territory. Paper stays `L 97%`.
+- **No cool paper or cool accent.** Warm hue (40-72 neutrals, ~35 accent) throughout; a cool grey or blue reads as Cobalt / Midnight.
+- **No `#fff` / `#000`.** Warm off-white paper, warm near-black ink.
+- **No italic headers, no italic Instrument Serif in the H1** (global rule). The serif counterpoint is roman.
+- **No accent flood.** Terracotta lives on the CTA, the bloom, and small tags (< ~8% of viewport); a large orange field collides with Lumen brass / Coral coral and reads as a warning colour.
+- **No glassmorphism, no gradient text** (universal gates). Warm elevation, not glass.
+- **No hard-edged or moving bloom.** Soft, low-opacity, static, fixed; a drifting aurora blob is Aurora's move and breaks the calm.
+- **No instrument-panel restraint.** Bloom is expressive and warm, not Cobalt's cool hairline dashboard.
+
+## Macrostructure affinity / rejection
+
+**Bloom loves:** Marquee Hero (one confident generative demo in the bloom - the atmospheric default) . Manifesto (a warm creative-tool page argues a worldview) . Photographic / portfolio-grid (a gallery of generated output, warmly lit) . feature-stack (make -> refine -> share workflow) . Stat-Led (only when there are honest numbers).
+
+**Bloom refuses:** Workbench / component-playground (too mechanical - that is Cobalt / Lumen) . Long Document (prose-led; route editorial / Garden) . Letter (too intimate for a tool) . Catalogue (commerce grid; Bloom breathes).
+
+## Voice fixtures
+
+Warm, daylight, expressive, specific. Name the verb, name the output.
+
+- *"Hum it. We'll finish the song."*
+- *"From a sentence to a scene, before your coffee's cold."*
+- *"Make something today you couldn't yesterday."*
+- *"Describe the light. We'll paint it."*
+- *"A studio that opens when you do."*
+
+Never any of: *seamless, revolutionary, unleash, unlock, supercharge, cutting-edge, next-generation, game-changing, AI-powered* (as a badge). Say the verb (make, hum, describe), say the output (song, scene, image).
+
+## How Bloom differs from neighbouring themes
+
+| vs | what settles it instantly |
+|---|---|
+| **Midnight** (atmospheric, same Geist) | Midnight is a **dark** cool canvas (hue ~250), nocturnal and cool. Bloom is **light** warm off-white (hue 72) with a warm terracotta bloom. Light vs dark plus warm vs cool settles it at a glance. |
+| **Coral** (modern-minimal, same warm + Geist + light) | Coral is warm-grey paper, hairline structure, a quiet SaaS product page, no bloom. Bloom is warm-cream with a warm radial bloom, expressive AI-creative display, and elevated surfaces. The bloom + expressive register is the tell. |
+| **Garden** (editorial, same warm-light paper) | Garden is oat-cream with a roman-serif Young Serif display, green ink, and a hand-built botanical specimen. Bloom keeps warm-neutral ink, a Geist geometric display, and a light bloom canvas. Different ink, different focal treatment (botanical object vs warm light). |
+
+## Test brief expectations
+
+Candidate when the brief mentions: *generative . AI creative . music . song . video . image . voice . art . make . create . compose . render . imagine . prompt . studio . playground . expressive . warm . daylight . inviting . consumer creative*.
+Product categories: *generative music / video / image / voice tool . creative AI app . consumer model playground . AI art studio.*
+Emotional tone: *warm . inviting . optimistic . expressive . daylight-creative . human . playful-but-refined.*
+Briefs that are dark / nocturnal (Midnight, Lumen), technical / instrument (Cobalt), or editorial / photographic-with-real-photos route elsewhere.
+
+## Build hint
+
+```css
+html, body { overflow-x: clip; }
+body { background: var(--color-paper); color: var(--color-ink-2);
+ font-family: var(--font-body); font-weight: 400; }
+
+/* The bloom - two warm radials on warm paper, static + fixed */
+body::before {
+ content: ""; position: fixed; inset: 0; z-index: -1; pointer-events: none;
+ background:
+ radial-gradient(42% 38% at 72% 16%, oklch(56% 0.13 35 / 0.10), transparent 70%),
+ radial-gradient(46% 40% at 18% 90%, oklch(64% 0.09 55 / 0.07), transparent 72%); }
+
+/* Geist display - geometric, roman, sized big */
+.hero__title, .section__title {
+ font-family: var(--font-display); font-weight: var(--display-weight);
+ letter-spacing: var(--tracking-display); line-height: var(--lh-tight);
+ color: var(--color-ink); }
+
+/* Instrument Serif - warm roman counterpoint, never the H1 */
+.lede--serif { font-family: var(--font-serif); font-style: normal;
+ color: var(--color-ink-2); }
+
+/* Geist Mono machine-readout labels */
+.eyebrow, .tag { font-family: var(--font-label); text-transform: uppercase;
+ letter-spacing: var(--tracking-label); color: var(--color-muted); }
+
+/* One pill CTA, warm terracotta glow on hover */
+.btn--solid { background: var(--color-accent); color: var(--color-accent-ink);
+ border-radius: 999px; }
+.btn--solid:hover { box-shadow: 0 8px 30px oklch(56% 0.13 35 / 0.28); }
+
+/* Reveal - fade only; the atmosphere does the work */
+.reveal { opacity: 0; transition: opacity .6s ease; }
+.reveal.is-in { opacity: 1; }
+@media (prefers-reduced-motion: reduce) {
+ .reveal { opacity: 1; transition: none; } }
+```
+
+Plus the Geist + Instrument Serif + Geist Mono link and the small reveal script.
diff --git a/skills/hallmark/references/themes/brutal.md b/skills/hallmark/references/themes/brutal.md
new file mode 100644
index 0000000..c9c5857
--- /dev/null
+++ b/skills/hallmark/references/themes/brutal.md
@@ -0,0 +1,134 @@
+# Theme - Brutal
+
+Raw graphic-design brutalism. The page for a **design studio, a streetwear drop, a zine, a statement portfolio, an event / festival poster** - the school of heavy grids, slab type, and one loud signal. Near-white paper (`oklch(98% 0.001 0)`) is carved by near-black 3px rules (`oklch(12% 0.005 0)`), stacked with giant uppercase Albert Sans 700, and cut by exactly ONE red (`#E63946`) as a fill-block or bar. It reads like a wayfinding sign or a broadsheet front page: loud, rigid, unhedged.
+
+Loaded eagerly by SKILL.md Step 3 when the catalog pick is `brutal`. Tokens: `site/css/tokens.css` under `[data-theme="brutal"]`.
+
+## Axes (diversification)
+
+- **Paper band** - light (`oklch(98% 0.001 0)`, chroma ~0, hue 0). An engineered near-white, all but neutral. Not tinted, not warm-grey - a clean sheet the black rules bite into.
+- **Display style** - **display-heavy**: Albert Sans **700**, run UPPERCASE at `--tracking-display: -0.045em`. `--lh-tight: 1.02` is the floor: below it, cap-tops of line N+1 collide with line N on multi-line all-caps heads.
+- **Accent hue** - **warm red** (`#E63946`, text form `oklch(58% 0.24 25)`). One saturated signal, hue ~25. Sits clear of the cool themes; used as a graphic cut, never a wash.
+
+## Reference register
+
+Bloomberg Businessweek graphics, Balenciaga, Gumroad, Cash App, Are.na, MSCHF, Off-White, Read the Docs. The aesthetic: the heavy-grid front page and the wayfinding sign - thick black rules, one red bar, type as the structure. **Patron-saint (internal):** *a broadsheet masthead crossed with a machine-shop label plate* - rigid grid, one red stamp, everything flush to a border. Never name any of these in the output.
+
+## Required dependencies
+
+1. **Fonts** - **Albert Sans** (display + body, 400/500/700/900), **JetBrains Mono** (labels + meta). All-sans; no serif anywhere. Google Fonts:
+ ```html
+ <link href="https://fonts.googleapis.com/css2?family=Albert+Sans:wght@400;500;700;900&family=JetBrains+Mono:wght@400;500;700&display=swap" rel="stylesheet" />
+ ```
+2. **A minimal reveal (optional)** - one `IntersectionObserver` adding `.is-in`. Motion snaps or steps, it does not glide (see Motion). Reduced-motion ships everything static + visible.
+
+## Signature moves
+
+1. **Engineered near-white paper, near-black ink** - paper `oklch(98% 0.001 0)`, ink `oklch(8% 0.005 0)`, body `oklch(12% 0.005 0)`. Close to `#fff`/`#000` on purpose but never either: the ~0-chroma neutrality is what makes the red read as the only colour on the page.
+
+2. **Thick rules are the structure** - two weights only: `--rule-fine: 3px` heavy borders box every section and figure; `--rule-hair: 1px` splits rows inside them. Brutalism draws with a marker, not a pencil. Column rules stay visible; content sits flush to the border with no inset gutter softening it.
+
+3. **Zero radius, everywhere** - `border-radius: 0` on buttons, inputs, blocks, images. Square corners are non-negotiable; any rounding reads as a softer sibling and breaks the theme.
+
+4. **One red signal, graphic not gradient** - `#E63946` as a solid fill-block, a full-width bar, a `<mark>` at x-height, the focus ring, one primary button (red fill, paper text). Kept under ~5% of any viewport. Never a gradient, never a tint wash, never two accents.
+
+5. **Uppercase Albert Sans 700 display, edge to edge** - heads run UPPERCASE, `--tracking-display: -0.045em`, `--lh-tight: 1.02`, sized by `--text-display` (clamp to 6.5rem). Flush-left, allowed to run wide and clip against a rule. Never centred, never italic (global rule).
+
+6. **Inverted solid blocks, no float** - the page reads as stacked filled rectangles: a solid black panel with paper text, a solid red panel, a bordered white panel. No drop-shadow blur, no glass, no card-on-card float - blocks butt against each other and against rules.
+
+7. **JetBrains Mono catalog voice** - eyebrows, section numbers (`01 / 02 / 03`), meta rows, filenames, kbd hints in mono, UPPERCASE, `--tracking-label: 0.04em`, in `--color-muted` (`oklch(38%)`). The machine-readout counterpoint to the shouting display face.
+
+## Motion
+
+Mechanical and abrupt. Reveals snap or step (a hard `opacity` cut, or a 1-step translate over ~120ms), they do not ease-glide. Hover flips state instantly: a block inverts to `--color-ink` (or `--color-accent`) with paper text, a border thickens to red. No bounce, no parallax, no blur transition, no autoplay. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static + fully visible.
+
+## Anti-patterns
+
+- **No rounded corners.** Any `border-radius` > 0 belongs to Cobalt / Coral, not here.
+- **No blurred drop-shadows, no glassmorphism.** Depth is borders and solid fills; a hard-offset no-blur shadow is Carnival's decorative move, keep it out.
+- **No ornaments / fleurons / layered offset stacks** - that is Carnival's decorated lane. Brutal is raw.
+- **No black paper.** Inversion into a dark ground is Manifesto. Brutal is a **light 98%** sheet with black structure.
+- **No second colour, no gradient, no pastel.** Exactly one red signal on near-neutral ink.
+- **No serif, no italic display.** Albert Sans + JetBrains Mono only.
+- **No centred hero, no soft prose column drifting to middle.** Flush-left, edge-aligned to a rule.
+- **Do not let the red flood.** It cuts; it does not coat.
+
+## Macrostructure affinity / rejection
+
+**Brutal loves:**
+- **Manifesto** - short, loud, all-caps declaratives stacked between heavy rules.
+- **Stat-Led** - big figures in bordered cells, mono labels beneath.
+- **Specimen / type-specimen** - Albert Sans 700 as the subject, giant glyphs edge to edge.
+- **Catalogue / index-first** - numbered rows split by hairlines, mono meta, one red column.
+- **Bento Grid** - only with 3px square-cornered borders (a rigid module wall, never soft tiles).
+
+**Brutal refuses:**
+- **Photographic / image-led** - Brutal leads with type and rule, not imagery.
+- **Letter** - too intimate; Brutal shouts, it does not confide.
+- **Conversational FAQ** - too friendly and rounded for a wayfinding sign.
+- **Quote-Led** - too gentle a centre of gravity.
+
+## Voice fixtures
+
+Blunt, declarative, often ALL CAPS. Verbs and nouns, no hedging.
+
+- *"SAME PROMPT. TWO OUTPUTS."*
+- *"NO TEMPLATES. NO DEFAULTS."*
+- *"READ THE SPEC. SHIP THE PAGE."*
+- *"STRUCTURE IS THE STYLE."*
+- *"ONE RED. EVERYTHING ELSE IS INK."*
+
+Never any of: *seamless, elegant, delightful, gentle, soft, curated, whimsical, effortless, playful*. No hedges, no hype. Say the thing flat.
+
+## How Brutal differs from neighbouring themes
+
+| vs | what settles it instantly |
+|---|---|
+| **Carnival** (editorial maximalist sibling) | Carnival is **decorated**: duo-tone accents, ornaments, hard-offset layered shadows, variable-width type, tinted paper. Brutal is **raw**: near-white paper, one red, thick black borders, no ornament, Albert Sans slab. Decorated vs raw. |
+| **Manifesto** (loud editorial sibling) | Manifesto is **BLACK paper** + all-caps red display (dark, inverted polarity). Brutal is a **light 98% sheet** with black structure and a red cut. Light vs dark settles it in one glance. |
+| **Riso** (print-craft editorial) | Riso is risograph craft: peach paper, CMYK misregistration, soft grainy ink. Brutal is hard-edged and crisp: no texture, no misregistration, heavy exact rules. |
+
+## Test brief expectations
+
+Brutal should be a candidate when the brief mentions:
+
+- *brutalist · raw · bold · high-contrast · statement · agency · studio · portfolio · streetwear · drop · zine · manifesto · type-forward · graphic-design · poster · festival · collective · no-nonsense · uncompromising*
+- Product categories: *design studio / agency · streetwear or fashion drop · editorial / zine · type-forward portfolio · event or festival page · statement landing*
+- Emotional tone: *loud · blunt · confident · raw · high-contrast · rigid · unhedged*
+
+Warm, soft, image-led, or intimate briefs route elsewhere (Carnival for decorated maximalism, Manifesto for the dark inversion, the quieter editorial themes for prose).
+
+## Build hint
+
+```css
+html, body { overflow-x: clip; }
+body { background: var(--color-paper); color: var(--color-ink);
+ font-family: var(--font-body); font-weight: 400; }
+
+/* Display - uppercase Albert Sans 700, ultra-tight, edge-aligned */
+h1, h2, .display { font-family: var(--font-display);
+ font-weight: var(--display-weight); text-transform: uppercase;
+ letter-spacing: var(--tracking-display); line-height: var(--lh-tight); }
+
+/* Structure = thick square-cornered rules, never radius */
+.block { border: var(--rule-fine) solid var(--color-rule); border-radius: 0; }
+.rule { border: 0; border-top: var(--rule-fine) solid var(--color-rule); }
+
+/* One red signal - solid fill or bar, never gradient */
+.bar, mark { background: var(--color-accent); color: var(--color-paper); }
+.accent { color: var(--color-accent-ink); }
+.btn { border: var(--rule-fine) solid var(--color-rule); border-radius: 0; }
+
+/* Mono catalog voice */
+.label { font-family: var(--font-label); text-transform: uppercase;
+ letter-spacing: var(--tracking-label); color: var(--color-muted); }
+
+/* Inversion on hover - instant, no blur, no bounce */
+.invert:hover { background: var(--color-ink); color: var(--color-paper); }
+
+@media (prefers-reduced-motion: reduce) {
+ * { transition: none !important; animation: none !important; }
+}
+```
+
+Plus the Albert Sans + JetBrains Mono link and the minimal snap-reveal script.
diff --git a/skills/hallmark/references/themes/carnival.md b/skills/hallmark/references/themes/carnival.md
index d3b8767..b0b5c09 100644
--- a/skills/hallmark/references/themes/carnival.md
+++ b/skills/hallmark/references/themes/carnival.md
@@ -1,14 +1,14 @@
-# Theme — Carnival
+# Theme - Carnival
-Loud-maximalist editorial. **Duo-tone accent system across six named palette drops** (each its own mood), chunky variable display, decorative ornaments, hard-offset shadows, tinted paper. The loud sibling to Riso / Manifesto / Brutal — but **decorative, not raw**.
+Loud-maximalist editorial. **Duo-tone accent system across six named palette drops** (each its own mood), chunky variable display, decorative ornaments, hard-offset shadows, tinted paper. The loud sibling to Riso / Manifesto / Brutal - but **decorative, not raw**.
Loaded eagerly by SKILL.md Step 3 whenever the catalog pick is `carnival`. The default palette ("Cold Snap") and font stack live in [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="carnival"]`; this file carries the **palette drops** (six variants) plus the rules that tokens cannot encode.
## Axes (diversification)
-- **Paper band** — light (`L 88–95%`, tinted — varies by drop)
-- **Display style** — **display-heavy** (Big Shoulders Display 800, variable-width axis)
-- **Accent hue** — **per-drop**. Each drop has its own duo-tone hue pair (warm+warm, cool+warm, warm+cool, etc.). The drop name is recorded alongside the theme name in the diversification log so consecutive builds rotate drops, not just themes.
+- **Paper band** - light (`L 88-95%`, tinted - varies by drop)
+- **Display style** - **display-heavy** (Big Shoulders Display 800, variable-width axis)
+- **Accent hue** - **per-drop**. Each drop has its own duo-tone hue pair (warm+warm, cool+warm, warm+cool, etc.). The drop name is recorded alongside the theme name in the diversification log so consecutive builds rotate drops, not just themes.
## Palette drops
@@ -18,15 +18,15 @@ A drop is a named duo-tone palette that preserves Carnival's structural signatur
Warm + warm. Indie record-label, winter, scrappy. The canonical Carnival.
-- `--color-paper: oklch(92% 0.045 50)` — warm pink-cream
+- `--color-paper: oklch(92% 0.045 50)` - warm pink-cream
- `--color-paper-2: oklch(88% 0.050 45)`
- `--color-paper-3: oklch(82% 0.060 40)`
-- `--color-ink: oklch(18% 0.080 20)` — deep aubergine
+- `--color-ink: oklch(18% 0.080 20)` - deep aubergine
- `--color-ink-2: oklch(28% 0.060 25)`
- `--color-muted: oklch(45% 0.05 30)`
-- `--color-rule: oklch(40% 0.18 25)` — oxblood rules (decorative)
-- `--color-accent: oklch(86% 0.18 95)` — mustard
-- `--color-accent-2: oklch(40% 0.21 25)` — oxblood
+- `--color-rule: oklch(40% 0.18 25)` - oxblood rules (decorative)
+- `--color-accent: oklch(86% 0.18 95)` - mustard
+- `--color-accent-2: oklch(40% 0.21 25)` - oxblood
- `--color-accent-ink: oklch(18% 0.080 20)`
- `--color-focus: oklch(40% 0.21 25)`
@@ -34,17 +34,17 @@ Warm + warm. Indie record-label, winter, scrappy. The canonical Carnival.
### Drop 02 · Citrus Riot
-Loud + neon. 90s zine, summer, electric. Lime against magenta — the hardest collision in the catalogue.
+Loud + neon. 90s zine, summer, electric. Lime against magenta - the hardest collision in the catalogue.
-- `--color-paper: oklch(94% 0.040 85)` — pale acid cream
+- `--color-paper: oklch(94% 0.040 85)` - pale acid cream
- `--color-paper-2: oklch(90% 0.048 82)`
- `--color-paper-3: oklch(84% 0.055 80)`
-- `--color-ink: oklch(20% 0.07 145)` — deep forest
+- `--color-ink: oklch(20% 0.07 145)` - deep forest
- `--color-ink-2: oklch(32% 0.05 140)`
- `--color-muted: oklch(48% 0.04 130)`
-- `--color-rule: oklch(28% 0.28 350)` — deep magenta rules
-- `--color-accent: oklch(82% 0.20 130)` — chartreuse-lime
-- `--color-accent-2: oklch(28% 0.28 350)` — deep magenta (reads AA on paper, and as text)
+- `--color-rule: oklch(28% 0.28 350)` - deep magenta rules
+- `--color-accent: oklch(82% 0.20 130)` - chartreuse-lime
+- `--color-accent-2: oklch(28% 0.28 350)` - deep magenta (reads AA on paper, and as text)
- `--color-accent-ink: oklch(20% 0.07 145)`
- `--color-focus: oklch(28% 0.28 350)`
@@ -54,15 +54,15 @@ Loud + neon. 90s zine, summer, electric. Lime against magenta — the hardest co
Americana. Cream + cherry red + navy. Postwar diner, road trip, neon-and-chrome.
-- `--color-paper: oklch(95% 0.035 90)` — bright cream
+- `--color-paper: oklch(95% 0.035 90)` - bright cream
- `--color-paper-2: oklch(91% 0.042 88)`
- `--color-paper-3: oklch(86% 0.050 85)`
-- `--color-ink: oklch(16% 0.04 30)` — black-brown
+- `--color-ink: oklch(16% 0.04 30)` - black-brown
- `--color-ink-2: oklch(28% 0.05 30)`
- `--color-muted: oklch(45% 0.04 35)`
-- `--color-rule: oklch(30% 0.16 250)` — navy rules
-- `--color-accent: oklch(60% 0.22 25)` — cherry red
-- `--color-accent-2: oklch(30% 0.16 250)` — navy
+- `--color-rule: oklch(30% 0.16 250)` - navy rules
+- `--color-accent: oklch(60% 0.22 25)` - cherry red
+- `--color-accent-2: oklch(30% 0.16 250)` - navy
- `--color-accent-ink: oklch(95% 0.035 90)`
- `--color-focus: oklch(30% 0.16 250)`
@@ -72,15 +72,15 @@ Americana. Cream + cherry red + navy. Postwar diner, road trip, neon-and-chrome.
Cool + cool. Dusk warmth, cyan + plum. Late-night booth, blue hour, podcast studio at midnight.
-- `--color-paper: oklch(88% 0.05 25)` — warm dusk pink
+- `--color-paper: oklch(88% 0.05 25)` - warm dusk pink
- `--color-paper-2: oklch(84% 0.055 22)`
- `--color-paper-3: oklch(78% 0.06 20)`
-- `--color-ink: oklch(20% 0.05 270)` — deep navy-black
+- `--color-ink: oklch(20% 0.05 270)` - deep navy-black
- `--color-ink-2: oklch(32% 0.045 265)`
- `--color-muted: oklch(48% 0.04 260)`
-- `--color-rule: oklch(24% 0.18 320)` — deep plum rules
-- `--color-accent: oklch(78% 0.18 220)` — cyan
-- `--color-accent-2: oklch(24% 0.18 320)` — deep plum (reads AA on paper, and as text)
+- `--color-rule: oklch(24% 0.18 320)` - deep plum rules
+- `--color-accent: oklch(78% 0.18 220)` - cyan
+- `--color-accent-2: oklch(24% 0.18 320)` - deep plum (reads AA on paper, and as text)
- `--color-accent-ink: oklch(20% 0.05 270)`
- `--color-focus: oklch(24% 0.18 320)`
@@ -90,15 +90,15 @@ Cool + cool. Dusk warmth, cyan + plum. Late-night booth, blue hour, podcast stud
Cool + warm. Turquoise against coral. Summer pool, motel sign, vacation.
-- `--color-paper: oklch(94% 0.040 180)` — pale aqua-cream
+- `--color-paper: oklch(94% 0.040 180)` - pale aqua-cream
- `--color-paper-2: oklch(90% 0.048 178)`
- `--color-paper-3: oklch(84% 0.055 175)`
-- `--color-ink: oklch(20% 0.06 200)` — deep teal
+- `--color-ink: oklch(20% 0.06 200)` - deep teal
- `--color-ink-2: oklch(32% 0.05 198)`
- `--color-muted: oklch(48% 0.04 195)`
-- `--color-rule: oklch(36% 0.24 35)` — deep coral rules
-- `--color-accent: oklch(72% 0.16 195)` — turquoise
-- `--color-accent-2: oklch(36% 0.24 35)` — deep coral (reads AA on paper, and as text)
+- `--color-rule: oklch(36% 0.24 35)` - deep coral rules
+- `--color-accent: oklch(72% 0.16 195)` - turquoise
+- `--color-accent-2: oklch(36% 0.24 35)` - deep coral (reads AA on paper, and as text)
- `--color-accent-ink: oklch(20% 0.06 200)`
- `--color-focus: oklch(36% 0.24 35)`
@@ -108,15 +108,15 @@ Cool + warm. Turquoise against coral. Summer pool, motel sign, vacation.
Warm + cool. Amber-gold against slate-blue. 1950s journalism, print shop, broadsheet weight.
-- `--color-paper: oklch(89% 0.025 65)` — warm slate-cream
+- `--color-paper: oklch(89% 0.025 65)` - warm slate-cream
- `--color-paper-2: oklch(85% 0.030 62)`
- `--color-paper-3: oklch(79% 0.035 58)`
-- `--color-ink: oklch(16% 0.02 60)` — ink-black
+- `--color-ink: oklch(16% 0.02 60)` - ink-black
- `--color-ink-2: oklch(28% 0.025 58)`
- `--color-muted: oklch(45% 0.025 55)`
-- `--color-rule: oklch(34% 0.10 240)` — slate-blue rules
-- `--color-accent: oklch(78% 0.18 75)` — amber-gold
-- `--color-accent-2: oklch(34% 0.10 240)` — slate-blue
+- `--color-rule: oklch(34% 0.10 240)` - slate-blue rules
+- `--color-accent: oklch(78% 0.18 75)` - amber-gold
+- `--color-accent-2: oklch(34% 0.10 240)` - slate-blue
- `--color-accent-ink: oklch(16% 0.02 60)`
- `--color-focus: oklch(34% 0.10 240)`
@@ -137,11 +137,11 @@ Match the brief's **domain** before reaching for the loudest palette:
- zine / skate / DIY / deliberately chaotic → **Citrus Riot**
- journalism / newsletter / editorial → **Pressroom**
-Citrus Riot and Aqua Park are the highest-chroma drops — reach for them when the brief genuinely *wants* maximum loudness, not as a default. A food market reads better in Diner Sign than in lime-on-magenta.
+Citrus Riot and Aqua Park are the highest-chroma drops - reach for them when the brief genuinely *wants* maximum loudness, not as a default. A food market reads better in Diner Sign than in lime-on-magenta.
### When to construct a custom drop instead
-If the brief explicitly names a brand colour that doesn't fit any catalog drop — e.g. *"our brand is teal and beige"* — route to the **custom theme** branch (see `custom-theme.md`) instead of stretching a Carnival drop. Drops are curated, not infinite. Six is the right number for now.
+If the brief explicitly names a brand colour that doesn't fit any catalog drop - e.g. *"our brand is teal and beige"* - route to the **custom theme** branch (see `custom-theme.md`) instead of stretching a Carnival drop. Drops are curated, not infinite. Six is the right number for now.
## Reference register
@@ -155,7 +155,7 @@ The aesthetic: independent music labels, comedy networks, illustrator portfolios
The theme's seven tics. A Carnival build should exhibit at least five of them.
-1. **Duo-tone accent system.** Sections alternate which accent fills them. Section 1 fills with `--color-accent` (mustard); section 2 fills with `--color-accent-2` (oxblood); section 3 mustard again; etc. One section never shows both — they are *competing*, not blended.
+1. **Duo-tone accent system.** Sections alternate which accent fills them. Section 1 fills with `--color-accent` (mustard); section 2 fills with `--color-accent-2` (oxblood); section 3 mustard again; etc. One section never shows both - they are *competing*, not blended.
```css
.section:nth-of-type(odd) { --section-fill: var(--color-accent); }
@@ -188,51 +188,51 @@ The theme's seven tics. A Carnival build should exhibit at least five of them.
Used wherever the page would otherwise have a photo placeholder.
-7. **Marquee scroll** on banner OR footer with decorative dot separators. *"NEW EP ◆ OUT NOW ◆ ON CASSETTE ◆ BLUE VINYL ◆ NEW EP ◆..."* — horizontal scroll, honours `prefers-reduced-motion: reduce` (freeze at static state).
+7. **Marquee scroll** on banner OR footer with decorative dot separators. *"NEW EP ◆ OUT NOW ◆ ON CASSETTE ◆ BLUE VINYL ◆ NEW EP ◆..."* - horizontal scroll, honours `prefers-reduced-motion: reduce` (freeze at static state).
## Layout pitfalls (must avoid)
-Carnival's dense visual language has known traps. Read this list **before** writing a card layout — these are mistakes that have happened in earlier builds and shipped looking broken.
+Carnival's dense visual language has known traps. Read this list **before** writing a card layout - these are mistakes that have happened in earlier builds and shipped looking broken.
-1. **Halftone portrait + side-by-side text in a narrow card → text gets covered.** When pairing a halftone "host portrait" / "artist portrait" with a show / artist name in the same card, **never use a 2-column grid where the content column can collapse below 200 px**. On a 3-up `repeat(3, 1fr)` desktop grid, the content column inside each card is ~150–180 px wide and a 5 rem portrait squeezes the title into overlap. The safe patterns:
- - **Vertical stack** (portrait on top, content below — the portrait sits naturally in the top-left of the card content area because of card padding). This is the default for portrait-paired cards.
+1. **Halftone portrait + side-by-side text in a narrow card → text gets covered.** When pairing a halftone "host portrait" / "artist portrait" with a show / artist name in the same card, **never use a 2-column grid where the content column can collapse below 200 px**. On a 3-up `repeat(3, 1fr)` desktop grid, the content column inside each card is ~150-180 px wide and a 5 rem portrait squeezes the title into overlap. The safe patterns:
+ - **Vertical stack** (portrait on top, content below - the portrait sits naturally in the top-left of the card content area because of card padding). This is the default for portrait-paired cards.
- **Side-by-side ONLY at 2-up or 1-up grids** where the content column has ≥ 250 px to breathe.
- - **Sticker corner** — portrait positioned `absolute; top: 0; right: 0` as a small badge, with text content flowing full-width below.
+ - **Sticker corner** - portrait positioned `absolute; top: 0; right: 0` as a small badge, with text content flowing full-width below.
Concretely: if the card is in a `repeat(3, 1fr)` grid and includes a portrait + title pair, the card must use `display: flex; flex-direction: column;` with the portrait at a fixed `width: 4.5rem; height: 4.5rem;` (not `width: 100%`). Halftone squares **never** overlap typography.
2. **Hard-offset shadow on a card next to a viewport edge → shadow gets clipped.** When a card sits flush against the right edge of the page gutter, its `4px 4px 0` shadow extends past the page max-width. Add `padding-right: max(var(--page-gutter), 8px)` to grids that include shadowed cards near the edge, or set the shell to have ≥ 8 px right margin past the card grid.
-3. **Duo-tone fill on a card whose content includes both accents → reads as "blended", not "competing".** A mustard tile must never contain an oxblood badge inside it. Pick one accent per tile. (Signature #1 explicitly says this — but it's worth restating here because it gets violated when adding a sticker or a "NEW" badge.)
+3. **Duo-tone fill on a card whose content includes both accents → reads as "blended", not "competing".** A mustard tile must never contain an oxblood badge inside it. Pick one accent per tile. (Signature #1 explicitly says this - but it's worth restating here because it gets violated when adding a sticker or a "NEW" badge.)
4. **Marquee scroll that doesn't repeat its content → gap at end of loop.** The marquee must contain the same scrolling text repeated at least twice (or use `aria-hidden` siblings) so the scroll animation reads as continuous, not as a single string sliding off.
-5. **Big Shoulders width axis used without `font-variation-settings` → no width variation.** Setting `font-stretch` on Google's Big Shoulders Display does not work — only `font-variation-settings: "wdth" 110` does. If you see a hero that's supposed to be width-110 but renders at width-100, this is the bug.
+5. **Big Shoulders width axis used without `font-variation-settings` → no width variation.** Setting `font-stretch` on Google's Big Shoulders Display does not work - only `font-variation-settings: "wdth" 110` does. If you see a hero that's supposed to be width-110 but renders at width-100, this is the bug.
-6. **Section head detached from, or mis-centred over, its body.** The section head (heading + any lede) sits **tight above** the content it names — about `1.25rem` (`--section-head-gap`) — and **shares that content's alignment**. Don't cap the head at a narrow `max-width` / `ch` and then `margin-inline: auto` it: that strands a centred head over a full-width, left-flush grid (the classic accidental mismatch). Left-flush grid → left-flush head. (See the alignment-coherence note in `layout-and-space.md`.)
+6. **Section head detached from, or mis-centred over, its body.** The section head (heading + any lede) sits **tight above** the content it names - about `1.25rem` (`--section-head-gap`) - and **shares that content's alignment**. Don't cap the head at a narrow `max-width` / `ch` and then `margin-inline: auto` it: that strands a centred head over a full-width, left-flush grid (the classic accidental mismatch). Left-flush grid → left-flush head. (See the alignment-coherence note in `layout-and-space.md`.)
-7. **Newsletter / CTA button not aligned with the input beside it.** When a button sits next to a form input in one row, they must share the **same height, vertical padding, and border width**, and the row must use `align-items: center` — otherwise the button floats above the input's baseline. If a label is stacked above the input it makes that column taller; centre the row on the *control*, not the column (give the field `align-items: center` or pull the label out of the flex row).
+7. **Newsletter / CTA button not aligned with the input beside it.** When a button sits next to a form input in one row, they must share the **same height, vertical padding, and border width**, and the row must use `align-items: center` - otherwise the button floats above the input's baseline. If a label is stacked above the input it makes that column taller; centre the row on the *control*, not the column (give the field `align-items: center` or pull the label out of the flex row).
## Macrostructure affinity
**Carnival loves these.**
-- **Marquee Hero** — the canonical Carnival opening; large word, scrolling banner under
-- **Type Specimen** — the page IS the type; Big Shoulders Display 96 px+ as content
-- **Manifesto** — short loud declarative statements (works for Carnival's voice too, but louder palette)
-- **Stat-Led** — when the page leads with numbers, Carnival displays them big-and-mustard
-- **Photographic** — image-led with halftone treatments and ornament captions
-- **Bento Grid** (loud variant) — gridded blocks where each tile alternates accent colour
+- **Marquee Hero** - the canonical Carnival opening; large word, scrolling banner under
+- **Type Specimen** - the page IS the type; Big Shoulders Display 96 px+ as content
+- **Manifesto** - short loud declarative statements (works for Carnival's voice too, but louder palette)
+- **Stat-Led** - when the page leads with numbers, Carnival displays them big-and-mustard
+- **Photographic** - image-led with halftone treatments and ornament captions
+- **Bento Grid** (loud variant) - gridded blocks where each tile alternates accent colour
## Macrostructure rejection
**Carnival refuses these.**
-- **Long Document** — too quiet; Carnival doesn't sustain over 1500 words
-- **Letter** — too intimate; Carnival never whispers
-- **Quote-Led** — too pensive
-- **Conversational FAQ** — too soft
-- **Workbench** — too technical; Carnival is poster art, not product spec
+- **Long Document** - too quiet; Carnival doesn't sustain over 1500 words
+- **Letter** - too intimate; Carnival never whispers
+- **Quote-Led** - too pensive
+- **Conversational FAQ** - too soft
+- **Workbench** - too technical; Carnival is poster art, not product spec
If the brief would otherwise land in one of these, redirect to Marquee Hero or Manifesto.
@@ -246,10 +246,10 @@ Sample lines the Carnival voice should *read like*. Short. Loud. Declarative. Ca
- *"ONE EP. THREE ARTISTS. NO REGRETS."*
- *"THE GAME IS PIXEL ART. THE GAME IS HARD."*
-Body copy is **shorter than other themes**. 1–2 short sentences per paragraph. Paragraphs separated by ornament dividers, not whitespace alone.
+Body copy is **shorter than other themes**. 1-2 short sentences per paragraph. Paragraphs separated by ornament dividers, not whitespace alone.
**Voice rules:**
-- Headlines: ALL CAPS, ≤ 6 words, period at end (not exclamation — the loudness is in the type, not the punctuation).
+- Headlines: ALL CAPS, ≤ 6 words, period at end (not exclamation - the loudness is in the type, not the punctuation).
- Body: sentence case, short, present-tense.
- Numerals over words always (*5* not *five*).
- Never any of: "experience", "journey", "elevate", "curate", "platform", "ecosystem", "transform". These are SaaS-default AI tells; Carnival is independent, not platformed.
@@ -269,9 +269,9 @@ Body copy is **shorter than other themes**. 1–2 short sentences per paragraph.
| vs | difference |
|---|---|
-| **Riso** | Riso is risograph print-craft (peach paper, CMYK misregistration on display, cyan + yellow). Carnival is *editorial maximalism* — duo-tone, oxblood-on-pink, decorative ornaments, variable-width type. Different parent tradition. |
-| **Manifesto** | Manifesto is BLACK paper + ALL CAPS red Anton. Carnival is *tinted warm paper* + duo accents + ornaments. Inverted polarity — Manifesto is dark, Carnival is light. |
-| **Brutal** | Brutal is raw graphic-design brutalism (heavy borders, slab type, no ornaments). Carnival is **decorative** — ornaments, layered blocks, variable type, character. |
+| **Riso** | Riso is risograph print-craft (peach paper, CMYK misregistration on display, cyan + yellow). Carnival is *editorial maximalism* - duo-tone, oxblood-on-pink, decorative ornaments, variable-width type. Different parent tradition. |
+| **Manifesto** | Manifesto is BLACK paper + ALL CAPS red Anton. Carnival is *tinted warm paper* + duo accents + ornaments. Inverted polarity - Manifesto is dark, Carnival is light. |
+| **Brutal** | Brutal is raw graphic-design brutalism (heavy borders, slab type, no ornaments). Carnival is **decorative** - ornaments, layered blocks, variable type, character. |
| **Sport** | Sport is athletic italic uppercase (Inter Tight italic 700). Carnival is poster-art expressive (Big Shoulders 800 with width axis). Sport feels Nike; Carnival feels Drag City. |
## Test brief expectations
diff --git a/skills/hallmark/references/themes/cobalt.md b/skills/hallmark/references/themes/cobalt.md
index 7f7c324..9229e28 100644
--- a/skills/hallmark/references/themes/cobalt.md
+++ b/skills/hallmark/references/themes/cobalt.md
@@ -1,51 +1,51 @@
-# Theme — Cobalt
+# Theme - Cobalt
-Modern-minimal, dev-tool register. The page for an **API, an SDK, a CLI, a docs home, a developer platform** — the GitBook / Firecrawl / Vercel school, executed in **cool cobalt-on-light, not orange**. A calm cool-white ground, ruler-drawn hairlines, exactly ONE electric cobalt signal accent, and **code as the hero**. It reads like good infrastructure: calm, precise, fast.
+Modern-minimal, dev-tool register. The page for an **API, an SDK, a CLI, a docs home, a developer platform** - the GitBook / Firecrawl / Vercel school, executed in **cool cobalt-on-light, not orange**. A calm cool-white ground, ruler-drawn hairlines, exactly ONE electric cobalt signal accent, and **code as the hero**. It reads like good infrastructure: calm, precise, fast.
Loaded eagerly by SKILL.md Step 3 whenever the catalog pick is `cobalt`. The OKLCH palette + font stack live in [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="cobalt"]`. Canonical build: [`site/examples/cobalt-01/`](../../../../site/examples/cobalt-01/) (an API product landing with a request/response hero).
-> **Why not orange.** GitBook and Firecrawl both converged on orange-as-signal — but that lane is now crowded, and Hallmark's warm slots are already taken (Lumen brass, Bloom terracotta, Coral coral). Cobalt keeps their *discipline* (cool ground + one signal + code-as-hero + hairlines) and aims the signal at the open electric-blue lane instead. The blue is the differentiator, not a copy.
+> **Why not orange.** GitBook and Firecrawl both converged on orange-as-signal - but that lane is now crowded, and Hallmark's warm slots are already taken (Lumen brass, Bloom terracotta, Coral coral). Cobalt keeps their *discipline* (cool ground + one signal + code-as-hero + hairlines) and aims the signal at the open electric-blue lane instead. The blue is the differentiator, not a copy.
## Axes (diversification)
-- **Paper band** — cool light (`L 98.5%`, hue ~250, very low chroma). An engineered near-white — distinct from Coral's warm grey and from the genre's dark grounds.
-- **Display style** — **grotesk-sans** (Space Grotesk 500/600 — slightly mechanical, tight tracking). Distinct from Geist (Coral) and from every serif/rounded option.
-- **Accent hue** — **electric cobalt** (`oklch(58% 0.20 256)`). High-chroma true blue — reads "API-live," sits clear of Midnight/Lumen's dusky indigos (~250/268). Used as a *signal*, never a flood.
+- **Paper band** - cool light (`L 98.5%`, hue ~250, very low chroma). An engineered near-white - distinct from Coral's warm grey and from the genre's dark grounds.
+- **Display style** - **grotesk-sans** (Space Grotesk 500/600 - slightly mechanical, tight tracking). Distinct from Geist (Coral) and from every serif/rounded option.
+- **Accent hue** - **electric cobalt** (`oklch(58% 0.20 256)`). High-chroma true blue - reads "API-live," sits clear of Midnight/Lumen's dusky indigos (~250/268). Used as a *signal*, never a flood.
## Reference register
GitBook · Firecrawl · Vercel / Geist · Linear · Mintlify · Stripe docs · Resend · Clerk · Railway · Supabase.
-The aesthetic: the developer-product landing and docs home — a cool engineered canvas, one signal accent, **code/terminal/API as the focal element**, hairline structure, a ⌘K-flavoured nav. Never name any of these in the output.
+The aesthetic: the developer-product landing and docs home - a cool engineered canvas, one signal accent, **code/terminal/API as the focal element**, hairline structure, a ⌘K-flavoured nav. Never name any of these in the output.
**Patron-saint reference (internal):** *Vercel's blueprint-and-mono restraint* + *Firecrawl's live request-result credibility move*, recoloured cobalt. When in doubt, ask "does this read like an instrument panel, or like a marketing template?" Keep the former.
## Required dependencies
-1. **Fonts** — **Space Grotesk** (display, 500/600), **Inter** (body, 400/500), **JetBrains Mono** (code + small UPPERCASE labels). All-sans; no serif anywhere. Google Fonts:
+1. **Fonts** - **Space Grotesk** (display, 500/600), **Inter** (body, 400/500), **JetBrains Mono** (code + small UPPERCASE labels). All-sans; no serif anywhere. Google Fonts:
```html
<link href="https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@400;500;600;700&family=Inter:wght@400;500;600&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet" />
```
-2. **A small reveal script** — one `IntersectionObserver` adding `.is-in` (fade + ~10px rise, ease-out ~600ms). Plus a one-shot "type-in" of a single line in the hero code demo, then static.
-3. **A working ⌘K command palette** — a small JS overlay that opens on click **and** ⌘K / Ctrl+K (Esc or backdrop closes; Arrow↑/↓ select; type-to-filter), `role="dialog"` / `aria-modal`, focus-managed, reduced-motion safe. The ⌘K in the nav actually works — Cobalt's signature interactive move.
+2. **A small reveal script** - one `IntersectionObserver` adding `.is-in` (fade + ~10px rise, ease-out ~600ms). Plus a one-shot "type-in" of a single line in the hero code demo, then static.
+3. **A working ⌘K command palette** - a small JS overlay that opens on click **and** ⌘K / Ctrl+K (Esc or backdrop closes; Arrow↑/↓ select; type-to-filter), `role="dialog"` / `aria-modal`, focus-managed, reduced-motion safe. The ⌘K in the nav actually works - Cobalt's signature interactive move.
## The signature moves
-1. **Cool engineered paper, never `#fff`** — `oklch(98.5% 0.004 250)`. Ink is cool charcoal `oklch(24% 0.02 258)`, never `#000`. Body text sits a notch lighter (`oklch(34% 0.018 257)`).
+1. **Cool engineered paper, never `#fff`** - `oklch(98.5% 0.004 250)`. Ink is cool charcoal `oklch(24% 0.02 258)`, never `#000`. Body text sits a notch lighter (`oklch(34% 0.018 257)`).
-2. **Hairlines do the work** — 1px `--color-rule` borders define every surface. **No boxed cards, no drop-shadows** beyond a single barely-there `0 1px 2px` lift on the code card. Depth comes from borders, not blur.
+2. **Hairlines do the work** - 1px `--color-rule` borders define every surface. **No boxed cards, no drop-shadows** beyond a single barely-there `0 1px 2px` lift on the code card. Depth comes from borders, not blur.
-3. **One cobalt signal, used sparingly** (< 5% of any viewport) — the eyebrow tick, a link's hover underline, the one primary button, focus rings, the `200 OK` chip, the active nav item. Everything else is ink-on-cool-white.
+3. **One cobalt signal, used sparingly** (< 5% of any viewport) - the eyebrow tick, a link's hover underline, the one primary button, focus rings, the `200 OK` chip, the active nav item. Everything else is ink-on-cool-white.
-4. **Code is the hero** — a dark **graphite** card (`oklch(22% 0.016 260)`) with a window bar (3 dots + a filename), syntax tokens (cobalt for methods/keys, light for strings, muted for punctuation), and a status chip. One line types in once, then static. Either a **live API request/response** (POST + JSON `200 OK`) or a **terminal** (install + a clean `PASS` run). Title + lede sit LEFT; the demo sits RIGHT — asymmetric, never centred.
+4. **Code is the hero** - a dark **graphite** card (`oklch(22% 0.016 260)`) with a window bar (3 dots + a filename), syntax tokens (cobalt for methods/keys, light for strings, muted for punctuation), and a status chip. One line types in once, then static. Either a **live API request/response** (POST + JSON `200 OK`) or a **terminal** (install + a clean `PASS` run). Title + lede sit LEFT; the demo sits RIGHT - asymmetric, never centred.
-5. **Bordered nav + a working ⌘K palette** — a flush full-width bar, single hairline bottom border, light blur on scroll. Wordmark + 2–3 text links left; a bordered **⌘K** affordance + one solid cobalt button right. The ⌘K **opens a real command palette** (mono search + command rows; click or ⌘K/Ctrl+K; Esc to close) — the page *behaves* like a dev tool, not just looks like one. **Not a floating pill** (softer, and Coral's vocabulary).
+5. **Bordered nav + a working ⌘K palette** - a flush full-width bar, single hairline bottom border, light blur on scroll. Wordmark + 2-3 text links left; a bordered **⌘K** affordance + one solid cobalt button right. The ⌘K **opens a real command palette** (mono search + command rows; click or ⌘K/Ctrl+K; Esc to close) - the page *behaves* like a dev tool, not just looks like one. **Not a floating pill** (softer, and Coral's vocabulary).
-6. **Tight technical radii** — 6px on buttons/inputs, 10px on code cards. Not Coral's soft pills, not 0px brutalism — "drawn with a ruler."
+6. **Tight technical radii** - 6px on buttons/inputs, 10px on code cards. Not Coral's soft pills, not 0px brutalism - "drawn with a ruler."
-7. **Mono labels** — eyebrows, meta, status, kbd hints in JetBrains Mono, UPPERCASE, `0.06em` tracking. The machine-readout voice against the Space Grotesk display.
+7. **Mono labels** - eyebrows, meta, status, kbd hints in JetBrains Mono, UPPERCASE, `0.06em` tracking. The machine-readout voice against the Space Grotesk display.
-8. **One dark graphite band per page** — a single full-bleed dark section (a quickstart, a how-it-works, a watch-mode demo) on `oklch(~20% 0.016 260)` with light cool text and the cobalt accent popping. It gives the page a **light → dark → light** rhythm and a showcase moment. The page's *one* dark beat — Cobalt is a light theme *with* a dark band, never a dark theme.
+8. **One dark graphite band per page** - a single full-bleed dark section (a quickstart, a how-it-works, a watch-mode demo) on `oklch(~20% 0.016 260)` with light cool text and the cobalt accent popping. It gives the page a **light → dark → light** rhythm and a showcase moment. The page's *one* dark beat - Cobalt is a light theme *with* a dark band, never a dark theme.
## Motion
@@ -53,32 +53,32 @@ Composed and sparse. The one hero type-in (plays once). Section reveals fade + r
## Anti-patterns
-- **No orange accent** — the crowded GitBook/Firecrawl lane and a collision with Lumen/Bloom/Coral. Cobalt is blue.
-- **No warm paper** — warm grey is Coral's. Cobalt is cool (hue ~250–258).
+- **No orange accent** - the crowded GitBook/Firecrawl lane and a collision with Lumen/Bloom/Coral. Cobalt is blue.
+- **No warm paper** - warm grey is Coral's. Cobalt is cool (hue ~250-258).
- **No pure `#fff` / `#000`.** Cool near-white paper, cool charcoal ink.
- **No pill / gradient CTAs.** One solid cobalt button at 6px radius + understated typographic links. Name the destination.
-- **No centred-everything hero** (gate 6) — left-biased, title-left / demo-right.
-- **No three-equal-icon-tile feature grid** (gate 3) — vary it (one wide code example + narrower points; asymmetric benchmark figures).
-- **No glassmorphism, no gradient text** (gates), **no aurora/mesh blob, and no background texture/pattern at all** — cool paper + hairlines carry the page; its one dark beat is the graphite band (signature 8), not a background.
+- **No centred-everything hero** (gate 6) - left-biased, title-left / demo-right.
+- **No three-equal-icon-tile feature grid** (gate 3) - vary it (one wide code example + narrower points; asymmetric benchmark figures).
+- **No glassmorphism, no gradient text** (gates), **no aurora/mesh blob, and no background texture/pattern at all** - cool paper + hairlines carry the page; its one dark beat is the graphite band (signature 8), not a background.
## Macrostructure affinity
**Cobalt loves these.**
-- **SaaS / API Product** — hero + quick-start code + feature rows + pricing/CTA *(canonical — cobalt-01)*
-- **Dev-tool / CLI** — terminal hero + install + benchmark figures + docs CTA
-- **Docs home** — a calm index with a search-first nav
-- **Workbench** — the technical, tool-first shape
-- **Marquee** — when the hero is one confident code demo
+- **SaaS / API Product** - hero + quick-start code + feature rows + pricing/CTA *(canonical - cobalt-01)*
+- **Dev-tool / CLI** - terminal hero + install + benchmark figures + docs CTA
+- **Docs home** - a calm index with a search-first nav
+- **Workbench** - the technical, tool-first shape
+- **Marquee** - when the hero is one confident code demo
## Macrostructure rejection
**Cobalt refuses these.**
-- **Letter** — too intimate; Cobalt is a product, not a note
-- **Manifesto** — too loud; Cobalt is calm infrastructure
-- **Photographic / image-led** — Cobalt leads with code, not imagery
-- **Long Document** — prose-led; route warm-editorial instead
+- **Letter** - too intimate; Cobalt is a product, not a note
+- **Manifesto** - too loud; Cobalt is calm infrastructure
+- **Photographic / image-led** - Cobalt leads with code, not imagery
+- **Long Document** - prose-led; route warm-editorial instead
## Voice fixtures
@@ -88,7 +88,7 @@ Declarative, technical, specific. Name the X concretely. No hype adjectives.
- *"One API. Every page."*
- *"From idea to production in an afternoon."*
- *"Type-safe by default. Fast by design."*
-- *"Built to ship — `200 OK` in under 200 ms."*
+- *"Built to ship - `200 OK` in under 200 ms."*
Never any of: *seamless, robust, cutting-edge, leverage, synergy, revolutionary, unlock, supercharge*. Never "click here." Name the endpoint, the command, the number.
@@ -96,10 +96,10 @@ Never any of: *seamless, robust, cutting-edge, leverage, synergy, revolutionary,
| vs | difference |
|---|---|
-| **Coral** (modern-minimal sibling) | Coral is warm-grey paper + warm coral accent + Geist + soft pills + a quiet title/lede hero. Cobalt is cool-white + electric blue + Space Grotesk/JetBrains Mono + tight bordered controls + a live code hero. Same genre, opposite temperature — the rotation walks between them. |
-| **Midnight** (atmospheric) | Both live near hue 250–258, but Midnight is a **dark** canvas (atmospheric, numbered display, typewriter reveals). Cobalt is a **light** engineered canvas (modern-minimal, code hero). Light vs dark settles it instantly. |
+| **Coral** (modern-minimal sibling) | Coral is warm-grey paper + warm coral accent + Geist + soft pills + a quiet title/lede hero. Cobalt is cool-white + electric blue + Space Grotesk/JetBrains Mono + tight bordered controls + a live code hero. Same genre, opposite temperature - the rotation walks between them. |
+| **Midnight** (atmospheric) | Both live near hue 250-258, but Midnight is a **dark** canvas (atmospheric, numbered display, typewriter reveals). Cobalt is a **light** engineered canvas (modern-minimal, code hero). Light vs dark settles it instantly. |
| **Lumen** (atmospheric) | Lumen is a dark (or cool-bone) *apparatus* page with Instrument Serif + an emit/refract focal artefact. Cobalt is light, all-sans, and its focal element is a literal code/API card, not a built light-instrument. |
-| **Aurora** (atmospheric) | Aurora is dark cyan blooms + Sentient serif body. Cobalt is light, hairline-structured, cobalt-on-white — no blooms, no serif. |
+| **Aurora** (atmospheric) | Aurora is dark cyan blooms + Sentient serif body. Cobalt is light, hairline-structured, cobalt-on-white - no blooms, no serif. |
## Test brief expectations
@@ -120,13 +120,13 @@ html, body { overflow-x: clip; }
body { background: var(--color-paper); color: var(--color-ink-2);
font-family: var(--font-body); font-weight: 400; }
-/* Reveal — the whole motion engine */
+/* Reveal - the whole motion engine */
.reveal { opacity: 0; transform: translateY(10px);
transition: opacity .6s cubic-bezier(0.16,1,0.3,1),
transform .6s cubic-bezier(0.16,1,0.3,1); }
.reveal.is-in { opacity: 1; transform: none; }
-/* The code hero — dark graphite card, hairline-framed */
+/* The code hero - dark graphite card, hairline-framed */
.code-card { background: var(--color-graphite); border: 1px solid var(--color-rule-2);
border-radius: 10px; box-shadow: 0 1px 2px oklch(24% 0.02 258 / 0.05);
font-family: var(--font-mono); }
diff --git a/skills/hallmark/references/themes/coral.md b/skills/hallmark/references/themes/coral.md
new file mode 100644
index 0000000..1eaf707
--- /dev/null
+++ b/skills/hallmark/references/themes/coral.md
@@ -0,0 +1,133 @@
+# Theme - Coral
+
+Modern-minimal, warm SaaS register. The page for a **SaaS product, a platform, a billing or payments tool, a B2B dashboard, a startup landing** done in warmth, not cool steel. A warm-grey ground (never pure white), warm charcoal ink (never black), exactly ONE warm coral signal, Geist for everything, and soft pills. The confident-but-human school: calm, generous, typographic. It reads like a product that is easy to trust.
+
+Loaded eagerly by SKILL.md Step 3 when the catalog pick is `coral`. Tokens: `site/css/tokens.css` `[data-theme="coral"]`. Coral is the canonical modern-minimal theme; the rotation walks Coral (warm) to Cobalt (cool).
+
+## Axes (diversification)
+
+- **Paper band** - warm light (`oklch(96.5% 0.005 50)`, hue 50, very low chroma). A warm near-white grey, not Cobalt's cool-white and not Garden's oat-cream.
+- **Display style** - geometric-sans (Geist 600, `-0.025em` tracking). Single-family, distinct from Cobalt's Space Grotesk and from every serif.
+- **Accent hue** - warm coral (`oklch(64% 0.165 28)`). One warm signal, sits clear of Cobalt's electric blue and Garden's leaf green. Used as a signal, never a flood.
+
+## Reference register
+
+Stripe · Linear · Vercel · ElevenLabs · Framer · Raycast · Resend · Mercury. The aesthetic: the confident warm SaaS landing, a two-column typographic hero, generous whitespace, soft pill CTAs, one restrained accent, thin visible borders. Never name any of these in the output.
+
+**Patron-saint reference (internal):** *Stripe's warm restraint*, the monochrome-with-conviction landing warmed one notch off cool grey and given a single coral signal. When in doubt, ask "does this feel like a calm, trustworthy product, or a loud template?" Keep the former.
+
+## Required dependencies
+
+1. **Fonts** - **Geist** (display 600/500, body 400/500) and **Geist Mono** (small UPPERCASE labels, meta, code). One sans family top to bottom; no serif, no second sans. Google Fonts:
+ ```html
+ <link href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=Geist+Mono:wght@400;500;600&display=swap" rel="stylesheet" />
+ ```
+2. **A small reveal script** (optional, restrained) - one `IntersectionObserver` adding `.is-in` (fade + ~8px rise, ease-out ~500ms). Coral is composed; keep reveals subtle or off. No type-in, no autoplay.
+
+## Signature moves
+
+1. **Warm-grey paper, never `#fff`** - `oklch(96.5% 0.005 50)`, hue 50. Layer warm greys: paper-2 `94%`, paper-3 `91%`. Ink is warm near-black `oklch(20% 0.010 35)`, body sits a notch lighter at `oklch(26% 0.012 40)`. The warmth is the whole differentiator from cool siblings, so commit to it and never drift to pure white.
+
+2. **One warm coral signal, used sparingly** (< 5% of any viewport) - `oklch(64% 0.165 28)`. Spend it on the eyebrow tick, a link's hover underline, focus rings, one stat figure, OR a single coral-filled pill. Pick one, do not flood. Everything else is warm-ink-on-warm-grey. Never a coral background wash, never gradient text.
+
+3. **Geist single-family discipline** - display, body, meta, and code all Geist / Geist Mono. Display 600 at `-0.025em`. No serif anywhere, no second sans. Coral is warmed by paper and accent, never by a font swap.
+
+4. **Soft pills** - `999px` (`--radius-pill`) on CTAs and chips; cards at `8px` (`--radius-card`), inputs at `6px`. The rounded, friendly control vocabulary, the opposite of Cobalt's ruler-drawn 6px tightness. This is a load-bearing sibling separator.
+
+5. **Quiet two-column hero** - title plus one confident line LEFT, supporting lede RIGHT (or beneath), primary and secondary pill under it. No code card, no mandatory product screenshot. The page opens calm and typographic, asymmetric to a regular grid, left-aligned. Fit the whole hero in the first viewport.
+
+6. **Ink-filled primary pill + outlined secondary** - the canonical modern-minimal pair, warmed: primary is `--color-ink` filled with `--color-paper` text (or coral-filled with `--color-accent-ink` text, if that is where you spend the one signal from move 2); secondary is a 1px `--color-rule` outlined pill. Always name the destination, never "click here."
+
+7. **Thin visible borders + generous air** - 1px `--color-rule` (`oklch 86%`) on surfaces and section divisions, with a barely-there `--shadow-card` (`0 1px 2px`). Not the 0.5px editorial hairline, not boxed-in. Whitespace does the luxury work: `--section-gap` 6rem, display up to `4.5rem`. The page breathes.
+
+## Motion
+
+Composed and sparse. Optional section reveals fade and rise ~8px, once. Hover: coral underline-grow on nav and links; a 1px border-colour lift to `--color-rule-2` on cards and focusable surfaces. No bounce, no parallax, no autoplay, no type-in. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static and fully visible.
+
+## Anti-patterns
+
+- **No cool paper** - cool grey or blue is Cobalt's. Coral is warm (hue 35-50).
+- **No pure `#fff` / `#000`** - the genre allows white, but Coral commits to warm grey paper and warm charcoal ink. That commitment is its identity.
+- **No code / API / terminal hero** - that is Cobalt's move. Coral leads typographically.
+- **No second typeface** - Geist only. No serif, no Space Grotesk, no mono-as-display.
+- **No tight ruler radii** - Coral is soft pills (999px), not 6px bordered controls.
+- **No coral flood, gradient, or coral background wash** - the accent is a < 5% signal.
+- **No glassmorphism, no aurora / mesh blob, no background texture** - warm paper, thin borders, and whitespace carry the page.
+- **No centred-everything hero** - left-biased two-column.
+
+## Macrostructure affinity / rejection
+
+**Coral loves:**
+- **Stat-Led** - a warm metrics page (teams onboarded, uptime, volume processed)
+- **Feature-stack / SaaS** - hero + feature rows + pricing + CTA
+- **Bento Grid** - warm, restrained product-surface tiles
+- **Marquee Hero** - when the hero is one confident typographic statement
+- **Conversational FAQ** - a calm, human support voice
+
+**Coral refuses:**
+- **Photographic / image-led** - Coral leads with type and whitespace, not imagery
+- **Manifesto** - too loud; Coral is a calm product, not a proclamation
+- **Long Document** - prose-led; route warm-editorial (Garden) instead
+- **Specimen / type-specimen** - that is the specimen theme's territory
+
+## Voice fixtures
+
+Declarative, warm, specific. Name the X. No hype.
+- *"Billing that just works, so you can build."*
+- *"One dashboard. Every metric that matters."*
+- *"From first commit to first customer."*
+- *"Built for teams who ship."*
+- *"Payments infrastructure, minus the friction."*
+
+Never: *seamless, robust, cutting-edge, leverage, synergy, revolutionary, unlock, supercharge*. Never "click here." Name the number, the product, the outcome.
+
+## How Coral differs from neighbouring themes
+
+| vs | what settles it instantly |
+|---|---|
+| **Cobalt** (modern-minimal sibling) | Coral is warm-grey paper + coral accent + Geist + soft 999px pills + a quiet typographic hero. Cobalt is cool-white + electric blue + Space Grotesk / JetBrains Mono + tight 6px bordered controls + a live code hero. Same genre, opposite temperature; the rotation walks between them. |
+| **Garden** (warm paper neighbour) | Both are warm and light, but Garden is oat-cream botanical *editorial* with green ink and a hand-built specimen artefact. Coral is warm-*grey* modern-minimal SaaS, all Geist, coral signal. Register (product vs field-journal) settles it. |
+| **Lumen** (warm-family accent) | Lumen is a premium AI *apparatus* page with a classical serif headline and a built light-instrument. Coral is light, all-sans SaaS with soft pills and no artefact. Serif + apparatus vs sans + pills settles it. |
+
+## Test brief expectations
+
+Coral is a candidate when the brief mentions:
+- *SaaS · platform · billing · payments · dashboard · B2B · startup · product landing · pricing · analytics · fintech · workflow · team tool · onboarding · trust · warm · human*
+- Product categories: *SaaS · fintech · B2B platform · startup landing · dashboard · billing/payments*
+- Emotional tone: *warm · calm · confident · trustworthy · human · premium-restrained*
+
+Warmth plus product-not-code routes here. If the brief wants to *show the code* or reads cool and technical, route Cobalt; if it is editorial or image-led, route elsewhere.
+
+## Build hint
+
+```css
+html, body { overflow-x: clip; }
+body { background: var(--color-paper); color: var(--color-ink-2);
+ font-family: var(--font-body); font-weight: 400; }
+
+/* Display - Geist 600, tight */
+.display { font-family: var(--font-display); font-weight: var(--display-weight);
+ letter-spacing: var(--tracking-display); font-size: var(--text-display); }
+
+/* Reveal - restrained, optional */
+.reveal { opacity: 0; transform: translateY(8px);
+ transition: opacity .5s cubic-bezier(0.16,1,0.3,1),
+ transform .5s cubic-bezier(0.16,1,0.3,1); }
+.reveal.is-in { opacity: 1; transform: none; }
+
+/* Soft pills - the control vocabulary */
+.btn { border-radius: var(--radius-pill); }
+.btn--primary { background: var(--color-ink); color: var(--color-paper); }
+.btn--secondary { border: 1px solid var(--color-rule); color: var(--color-ink); }
+
+/* One coral signal + mono labels */
+.eyebrow, .link:hover { color: var(--color-accent); }
+.label { font-family: var(--font-mono); text-transform: uppercase;
+ letter-spacing: var(--tracking-label); }
+
+@media (prefers-reduced-motion: reduce) {
+ .reveal { opacity: 1; transform: none; transition: none; }
+}
+```
+
+Plus the Geist + Geist Mono link and the small reveal script.
diff --git a/skills/hallmark/references/themes/editorial.md b/skills/hallmark/references/themes/editorial.md
new file mode 100644
index 0000000..b4cdd4a
--- /dev/null
+++ b/skills/hallmark/references/themes/editorial.md
@@ -0,0 +1,131 @@
+# Theme - Editorial
+
+The contemporary magazine, set for the screen. The page for a **culture or fashion magazine, a design annual, an interview series, a longform feature, a considered content-marketing piece** - the modern editorial-spread school, executed on **warm cream with a heavy condensed-sans headline answered by a Playfair Display italic aside**. Inter Tight 800 crashes tight against the left margin (tracking `-0.04em`); a serif-italic pull-quote answers it; hairline rules and Roman-numeral folios carry the structure. It reads like a well-art-directed feature: stylish, type-forward, warm but crisp.
+
+Loaded eagerly by SKILL.md Step 3 whenever the catalog pick is `editorial`. The OKLCH palette + font stack live in [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="editorial"]`. No canonical example folder yet - build to this spec.
+
+## Axes (diversification)
+
+- **Paper band** - warm cream, light (`--color-paper: oklch(94% 0.020 75)`). A hair darker and a hair cooler than Specimen's oat (96%, hue 80); never `#fff`, never a neutral grey.
+- **Display style** - **display-condensed sans** (Inter Tight, `--display-weight: 800`). A heavy, tight grotesque set at `--tracking-display: -0.04em` - magazine-shaped. Never a serif display; the serif appears only as italic emphasis.
+- **Accent hue** - **warm coral** (`--color-accent: oklch(60% 0.160 35)`). Pinker and softer than Specimen's signal orange, far brighter than Newsprint's dried brick. A signal on marks and fills, never a flood.
+
+## Reference register
+
+The Gentlewoman · Racquet · MOLD · AIGA Eye on Design · Dazed · i-D · Wallpaper* · The Face · Are.na blog · Family Style.
+
+The aesthetic: the contemporary art-directed feature spread - a tight grotesque headline against a Didone italic pull-quote, cream margins, hairline furniture, one warm mark. **Never name any of these in the output.**
+
+**Patron-saint reference (internal):** *a culture magazine's feature opener* - Inter Tight slammed left, a Playfair italic aside in the margin, mono folios, one coral tick. When in doubt ask "does this read like an art-directed feature, or a marketing template?" Keep the former.
+
+## Required dependencies
+
+1. **Fonts** - **Inter Tight** (display, 700/800), **Inter** (body, 400/500/600), **Playfair Display** (italic emphasis + pull-quotes, 400/500/600 italic), **Geist Mono** (folios, labels, meta). Google Fonts:
+ ```html
+ <link rel="preconnect" href="https://fonts.googleapis.com">
+ <link href="https://fonts.googleapis.com/css2?family=Inter+Tight:wght@600;700;800&family=Inter:wght@400;500;600&family=Playfair+Display:ital,wght@0,500;1,400;1,500;1,600&family=Geist+Mono:wght@400;500&display=swap" rel="stylesheet">
+ ```
+2. **A small reveal script** - one `IntersectionObserver` adding `.is-in` (fade + ~10px rise, `--ease-out`, ~600ms). Optional one-shot: a single pull-quote that settles once, then static. No other required JS - Editorial is a reading page, not a tool.
+
+## Signature moves
+
+1. **Two-axis type: heavy condensed sans display + Playfair italic aside.** THE move. Headlines are Inter Tight `--display-weight: 800` at `--text-display: clamp(2.5rem, 5vw + 0.75rem, 4.75rem)`, `--tracking-display: -0.04em`, slammed left. Inside a head, or as a pull-quote, single words or a clause switch to **Playfair Display italic** (`--font-serif`). The grotesque-against-Didone-italic tension is the whole voice. Body stays plain Inter.
+
+2. **Warm cream paper, cool-tilted ink, never `#fff` / `#000`.** Paper `oklch(94% 0.020 75)`; the deepest ink `--color-ink: oklch(15% 0.014 280)` carries a faint **cool** tilt (hue 280) - printed-black on warm cream. Body sits up at `--color-ink-2: oklch(28% 0.014 55)`, meta at `--color-muted: oklch(48% 0.014 60)` (warm). The cool ink over warm paper is a deliberate print detail, not a mistake.
+
+3. **One coral signal, < 5% of any viewport.** `--color-accent: oklch(60% 0.160 35)` on the eyebrow tick, a link underline, one CTA, a folio mark, `--color-focus: oklch(62% 0.160 35)` rings. On a coral **fill** (a tag, a kicker block) text is `--color-accent-ink: oklch(98% 0.005 70)` (near-white). Coral never floods a full band and never fills behind body type.
+
+4. **Square everything - radius 0.** `--radius-card: 0`, `--radius-pill: 0`, `--radius-input: 0`. Buttons, tags, inputs, kicker blocks are sharp rectangles. Magazine furniture is set in square blocks, never pills or soft radii.
+
+5. **0.5px hairlines + asymmetric grid, no cards.** `--rule-card: 0.5px` (`--color-rule: oklch(80% 0.018 70)`); heavier splits use `--color-rule-2: oklch(64% 0.014 68)`. Columns run asymmetric (2:5, 3:7), the hero is left-biased, `--section-gap: 6rem`, `--section-head-gap: 1.5rem`. Structure is rules and columns - **no boxed cards, no shadow, no blur**.
+
+6. **Roman-numeral marginalia + mono folios.** Sections carry Roman numerals (I, II, III) and Geist Mono labels (`--font-mono`, UPPERCASE, `--tracking-label: 0.10em`, `--color-muted`) marching down the margin like a contents/folio system. The mono machine-voice against the tight display is the second register.
+
+7. **Serif-italic pull-quotes hung between hairlines.** Playfair Display italic set large is the pull-quote and emphasis register - it hangs between a top-and-bottom hairline with a coral indent, never in a box. The serif is italic emphasis only, never the display face (global rule).
+
+## Motion
+
+Quiet and composed. One orchestrated entrance: section reveals fade + rise (`--ease-out`, ~600ms). Optionally a single pull-quote that settles once, then holds. Hover: coral underline-grow on links; a hairline shift toward coral on focusable surfaces. No bounce, no parallax, no autoplay. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static and fully visible.
+
+## Anti-patterns
+
+- **No serif display face.** Inter Tight (sans) carries every headline; Playfair appears only as italic emphasis. A serif headline reads as Newsprint / Specimen / Atelier.
+- **No rounded corners, pills, or shadows.** Radius is 0 everywhere; soft pills are modern-minimal (Coral) vocabulary.
+- **No pure `#fff` paper / `#000` ink.** Warm cream, cool-tilted near-black.
+- **No orange or brick drift.** Keep the accent coral (hue 35, chroma 0.16) - not Specimen's redder orange, not Newsprint's dark brick, not terracotta.
+- **No centred masthead.** That is Newsprint's broadsheet move; Editorial is left-biased and asymmetric.
+- **No dark ground.** Editorial is light cream; a dark statement page is Manifesto.
+- **No ALL-CAPS Anton shout.** Inter Tight runs title-case and tight, magazine-modern, not a broadside.
+- **No glassmorphism, gradient text, mesh/aurora blob, or background texture.** Cream + 0.5px hairlines + one coral mark carry it.
+
+## Macrostructure affinity / rejection
+
+**Editorial loves:** **Long Document** *(the feature essay - drop cap, columns, pull-quotes)* · **Photographic** (a modern feature opener: photo + tight-sans headline crashing over it) · **Quote-Led** (Playfair italic pull-quotes are native furniture) · **index-first** (a magazine contents / issue index) · **Letter** (an editor's note).
+
+**Editorial refuses:** **Workbench / component-playground** (tool-first apparatus, route Cobalt) · **Bento Grid** (modular product tiles, too SaaS for a spread) · **Stat-Led** (numbers-first dashboard) · **Conversational FAQ** (too chatty; the feature is composed, not a chat).
+
+## Voice fixtures
+
+Considered, contemporary, lightly literary. Verbs over adjectives; name the piece, the issue, the byline.
+
+- *"The issue, set in tight type."*
+- *"A feature, composed like a spread."*
+- *"Grotesque headline. Didone aside. One coral mark."*
+- *"Read it the way it was set: hairlines, columns, cream margins."*
+- *"Culture, filed and art-directed."*
+
+Never any of: *seamless, robust, cutting-edge, leverage, synergy, elevate, unlock, supercharge, curated, storytelling journey*. Never "click here" - name the piece or the section.
+
+## How Editorial differs from neighbouring themes
+
+| vs | what settles it instantly |
+|---|---|
+| **Specimen** (warm-paper editorial sibling) | Specimen shows a **serif display** at scale (Fraunces light 340) over sans body, signal orange. Editorial shows a **heavy condensed sans** display (Inter Tight 800) with Playfair as an italic garnish, coral. Thin-serif-head vs heavy-sans-head. |
+| **Newsprint** (warm-paper broadsheet) | Newsprint is all-serif (Playfair Didone head + Crimson body), a **centred** masthead, columns, brick. Editorial is sans head + sans body, **left-biased** asymmetric hero, coral. Broadsheet-serif vs magazine-sans. |
+| **Manifesto** (condensed-display sibling) | Both use a condensed display, but Manifesto is **dark** ground + Anton **UPPERCASE** + red. Editorial is **light** cream + Inter Tight **title-case** + coral. Light-vs-dark and caps-vs-titlecase settle it. |
+
+## Test brief expectations
+
+Editorial is a candidate when the brief mentions:
+
+- *magazine · editorial · feature · culture · fashion · design annual · interview series · longform · publication · issue · contemporary · art direction · profile · lookbook · brand story · content · considered*
+- Product categories: *culture / fashion magazine · digital publication · design annual · interview series · editorial content site · brand editorial / content-marketing · agency journal*
+- Emotional tone: *considered · contemporary · stylish · type-forward · confident · magazine-modern · warm-but-crisp*
+
+Route elsewhere: broadsheet / journalism -> Newsprint; type foundry / quiet portfolio -> Specimen; loud declaration -> Manifesto; dev / API -> Cobalt.
+
+## Build hint
+
+The first lines of CSS establish Editorial's anchor moves:
+
+```css
+html, body { overflow-x: clip; }
+body { background: var(--color-paper); color: var(--color-ink-2);
+ font-family: var(--font-body); font-weight: 400; }
+
+/* Two-axis display: heavy condensed sans, tight, slammed left */
+.display { font-family: var(--font-display); font-weight: var(--display-weight); /* 800 */
+ font-size: var(--text-display); letter-spacing: var(--tracking-display); /* -0.04em */
+ color: var(--color-ink); text-align: left; text-wrap: balance; }
+.display em, .pull { font-family: var(--font-serif); font-style: italic; /* Playfair aside */
+ font-weight: 500; letter-spacing: var(--tracking-tight); }
+
+/* Mono folio + Roman-numeral marginalia */
+.folio { font-family: var(--font-mono); text-transform: uppercase;
+ letter-spacing: var(--tracking-label); color: var(--color-muted); }
+
+/* Square everything, hairlines carry structure */
+.card { border: var(--rule-card) solid var(--color-rule); border-radius: var(--radius-card); } /* 0.5px, 0 */
+.tag { background: var(--color-accent); color: var(--color-accent-ink); border-radius: 0; } /* one coral fill */
+
+/* The one coral signal */
+a { text-decoration-color: var(--color-accent); }
+:focus-visible { outline: 2px solid var(--color-focus); }
+
+.reveal { opacity: 0; transform: translateY(10px);
+ transition: opacity .6s var(--ease-out), transform .6s var(--ease-out); }
+.reveal.is-in { opacity: 1; transform: none; }
+@media (prefers-reduced-motion: reduce) { .reveal { opacity: 1; transform: none; transition: none; } }
+```
+
+Plus the Inter Tight + Inter + Playfair Display + Geist Mono link and the small reveal script.
diff --git a/skills/hallmark/references/themes/garden.md b/skills/hallmark/references/themes/garden.md
new file mode 100644
index 0000000..d3358f6
--- /dev/null
+++ b/skills/hallmark/references/themes/garden.md
@@ -0,0 +1,126 @@
+# Theme - Garden
+
+Warm-botanical editorial. The page for a **small farm, apiary, cidery, seed company, herbalist, nursery, or single-maker food brand** - the naturalist field-journal / herbarium-sheet school. A **warm oat-cream ground** (`oklch(95.5% 0.022 92)`, never grey-sage), **botanical green ink** (`oklch(24% 0.052 152)` - a warm near-black green, never `#000`), one **living leaf-green** accent, and a **hand-built botanical specimen** as the focal artefact. It reads like a well-kept field notebook: honest, seasonal, grown-not-manufactured.
+
+Loaded eagerly by SKILL.md Step 3 when the catalog pick is `garden`. Tokens: [`site/css/tokens.css`](../../../../site/css/tokens.css) `[data-theme="garden"]`. Canonical build: [`site/examples/garden-01/`](../../../../site/examples/garden-01/) (Hollowback Apiary - single-ridge Vermont honey, catalogue of seasonal lots).
+
+## Axes (diversification)
+
+- **Paper band** - light warm (`L 95.5%`, hue 92, low chroma). Oat cream, faintly honeyed. Distinct from the genre's cool/bone grounds and from any grey-sage; tint everything toward oat, never toward slate.
+- **Display style** - **roman serif** (Young Serif, one organic weight `400`, `--display-style: normal`). Chunky, slab-ish, hand-cut. Never italic in headers (global rule); Young Serif ships one weight, so vary by size, not weight.
+- **Accent hue** - **chromatic leaf-green** (`oklch(47% 0.13 140)`, primary) with an **earthy clay / terracotta** pop (`oklch(54% 0.14 46)`, secondary). Living, chlorophyll-real - sits clear of any cool teal or corporate emerald.
+
+## Reference register
+
+Aesop . Kinfolk . Cereal . Frama . Le Labo . Mast . Toast Ale . Ballymaloe . small-CSA and single-apiary brand sites.
+
+The aesthetic: the naturalist's brand story - warm paper, roman serif, a hand-drawn or hand-built botanical specimen, seasonal honesty, prose that smells of the field. **Patron-saint reference (internal):** *a pressed-herbarium sheet* - one specimen, a hand-lettered mono tag, a warm neutral mount. When in doubt ask "does this read like a field journal, or a supermarket label?" Keep the former. Never name any of these in the output.
+
+## Required dependencies
+
+1. **Fonts** - **Young Serif** (display, one weight), **Hanken Grotesk** (body, 400/500/600/700), **Newsreader** (readable text-serif for long prose - Young Serif is display-only), **Geist Mono** (specimen tags + meta labels). Google Fonts:
+ ```html
+ <link href="https://fonts.googleapis.com/css2?family=Young+Serif&family=Hanken+Grotesk:wght@400;500;600;700&family=Newsreader:opsz,[email protected],400;6..72,500&family=Geist+Mono:wght@400;500&display=swap" rel="stylesheet">
+ ```
+2. **A small reveal script** - one `IntersectionObserver` adding an in-view class (fade + short rise, staggered by `--i`, <=500ms, reveal-once/unobserve). Reduced-motion ships static + fully visible.
+3. **Any form-as-CTA** (a standing-order / harvest-note signup) gets honest idle -> loading -> success/error states narrated in `aria-live`, per the canonical build's standing-jar form.
+
+## Signature moves
+
+1. **Oat-cream paper, botanical-green ink** - background `--color-paper` `oklch(95.5% 0.022 92)`; body ink `--color-ink-2` `oklch(33% 0.05 150)`, headline ink `--color-ink` `oklch(24% 0.052 152)`. Every neutral carries a green cast (hue 90-152). Never a pure grey, never `#000`/`#fff`. Set `font-variant-numeric: oldstyle-nums`.
+
+2. **Young Serif display, sized not weighted** - `--font-display` at `--display-weight: 400`, roman only. Hierarchy comes from size (`--text-display` clamp to 5rem) and `--tracking-display: -0.006em`, never from italic or a bolder cut. A drop-of-honey slab feel, hand-cut, not a refined Didone.
+
+3. **A hand-built botanical specimen is the hero** - the focal artefact is drawn in pure CSS + hand-authored SVG (a honeycomb wash, a glass jar of amber honey, corked vials of each pour), never a stock photo. It is the thing being sold, anchored not decorative. Tier-A CSS + Tier-B SVG craft carries the page's imagery.
+
+4. **Herbarium specimen tags** - `--font-label` (Geist Mono), UPPERCASE, `--tracking-label: 0.14em` for eyebrows, lot codes, dates, meta. The dry machine-tag voice mounted against the warm Young Serif display - like pencil on a pressed-plant sheet.
+
+5. **Leaf-green as a signal, clay as a warm pop** - `--color-accent` `oklch(47% 0.13 140)` on links, the one solid button, focus rings, active nav - under 5% of any viewport. `--color-accent-2` `oklch(54% 0.14 46)` (clay/terracotta) appears mostly *inside the craft* (honey fill, cork, ripe accents), rarely as UI chrome. Two hues, disciplined.
+
+6. **Botanical tint bands, not boxed cards** - soft full-bleed section bands use `--tint-moss` `oklch(47% 0.13 140 / 0.10)` or `--tint-clay` `oklch(54% 0.14 46 / 0.10)`. Structure is hairlines (`--color-rule` soft green-grey, `--color-rule-2` mossy) + generous whitespace, not drop-shadowed boxes.
+
+7. **Sprig ornaments beside section titles** - a small hand-authored SVG leaf-sprig or fleuron sits inline before an `<h2>`, drawn in `--color-rule-2`/accent. The broadsheet fleuron, botanised.
+
+8. **Prose set in Newsreader** - long provenance/story copy uses `--font-serif` (Newsreader) at `--measure: 58ch`, readable and warm. Young Serif never runs as body. The build's default nav is **N6 newspaper masthead** (dateline + wordmark + double rule) and footer is **Ft6 letter close** (roman signoff + postscript) - broadsheet head, personal-letter foot.
+
+## Motion
+
+Quiet and seasonal. One orchestrated entrance: staggered reveal of hero lines and catalogue cards (fade + <=10px rise, `--i` stagger, <=500ms, reveal-once). Optional single hover behaviour on a specimen (a jar-fill rise). All transform/opacity only - no bounce, no parallax, no autoplay. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static and fully visible.
+
+## Anti-patterns
+
+- **No grey-sage or slate paper.** Garden's ground is warm oat (hue ~92); a cool grey-green kills it.
+- **No pure `#000`/`#fff`** - green-cast ink, oat paper. Gate 7.
+- **No stock photography** - the imagery is hand-built CSS/SVG botanical craft. A real honey photo reads as a supermarket label.
+- **No italic Young Serif headers** and no faux-bold - one roman weight, vary by size (global rule + one-weight face).
+- **No cool teal / corporate emerald accent** - the green must read chlorophyll-living (hue ~140), not fintech.
+- **No boxed drop-shadow cards or card-in-card** - hairlines + tint bands. Gate 4.
+- **No floating pill nav / gradient-on-pill CTA** - broadsheet masthead + one solid leaf-green button; pill fine, gradient not.
+- **No centred-everything hero** - copy left, specimen right (or asymmetric). Gate 6.
+
+## Macrostructure affinity / rejection
+
+**Garden loves:** Catalogue (seasonal-lot / product-card grid - *canonical, garden-01*) . Long Document (provenance / field-story prose) . Letter (the maker's note home) . Photographic-as-specimen (hand-built botanical illustration standing in for photos) . Stat-Led (small honest facts: hives, elevation, forage).
+
+**Garden refuses:** Workbench / component-playground (too mechanical for a farm) . Bento Grid (too gridded and product-y - Garden breathes) . Marquee Hero of pure kinetic type (fights the quiet) . Specimen-as-type-specimen (that is a sibling's job; Garden's specimen is botanical, not a glyph table).
+
+## Voice fixtures
+
+- *"Honey that tastes like one hillside."*
+- *"Nine hives. One ridge. No blending."*
+- *"A poor June is a smaller June, and the summer lot says so."*
+- *"Cold-spun, strained once, poured by hand the same week."*
+- *"When a pour is gone it is gone until the same flowers come round again."*
+
+Never any of: *artisanal, curated, elevated, handcrafted-with-love, farm-to-table, sustainable-first, wellness, small-batch* as a hollow badge. Say the ridge, the flower, the pour date, the number of jars.
+
+## How Garden differs from neighbouring themes
+
+| vs | what settles it instantly |
+|---|---|
+| **Almanac** (editorial, field-reference sibling) | Almanac is a dense data/ledger register (tables, monospace almanac). Garden is a warm brand-story with a hand-built botanical specimen and a living leaf-green accent - narrative, not tabular. |
+| **Atelier** (editorial, quiet-personal sibling) | Atelier is a restrained studio/letter voice on a neutral ground. Garden shares the letter-close warmth but commits to green ink, oat paper, and chunky Young Serif - agrarian, not gallery-quiet. |
+| **Specimen** (editorial, roman-display sibling) | Specimen's "specimen" is a type/glyph specimen. Garden's specimen is a *botanical* object (jar, vial, comb) and its accent is chromatic leaf-green - a farm, not a foundry. |
+
+## Test brief expectations
+
+Candidate when the brief mentions: *farm . apiary . honey . cidery . orchard . seed . nursery . herbalist . botanical . tea . preserves . single-origin . seasonal . harvest . small-maker . CSA . provenance . grown . field . homestead*.
+Product categories: *artisan food/drink . apiary . farm brand . seed co . nursery . herbal / botanical goods . maker story.*
+Emotional tone: *warm . honest . seasonal . rooted . unhurried . hand-made . naturalist.*
+Briefs that are technical, corporate, cool, or image-heavy-with-photos route elsewhere.
+
+## Build hint
+
+```css
+html, body { overflow-x: clip; }
+body { background: var(--color-paper); color: var(--color-ink-2);
+ font-family: var(--font-body); font-weight: 400;
+ font-variant-numeric: oldstyle-nums; }
+
+/* Young Serif display - roman, one weight, sized not bolded */
+.section__title, .hero__title {
+ font-family: var(--font-display); font-weight: var(--display-weight);
+ font-style: var(--display-style); letter-spacing: var(--tracking-tight);
+ color: var(--color-ink); line-height: var(--lh-tight); }
+
+/* Herbarium specimen tag - dry mono against the warm serif */
+.tag, .eyebrow { font-family: var(--font-label); text-transform: uppercase;
+ letter-spacing: var(--tracking-label); color: var(--color-muted); }
+
+/* Tint band + hairline, never a boxed card */
+.band--moss { background: var(--tint-moss); }
+.rule { border-top: 1px solid var(--color-rule); }
+
+/* One leaf-green button; clay stays on the craft */
+.btn--solid { background: var(--color-accent); color: var(--color-accent-ink); }
+
+/* Reveal - the whole motion engine */
+.reveal { opacity: 0; transform: translateY(10px);
+ transition: opacity .5s ease, transform .5s ease;
+ transition-delay: calc(var(--i, 0) * 70ms); }
+.reveal.is-in { opacity: 1; transform: none; }
+@media (prefers-reduced-motion: reduce) {
+ .reveal { opacity: 1; transform: none; transition: none; } }
+```
+
+Plus the Young Serif + Hanken Grotesk + Newsreader + Geist Mono link and the small reveal script. Mirror [`site/examples/garden-01/`](../../../../site/examples/garden-01/).
diff --git a/skills/hallmark/references/themes/hum.md b/skills/hallmark/references/themes/hum.md
index 51fe8e8..e254bd6 100644
--- a/skills/hallmark/references/themes/hum.md
+++ b/skills/hallmark/references/themes/hum.md
@@ -1,52 +1,52 @@
-# Theme — Hum
+# Theme - Hum
-The playful, vibrant, **alive** register. Cream paper, multi-accent palette (pear-yellow primary, sky-cyan secondary, coral-red pop), rounded sans typography, generous radii, soft lifting shadows, mandatory hover-and-on-paint motion. Hum is the catalog theme for products that don't take themselves too seriously — daily-curiosity apps, learning platforms, habit trackers, friendship apps, kids' tools, indie creative software. Sites that should feel like the room is warm and someone smart is smiling.
+The playful, vibrant, **alive** register. Cream paper, multi-accent palette (pear-yellow primary, sky-cyan secondary, coral-red pop), rounded sans typography, generous radii, soft lifting shadows, mandatory hover-and-on-paint motion. Hum is the catalog theme for products that don't take themselves too seriously - daily-curiosity apps, learning platforms, habit trackers, friendship apps, kids' tools, indie creative software. Sites that should feel like the room is warm and someone smart is smiling.
-Loaded eagerly by SKILL.md Step 3 whenever the catalog pick is `hum`. The palette + font stack live in [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="hum"]`. This file carries signature moves, motion direction, voice fixtures, anti-patterns, and how Hum holds its identity against neighbouring themes. Hum is the catalog's only playful theme — its closest siblings are Coral (single-accent restraint, modern-minimal) and Bloom (warm-light atmospheric), not another playful register.
+Loaded eagerly by SKILL.md Step 3 whenever the catalog pick is `hum`. The palette + font stack live in [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="hum"]`. This file carries signature moves, motion direction, voice fixtures, anti-patterns, and how Hum holds its identity against neighbouring themes. Hum is the catalog's only playful theme - its closest siblings are Coral (single-accent restraint, modern-minimal) and Bloom (warm-light atmospheric), not another playful register.
## Axes (diversification)
-- **Paper band** — light (`L 97%`), warm cream tinted toward pear-yellow hue (~95°). Yellower and brighter than any other warm-paper theme in the catalog — never the rose-warm or oat-warm cream of the editorial themes.
-- **Display style** — **rounded-sans** (new axis value, Plus Jakarta Sans / Open Runde register — rounded humanist letterforms with closed apertures). Distinct from geometric-sans (Manifesto), italic-serif, classical-serif (Lumen), and other catalog options.
-- **Accent hue** — **multi** (new axis value — three accents on stage simultaneously: pear-yellow `H 95`, sky-cyan `H 235`, coral-red `H 18`). Distinct from every single-accent or duo-tone theme in the catalog.
+- **Paper band** - light (`L 97%`), warm cream tinted toward pear-yellow hue (~95°). Yellower and brighter than any other warm-paper theme in the catalog - never the rose-warm or oat-warm cream of the editorial themes.
+- **Display style** - **rounded-sans** (new axis value, Plus Jakarta Sans / Open Runde register - rounded humanist letterforms with closed apertures). Distinct from geometric-sans (Manifesto), italic-serif, classical-serif (Lumen), and other catalog options.
+- **Accent hue** - **multi** (new axis value - three accents on stage simultaneously: pear-yellow `H 95`, sky-cyan `H 235`, coral-red `H 18`). Distinct from every single-accent or duo-tone theme in the catalog.
## Reference register
-Brilliant.org (post-2024 brand refresh — Koto's pear-yellow + cream + custom CoFo Sans) · Duolingo (the named-color system: Feather Green, Macaw, Cardinal, Bee, Fox, Beetle, Humpback) · PostHog (Max the hedgehog, cream + red + blue, Open Runde + Squeak + Loud Noises) · tldraw (Shantell Sans with `Bounce` axis) · Cosmos (color-shift-on-hover) · Cluely (Mac OS chrome as set dressing) · Liveblocks (cursor-presence done right) · Hover.dev (the working dictionary of spring-physics interactions) · Each.place, Tella (vibrant gradient surfaces).
+Brilliant.org (post-2024 brand refresh - Koto's pear-yellow + cream + custom CoFo Sans) · Duolingo (the named-color system: Feather Green, Macaw, Cardinal, Bee, Fox, Beetle, Humpback) · PostHog (Max the hedgehog, cream + red + blue, Open Runde + Squeak + Loud Noises) · tldraw (Shantell Sans with `Bounce` axis) · Cosmos (color-shift-on-hover) · Cluely (Mac OS chrome as set dressing) · Liveblocks (cursor-presence done right) · Hover.dev (the working dictionary of spring-physics interactions) · Each.place, Tella (vibrant gradient surfaces).
-The aesthetic to match: cream paper (never pure white), a single character or mark that *reacts* to user actions, generous rounded surfaces, big confident counters in rounded display, soft drop shadows that lift on hover, multi-accent sections that don't fight (because each accent has its own surface). Pear-yellow + cream is the **calibration** combination — anything that reads further saturated than that has gone too vibrant; anything that reads more muted has lost the playfulness.
+The aesthetic to match: cream paper (never pure white), a single character or mark that *reacts* to user actions, generous rounded surfaces, big confident counters in rounded display, soft drop shadows that lift on hover, multi-accent sections that don't fight (because each accent has its own surface). Pear-yellow + cream is the **calibration** combination - anything that reads further saturated than that has gone too vibrant; anything that reads more muted has lost the playfulness.
**Patron-saint reference (internal):** *Brilliant.org's Koji moment* + *PostHog's "if it could belong to any SaaS, it isn't PostHog enough" rule*. When in doubt about restraint, ask the inverse: *"is there a single moment on this page that would not exist if we weren't trying to feel alive?"* If no, the page is too quiet for Hum.
## Palette
-Multi-accent. No single accent dominates — different surfaces use different accents, and the contrast between sections is part of the typographic rhythm.
+Multi-accent. No single accent dominates - different surfaces use different accents, and the contrast between sections is part of the typographic rhythm.
-- `--color-paper: oklch(97% 0.012 95)` — cream, slight pear-yellow pull (Brilliant's calibration)
-- `--color-paper-2: oklch(94% 0.016 95)` — tinted band (yellower)
-- `--color-paper-3: oklch(91% 0.020 95)` — deeper hover
-- `--color-ink: oklch(20% 0.012 250)` — near-black with cool tilt (PostHog's `#151515` discipline — never pure black)
-- `--color-accent: oklch(86% 0.18 95)` — pear-yellow (primary; CTA, streaks, primary character mark)
-- `--color-accent-2: oklch(66% 0.18 235)` — sky-cyan (secondary; links, hover tints, illustrations)
-- `--color-accent-3: oklch(68% 0.24 18)` — coral-red (pop; only used at high-energy single moments — streak completion, badge, the one big number)
-- `--color-mint: oklch(80% 0.16 150)` — soft green (used sparingly — success states, secondary tags)
-- `--color-lavender: oklch(74% 0.16 305)` — used sparingly (tag chips, decorative)
+- `--color-paper: oklch(97% 0.012 95)` - cream, slight pear-yellow pull (Brilliant's calibration)
+- `--color-paper-2: oklch(94% 0.016 95)` - tinted band (yellower)
+- `--color-paper-3: oklch(91% 0.020 95)` - deeper hover
+- `--color-ink: oklch(20% 0.012 250)` - near-black with cool tilt (PostHog's `#151515` discipline - never pure black)
+- `--color-accent: oklch(86% 0.18 95)` - pear-yellow (primary; CTA, streaks, primary character mark)
+- `--color-accent-2: oklch(66% 0.18 235)` - sky-cyan (secondary; links, hover tints, illustrations)
+- `--color-accent-3: oklch(68% 0.24 18)` - coral-red (pop; only used at high-energy single moments - streak completion, badge, the one big number)
+- `--color-mint: oklch(80% 0.16 150)` - soft green (used sparingly - success states, secondary tags)
+- `--color-lavender: oklch(74% 0.16 305)` - used sparingly (tag chips, decorative)
**Three-rule for accents:**
1. Each accent owns its own type of surface. Pear = primary action. Cyan = link / hover-tint. Coral = single high-energy moment per page.
2. Accents never blend in gradients (no pear-to-cyan gradient anywhere).
-3. Mint and lavender are *occasional* — never more than one of each per page.
+3. Mint and lavender are *occasional* - never more than one of each per page.
## Typography
-Three font families. Rounded sans throughout — Hum has no serif anywhere.
+Three font families. Rounded sans throughout - Hum has no serif anywhere.
-- **Display / body:** Plus Jakarta Sans (Google Fonts, weights 400/500/600/700) — rounded humanist sans with closed apertures and friendly terminals. The Brilliant / PostHog / Open Runde register. Falls back to Geist, then system rounded.
+- **Display / body:** Plus Jakarta Sans (Google Fonts, weights 400/500/600/700) - rounded humanist sans with closed apertures and friendly terminals. The Brilliant / PostHog / Open Runde register. Falls back to Geist, then system rounded.
- **Mono:** JetBrains Mono (uppercase labels, tabular numerals, streak counters).
- **No serif anywhere.** No `Instrument Serif`, no `Playfair`, no `Newsreader`. If a serif sneaks in, the theme is misapplied.
**Type discipline:**
-- Display weight: **600** (heavier than Lumen's 400 — Hum's display is confident, not delicate).
+- Display weight: **600** (heavier than Lumen's 400 - Hum's display is confident, not delicate).
- Tracking on display: `-0.025em` (tight, not over-tight).
- Body weight: 400 with 500 for inline emphasis.
- All-caps reserved for mono labels.
@@ -54,18 +54,18 @@ Three font families. Rounded sans throughout — Hum has no serif anywhere.
## The seven signature moves
-A Hum build must exhibit **at least six of these seven**. Skipping the character moment (#5) is the only acceptable omission — for product-led pages without space for ornament.
+A Hum build must exhibit **at least six of these seven**. Skipping the character moment (#5) is the only acceptable omission - for product-led pages without space for ornament.
-These are the theme's *vocabulary*, not a layout: which moves appear is shared, but **how they're composed must differ every build** (see *Not-AI discipline* below). In particular, #3 is the colour-shift *technique* (accent tint deepens on hover) applied to whatever tile or row shape the build chooses — it is never a licence for the banned 3-equal-cards row.
+These are the theme's *vocabulary*, not a layout: which moves appear is shared, but **how they're composed must differ every build** (see *Not-AI discipline* below). In particular, #3 is the colour-shift *technique* (accent tint deepens on hover) applied to whatever tile or row shape the build chooses - it is never a licence for the banned 3-equal-cards row.
-### 1. The button system — three variations, the press is the feedback
+### 1. The button system - three variations, the press is the feedback
-Hum ships **one button system, three style variations**, structured as `.btn` (base = *push*) + a style modifier (`.btn--soft` | `.btn--outline`) + a colour modifier (`.btn--pear` | `--coral` | `--cyan` | `--lav` | `--mint` | `--ink`) + size (`.btn--sm` | `.btn--lg`). The canonical, reviewed implementation is the `.btn` CSS block inlined below — **copy that `.btn` system verbatim into every Hum build.** Do not re-improvise button CSS per build (that is how the broken version proliferated).
+Hum ships **one button system, three style variations**, structured as `.btn` (base = *push*) + a style modifier (`.btn--soft` | `.btn--outline`) + a colour modifier (`.btn--pear` | `--coral` | `--cyan` | `--lav` | `--mint` | `--ink`) + size (`.btn--sm` | `.btn--lg`). The canonical, reviewed implementation is the `.btn` CSS block inlined below - **copy that `.btn` system verbatim into every Hum build.** Do not re-improvise button CSS per build (that is how the broken version proliferated).
**The anatomy that matters (the two bugs this fixes):**
-1. **Shadow = a full-width solid colour edge + a separate soft ground shadow.** `box-shadow: 0 4px 0 0 var(--btn-edge), 0 6px 12px -3px var(--btn-cast)`. **Never a negative spread** (`0 8px 0 -4px` makes the edge narrower than the button — the old bug). The first shadow is the button's *thickness*, flush to its width; the second is the cast shadow on the ground.
-2. **The press is the feedback.** Lift on hover (`translateY(-2px)`, edge grows to `6px`), **press DOWN on `:active`** (`translateY(+3px)`, edge shrinks to `1px`) so it physically depresses. Easing is snappy — `cubic-bezier(0.2, 0.7, 0.3, 1)`, 140 ms hover / 70 ms active. **No `scale()`, no spring overshoot** (the old `scale(1.04)` + `cubic-bezier(…1.56…)` read floaty).
+1. **Shadow = a full-width solid colour edge + a separate soft ground shadow.** `box-shadow: 0 4px 0 0 var(--btn-edge), 0 6px 12px -3px var(--btn-cast)`. **Never a negative spread** (`0 8px 0 -4px` makes the edge narrower than the button - the old bug). The first shadow is the button's *thickness*, flush to its width; the second is the cast shadow on the ground.
+2. **The press is the feedback.** Lift on hover (`translateY(-2px)`, edge grows to `6px`), **press DOWN on `:active`** (`translateY(+3px)`, edge shrinks to `1px`) so it physically depresses. Easing is snappy - `cubic-bezier(0.2, 0.7, 0.3, 1)`, 140 ms hover / 70 ms active. **No `scale()`, no spring overshoot** (the old `scale(1.04)` + `cubic-bezier(…1.56…)` read floaty).
```css
.btn {
@@ -87,11 +87,11 @@ Hum ships **one button system, three style variations**, structured as `.btn` (b
.btn__arrow slides 3px right on hover. .is-loading shows a spinner. Build these modifiers on top of the .btn base above. */
```
-**Rules:** primary action = push (the chunky one). Secondary = soft. Tertiary = outline. One push button per primary moment; don't stack three push buttons in a row. The first-paint wobble is **retired** — it fought the press metaphor.
+**Rules:** primary action = push (the chunky one). Secondary = soft. Tertiary = outline. One push button per primary moment; don't stack three push buttons in a row. The first-paint wobble is **retired** - it fought the press metaphor.
### 2. Multi-accent section bands
-Sections alternate background between cream paper, pear-tint, cyan-tint, and coral-tint. Each accent owns sections matching its meaning: pear = primary product surfaces, cyan = community / "what people say," coral = the single emphatic moment (streak day, headline number). Bands transition with simple `background-color` changes — no gradients between them.
+Sections alternate background between cream paper, pear-tint, cyan-tint, and coral-tint. Each accent owns sections matching its meaning: pear = primary product surfaces, cyan = community / "what people say," coral = the single emphatic moment (streak day, headline number). Bands transition with simple `background-color` changes - no gradients between them.
### 3. Color-shift card grid
@@ -101,18 +101,18 @@ Card grid where each card has a different accent tint at rest (very low opacity,
Big rounded numerals that count up from 0 to their target value on view-enter, over 1200ms with `cubic-bezier(0.22, 1, 0.36, 1)` easing (snappy arrival). The container scales 1 → 1.06 → 1 once on completion (the "yes!" moment). Implemented with `@property --num` for CSS-only tick-up, or a small JS loop with `requestAnimationFrame`.
-### 5. Character moment — one small reacting mark
+### 5. Character moment - one small reacting mark
Every Hum page has ONE small character / mark that reacts to user interaction. Constructed entirely in CSS (no `<img>`, no Lottie). Examples:
- A small filled circle that pulses gently at rest and bursts a 4-point star when its CTA is clicked.
-- A wordmark where one letter is the character — pulses, blinks, or wobbles on hover.
+- A wordmark where one letter is the character - pulses, blinks, or wobbles on hover.
- A floating shape next to the hero that drifts in a slow circle and grows when hovered.
-The character lives in **pear-yellow** by default — that's its colour. Other accents can carry it but pear is canonical.
+The character lives in **pear-yellow** by default - that's its colour. Other accents can carry it but pear is canonical.
### 6. Big rounded everything
-`--radius-card: 20px`, `--radius-pill: 999px`, `--radius-input: 12px`. Soft drop shadows on cards (`0 12px 32px -16px ink/15%`) that brighten on hover. The *amount* of round (and the shadow philosophy) is a per-build lever — a kids' build can go chunky at 28px with a hard button-style edge, a quiet one tighter at 14px with a single soft layer (see the card-physics lever under *Not-AI discipline*). What never changes: **no square corners anywhere** — this is the rounded theme.
+`--radius-card: 20px`, `--radius-pill: 999px`, `--radius-input: 12px`. Soft drop shadows on cards (`0 12px 32px -16px ink/15%`) that brighten on hover. The *amount* of round (and the shadow philosophy) is a per-build lever - a kids' build can go chunky at 28px with a hard button-style edge, a quiet one tighter at 14px with a single soft layer (see the card-physics lever under *Not-AI discipline*). What never changes: **no square corners anywhere** - this is the rounded theme.
### 7. Star-burst micro-celebration on success
@@ -141,17 +141,17 @@ Hum's motion stack is **the loudest in the catalog**. Almost every interactive e
| Element | Motion |
|---|---|
-| Primary CTA (push) | lift 2px on hover (the colour edge grows), press DOWN 3px on `:active` (edge shrinks to 1px); snappy `cubic-bezier(0.2,0.7,0.3,1)`. No scale, no wobble — the press is the feedback |
+| Primary CTA (push) | lift 2px on hover (the colour edge grows), press DOWN 3px on `:active` (edge shrinks to 1px); snappy `cubic-bezier(0.2,0.7,0.3,1)`. No scale, no wobble - the press is the feedback |
| Cards | lift 4px + shadow brighten + accent tint deepen on hover (220ms `--ease-spring`) |
| Counters | tick-up on view-enter (1200ms, snappy ease-out) + scale pulse on completion |
| Character mark | pulse at rest (4s gentle scale 1 → 1.04 → 1); star-burst on relevant CTA click |
| Section headings | translateY(12px → 0) + opacity 0 → 1 on view-enter, 600ms, 80ms stagger |
| Star-burst | 420ms, fires once on primary action complete |
-| Scroll | Lenis (`duration: 0.8, lerp: 0.10` — a soft, slightly elastic glide for the playful feel) |
+| Scroll | Lenis (`duration: 0.8, lerp: 0.10` - a soft, slightly elastic glide for the playful feel) |
Available easings:
-- `--ease-spring: cubic-bezier(0.34, 1.56, 0.64, 1)` (bouncy overshoot — the canonical Hum easing)
-- `--ease-snap: cubic-bezier(0.22, 1, 0.36, 1)` (easeOutExpo — for tick-ups and reveals)
+- `--ease-spring: cubic-bezier(0.34, 1.56, 0.64, 1)` (bouncy overshoot - the canonical Hum easing)
+- `--ease-snap: cubic-bezier(0.22, 1, 0.36, 1)` (easeOutExpo - for tick-ups and reveals)
- `--ease-out`, `--ease-in-out` (standard fallbacks)
`prefers-reduced-motion: reduce`:
@@ -160,7 +160,7 @@ Available easings:
- Character mark stops pulsing (stays at final state).
- Star-burst disabled entirely.
-The page must remain delightful with reduced motion — restraint, not breakage.
+The page must remain delightful with reduced motion - restraint, not breakage.
## Required dependencies
@@ -172,34 +172,34 @@ The page must remain delightful with reduced motion — restraint, not breakage.
Two families. No third. No serif anywhere.
-**Optional:** Lenis 1.3.23 for smooth scroll — recommended but not mandatory. Hum reads correctly without it; add when the brief calls for premium polish.
+**Optional:** Lenis 1.3.23 for smooth scroll - recommended but not mandatory. Hum reads correctly without it; add when the brief calls for premium polish.
## Macrostructure affinity
**Hum loves these.**
-- **Marquee Hero** — canonical: big "today's thing" card centred, big CTA below, character mark anchored to one side
-- **Bento Grid** — multi-accent tiles, one accent per tile; the bento is Hum's natural shape
-- **Workbench** — when the page has a live demo (small product preview surrounded by playful chrome)
-- **Stat-Led** — big rounded counters carry the story
-- **Catalogue** — a grid of items where each tile uses a different accent (color-shift gallery)
-- **Narrative Workflow** — a numbered process-timeline spine (`1.0 → 2.0 → 3.0 → 4.0`): each stage owns its own accent band, the big rounded stage numerals ride the counter signature, and a connecting rail makes the sequence the page's structure. Works well for a guided-sourdough-style build. Reach for it when the product is *genuinely sequential* — recipes, learn-a-skill, onboarding, multi-week programs, anything that happens in ordered steps over time. Don't force it on one-moment tools (those want Marquee or Stat-Led).
+- **Marquee Hero** - canonical: big "today's thing" card centred, big CTA below, character mark anchored to one side
+- **Bento Grid** - multi-accent tiles, one accent per tile; the bento is Hum's natural shape
+- **Workbench** - when the page has a live demo (small product preview surrounded by playful chrome)
+- **Stat-Led** - big rounded counters carry the story
+- **Catalogue** - a grid of items where each tile uses a different accent (color-shift gallery)
+- **Narrative Workflow** - a numbered process-timeline spine (`1.0 → 2.0 → 3.0 → 4.0`): each stage owns its own accent band, the big rounded stage numerals ride the counter signature, and a connecting rail makes the sequence the page's structure. Works well for a guided-sourdough-style build. Reach for it when the product is *genuinely sequential* - recipes, learn-a-skill, onboarding, multi-week programs, anything that happens in ordered steps over time. Don't force it on one-moment tools (those want Marquee or Stat-Led).
## Macrostructure rejection
**Hum refuses these.**
-- **Long Document** — Hum is not a 2,000-word essay theme
-- **Manifesto** — too serious; Coral or Atelier handle subdued
-- **Quote-Led** — too literary
-- **Type Specimen** — typography is rounded sans only; specimens want range
-- **Photographic** — Hum is pure shape + colour; photography can appear in a tile but never as a section's spine
+- **Long Document** - Hum is not a 2,000-word essay theme
+- **Manifesto** - too serious; Coral or Atelier handle subdued
+- **Quote-Led** - too literary
+- **Type Specimen** - typography is rounded sans only; specimens want range
+- **Photographic** - Hum is pure shape + colour; photography can appear in a tile but never as a section's spine
## Layout & emphasis discipline (non-negotiable)
Two bugs appeared in early Hum builds and must never ship again.
-### Section alignment — one content shell, identical edges
+### Section alignment - one content shell, identical edges
Every section's content must align to the **exact same left and right edges**, whether or not the section sits on a tinted band. The early bug: banded sections (`.section--band`) put their gutter padding on the band while plain sections put `max-width + padding` on themselves, so band content was ~one-gutter wider than plain content and the edges didn't line up.
@@ -216,9 +216,9 @@ Every section's content must align to the **exact same left and right edges**, w
.section--band > * { max-width: var(--shell); margin-inline: auto; padding-inline: var(--page-gutter); }
```
-With global `box-sizing: border-box`, plain-section content and band content are now both `--shell` minus two gutters, both centred — edges match to the pixel. **Verify it:** the hero headline's left edge, a plain section's heading, and a banded section's heading must all sit on the same vertical line. If they don't, this rule was broken.
+With global `box-sizing: border-box`, plain-section content and band content are now both `--shell` minus two gutters, both centred - edges match to the pixel. **Verify it:** the hero headline's left edge, a plain section's heading, and a banded section's heading must all sit on the same vertical line. If they don't, this rule was broken.
-### Emphasis highlight — must follow the text, never a floating bar
+### Emphasis highlight - must follow the text, never a floating bar
The highlighter behind an emphasised word (`<em>` / `.hl`) and behind big display numbers must be painted as a **clipped background gradient on the text itself**, not an absolutely-positioned `::after` bar. The early bug: the `::after` bar only underlined the last line when the phrase wrapped, and drifted out of place at some sizes.
@@ -238,52 +238,52 @@ em, .hl {
/* per-accent: set --hl on the element (pear default; coral/cyan/lav/mint as needed). */
```
-This never breaks on wrap, never needs `white-space: nowrap`, and the band always sits correctly under the word. For a giant single-token display number (e.g. a Stat-Led hero count) the same technique applies — `background-size: 100% 0.14em; background-position: 0 88%` reads as a thick underline beneath the figure.
+This never breaks on wrap, never needs `white-space: nowrap`, and the band always sits correctly under the word. For a giant single-token display number (e.g. a Stat-Led hero count) the same technique applies - `background-size: 100% 0.14em; background-position: 0 88%` reads as a thick underline beneath the figure.
-## Not-AI discipline — make every build read as a different studio (non-negotiable)
+## Not-AI discipline - make every build read as a different studio (non-negotiable)
-The fastest way Hum slides into AI-slop is **sameness**: many products sharing one skeleton below the hero. The *component* system (buttons, the highlight, tokens, the press metaphor) **should** be shared — that is a design system, and it's the right kind of consistency. The *page architecture* must **not** be shared. Two Hum builds have to read as two different studios' work, not two colour-swaps of one template.
+The fastest way Hum slides into AI-slop is **sameness**: many products sharing one skeleton below the hero. The *component* system (buttons, the highlight, tokens, the press metaphor) **should** be shared - that is a design system, and it's the right kind of consistency. The *page architecture* must **not** be shared. Two Hum builds have to read as two different studios' work, not two colour-swaps of one template.
**Study these real sites for how the register stays hand-made** (each cited for one specific move):
-- **PostHog** — the closest production analog to Hum: cream `#EEEFE9`, ink applied *at opacity* (90% body / 95% link / 100% hover) not as new hexes, **dashed-rule** section dividers, a mascot with a strict model sheet, and a self-aware "shameless plug" section. Steal the discipline wholesale.
-- **Brilliant** (Koto 2024) — shape-DNA shared between the wordmark and the spot illustrations. **Duolingo** — every character built from three primitives (rounded rect, circle, rounded triangle). **Family** — one springy, *scrubbable* number that's a toy. **Cosmos** — layered, captioned image *clusters*, never a tidy grid. **Daylight** — a warm palette deployed as a *system*, not a vibe. **Multiverse** — a split-screen hero instead of the centred stack. **Stripe** — restraint as craft (one gradient, narrow columns, layered soft shadows). **Linear** — hierarchy by scale-jump; the feature demonstrates itself.
+- **PostHog** - the closest production analog to Hum: cream `#EEEFE9`, ink applied *at opacity* (90% body / 95% link / 100% hover) not as new hexes, **dashed-rule** section dividers, a mascot with a strict model sheet, and a self-aware "shameless plug" section. Steal the discipline wholesale.
+- **Brilliant** (Koto 2024) - shape-DNA shared between the wordmark and the spot illustrations. **Duolingo** - every character built from three primitives (rounded rect, circle, rounded triangle). **Family** - one springy, *scrubbable* number that's a toy. **Cosmos** - layered, captioned image *clusters*, never a tidy grid. **Daylight** - a warm palette deployed as a *system*, not a vibe. **Multiverse** - a split-screen hero instead of the centred stack. **Stripe** - restraint as craft (one gradient, narrow columns, layered soft shadows). **Linear** - hierarchy by scale-jump; the feature demonstrates itself.
-### The deadliest tells — forbidden by default
+### The deadliest tells - forbidden by default
- **The centred hero stack** (eyebrow/badge → centred H1 → two-line subhead → filled + ghost CTA, dead-centre). The single biggest tell. Default to an *off-centre* hero; only centre when one element deliberately breaks the grid.
- **A badge-pill directly above the H1** ("✨ now with…"). Never.
-- **The 3-identical-accent-cards row** (icon-tile on top → title → two grey lines, ×3, equal gap). Already banned in Anti-patterns — but it's the reflex unit, so it keeps reappearing. If you have three things to say, say them in a *different shape*: zig-zag text/art rows, one big + two small, a numbered list, a horizontal scroll-rail, a comparison table.
+- **The 3-identical-accent-cards row** (icon-tile on top → title → two grey lines, ×3, equal gap). Already banned in Anti-patterns - but it's the reflex unit, so it keeps reappearing. If you have three things to say, say them in a *different shape*: zig-zag text/art rows, one big + two small, a numbered list, a horizontal scroll-rail, a comparison table.
- **Uniform radius + one shadow on everything.** Give each build its own card *physics* (see levers).
-- **An accent stripe on a card's top/left edge** — reads as AI almost as reliably as em-dashes.
+- **An accent stripe on a card's top/left edge** - reads as AI almost as reliably as em-dashes.
- **Emoji standing in for icons.** Hum draws its marks in CSS/SVG; an emoji in a chip or nav is a tell.
-- **An all-caps grey eyebrow over *every* section** — use it sparingly, not as wallpaper.
+- **An all-caps grey eyebrow over *every* section** - use it sparingly, not as wallpaper.
- **A decorative gradient on the background AND the headline AND the button** (Hum bans accent-to-accent gradients anyway; never stack one three ways).
### Kill the shared tail (the highest-leverage rule)
No two Hum builds may share the same **back half**. The failure mode is a bespoke hero bolted onto an identical *features → 3-up testimonials → 3-tier-pricing → statement-footer* run. Vary, per build:
-- **Pricing** — three tiers is *one* option. Also: a single honest price line; a free-vs-paid inline toggle; price folded into the product/catalogue surface; or no pricing at all (a "start" strip instead).
-- **Social proof** — quote-cards-×3 is *one* option. Also: a single big pull-quote; a marquee of names; an inline stat+quote; a screenshot of real usage. The byline grammar "Name · metric" on every card is itself a tell — vary it.
-- **Footer** — rotate the footer archetype. Don't ship the same giant-statement + `auto 1fr 1fr 1fr` meta grid every time. A compact single row, a marquee, or a footer that reuses the build's own artefact are all fair.
-
-### Variety levers — pick a *different* combination each build (independent of palette)
-1. **Hero archetype** — rotate: off-centre artefact-bleed · split-screen (value centre, art flanks) · text-left/art-right · art-LEFT/text-right · full-bleed colour-block with an overlapping product card · art-above-headline. Never default to centred-stack.
-2. **The "one highlighted word in the headline"** is now in *every* existing build — it has become a tell. Use it in some; in others carry emphasis by scale, a drawn underline, or colour-blocking the whole line.
-3. **Feature-block format** — commit to ONE non-default shape per build (zig-zag · big+small · dense linked index · table · numbered narrative).
-4. **Density rhythm** — alternate airy sections with one deliberately dense "everything" section; don't hold `--section-gap` constant top-to-bottom.
-5. **Card physics** — choose a personality per build: hairline-flat no-shadow (quiet/editorial) · chunky 28px + the button's hard edge-shadow (kids/toy) · borderless tinted blocks · Stripe-soft single layer · layered contact+ambient. Not `20px + 1.5px rule + --shadow-card` every time.
-6. **Divider / seam** — dashed rules · full-bleed colour-block edges · whitespace only · a thin top accent rule. One language per build.
-7. **Colour deployment** — same palette, different distribution: cream-dominant with tiny accent *punctuation* (PostHog) · bold full-section colour-blocking (one accent owns a whole section) · one accent gradient used exactly once. Distribution changes the feel more than the hues.
-8. **Mascot dose & placement** — one character moment, but rotate where: hero-bleed · peeking from a card corner · an empty-state · the footer · a scroll-triggered cameo.
-9. **Motion register** — spring-bouncy overshoot · calm-eased · one signature scrubbable/draggable toy (Family). Pick one; don't fade-in everything.
+- **Pricing** - three tiers is *one* option. Also: a single honest price line; a free-vs-paid inline toggle; price folded into the product/catalogue surface; or no pricing at all (a "start" strip instead).
+- **Social proof** - quote-cards-×3 is *one* option. Also: a single big pull-quote; a marquee of names; an inline stat+quote; a screenshot of real usage. The byline grammar "Name · metric" on every card is itself a tell - vary it.
+- **Footer** - rotate the footer archetype. Don't ship the same giant-statement + `auto 1fr 1fr 1fr` meta grid every time. A compact single row, a marquee, or a footer that reuses the build's own artefact are all fair.
+
+### Variety levers - pick a *different* combination each build (independent of palette)
+1. **Hero archetype** - rotate: off-centre artefact-bleed · split-screen (value centre, art flanks) · text-left/art-right · art-LEFT/text-right · full-bleed colour-block with an overlapping product card · art-above-headline. Never default to centred-stack.
+2. **The "one highlighted word in the headline"** is now in *every* existing build - it has become a tell. Use it in some; in others carry emphasis by scale, a drawn underline, or colour-blocking the whole line.
+3. **Feature-block format** - commit to ONE non-default shape per build (zig-zag · big+small · dense linked index · table · numbered narrative).
+4. **Density rhythm** - alternate airy sections with one deliberately dense "everything" section; don't hold `--section-gap` constant top-to-bottom.
+5. **Card physics** - choose a personality per build: hairline-flat no-shadow (quiet/editorial) · chunky 28px + the button's hard edge-shadow (kids/toy) · borderless tinted blocks · Stripe-soft single layer · layered contact+ambient. Not `20px + 1.5px rule + --shadow-card` every time.
+6. **Divider / seam** - dashed rules · full-bleed colour-block edges · whitespace only · a thin top accent rule. One language per build.
+7. **Colour deployment** - same palette, different distribution: cream-dominant with tiny accent *punctuation* (PostHog) · bold full-section colour-blocking (one accent owns a whole section) · one accent gradient used exactly once. Distribution changes the feel more than the hues.
+8. **Mascot dose & placement** - one character moment, but rotate where: hero-bleed · peeking from a card corner · an empty-state · the footer · a scroll-triggered cameo.
+9. **Motion register** - spring-bouncy overshoot · calm-eased · one signature scrubbable/draggable toy (Family). Pick one; don't fade-in everything.
### Two requirements every build must meet
-- **One off-grid / asymmetric moment** — a card that breaks the gutter, an oversized numeral bleeding off-edge, a 2/3–1/3 split, a tilted element. The page must not be one centred column of equal blocks. (Bubble's numbered rail is the current best example.)
-- **One "designed exception"** — a single deliberate rule-break that says a human made this: a self-aware copy aside (PostHog's deadpan), an interactive toy (Family's scrub), a hand-drawn annotation over a clean shot, one tilted off-grid card, a full-bleed photo/colour break. Rotate which kind across builds.
+- **One off-grid / asymmetric moment** - a card that breaks the gutter, an oversized numeral bleeding off-edge, a 2/3-1/3 split, a tilted element. The page must not be one centred column of equal blocks. (Bubble's numbered rail is the current best example.)
+- **One "designed exception"** - a single deliberate rule-break that says a human made this: a self-aware copy aside (PostHog's deadpan), an interactive toy (Family's scrub), a hand-drawn annotation over a clean shot, one tilted off-grid card, a full-bleed photo/colour break. Rotate which kind across builds.
### Micro-craft that reads hand-made
-- **Modify ink with opacity, not new hexes** — body ~88–90% of `--color-ink`, links 95%, hover 100%. Fewer literal colours, used consistently.
-- **Layer shadows** (a tight contact shadow + a soft ambient one), varied by elevation — never one `--shadow-card` on everything.
+- **Modify ink with opacity, not new hexes** - body ~88-90% of `--color-ink`, links 95%, hover 100%. Fewer literal colours, used consistently.
+- **Layer shadows** (a tight contact shadow + a soft ambient one), varied by elevation - never one `--shadow-card` on everything.
- **Tight tracking on display, sentence case, ≤3 type levels.** Big heads get negative letter-spacing; body stays neutral.
-- **Voice:** max one em-dash per paragraph (the em-dash pile-up is the clearest "AI wrote this" tic — prefer periods). Honest metrics only; never decorative big-number theatre.
+- **Voice:** max one em-dash per paragraph (the em-dash pile-up is the clearest "AI wrote this" tic - prefer periods). Honest metrics only; never decorative big-number theatre.
## Voice fixtures
@@ -303,7 +303,7 @@ Body patterns:
- "Free for the first seven days. $5 a month after that, or $45 a year."
- "Made by three people in Lisbon and Amsterdam. We're answering email."
-Mono labels — UPPERCASE, used for ordinals, stats, and tags:
+Mono labels - UPPERCASE, used for ordinals, stats, and tags:
- `01 · TODAY`
- `02 · YOUR STREAK`
@@ -314,14 +314,14 @@ Mono labels — UPPERCASE, used for ordinals, stats, and tags:
## Anti-patterns (theme-specific)
-- **NEVER serif anywhere.** Display, body, captions — all rounded sans. If a serif is needed, the brief belongs in Lumen or one of the editorial themes.
+- **NEVER serif anywhere.** Display, body, captions - all rounded sans. If a serif is needed, the brief belongs in Lumen or one of the editorial themes.
- **NEVER pure white paper.** Cream `oklch(97% 0.012 95)` is the only acceptable ground. Pure white drains all the warmth out of the theme.
- **NEVER pure black ink.** `oklch(20% 0.012 250)` minimum lightness. Pure black on cream is harsh and breaks the warmth.
- **NEVER square corners on cards / pills / buttons.** Hum is the rounded theme. Cards = 20px, pills = 999px, inputs = 12px.
- **NEVER single-accent palette.** Hum is multi-accent. If a build wants one restrained accent only, it should route to Coral (single-accent modern-minimal) instead.
- **NEVER gradients between accents.** Pear-to-cyan or cyan-to-coral gradients are banned. Each accent owns its own surface.
- **NEVER over-rotate animations.** One signature character pulse + one CTA wobble per page. Bouncy easings on everything is exhausting; reserve spring for primary actions.
-- **NEVER `font-style: italic` for the verb landmark.** Hum is not Lumen — verbs aren't italicised here. Emphasis comes from weight (500) or accent color, not italics.
+- **NEVER `font-style: italic` for the verb landmark.** Hum is not Lumen - verbs aren't italicised here. Emphasis comes from weight (500) or accent color, not italics.
- **NEVER invented metrics.** Streak counts must be honest (the user's actual data). Marketing stats must be real.
- **NEVER pure-rainbow gradient backgrounds.** Multi-accent ≠ Y2K rainbow. Each accent has its own surface; they sit next to each other in defined regions.
- **NEVER three-feature-card row with stock-icon tops.** Use abstract shape characters per card, not generic Lucide icons.
@@ -331,7 +331,7 @@ Mono labels — UPPERCASE, used for ordinals, stats, and tags:
| vs | difference |
|---|---|
-| **Coral** (modern-minimal, the closest sibling) | Coral is warm-grey paper with a single restrained coral accent — Stripe-not-Linear register, motion optional. Hum uses coral only as its pop accent, on yellower cream with two other accents and mandatory motion. Coral is the friendly-but-quiet register (a quiet bakery card); Hum is exuberant and alive (a brilliant.org-style learning app). When a brief wants one restrained accent, route to Coral; when it wants multi-accent and a character moment, route to Hum. |
+| **Coral** (modern-minimal, the closest sibling) | Coral is warm-grey paper with a single restrained coral accent - Stripe-not-Linear register, motion optional. Hum uses coral only as its pop accent, on yellower cream with two other accents and mandatory motion. Coral is the friendly-but-quiet register (a quiet bakery card); Hum is exuberant and alive (a brilliant.org-style learning app). When a brief wants one restrained accent, route to Coral; when it wants multi-accent and a character moment, route to Hum. |
| **Bloom** (atmospheric) | Bloom is dark/cream with warm radial blooms behind the content (Suno register). Hum is fully light, no blooms, mandatory hover-and-paint motion. Different genres entirely. |
| **Specimen** (editorial) | Specimen is italic-serif on warm oat with classical typography. Hum is rounded sans on cream with vibrant character. Opposite registers. |
@@ -362,7 +362,7 @@ body {
text-transform: uppercase; color: var(--color-ink-2); opacity: 0.75;
}
-.btn { /* push — a solid colour EDGE + a soft ground shadow. Never a negative spread, never scale(). */
+.btn { /* push - a solid colour EDGE + a soft ground shadow. Never a negative spread, never scale(). */
background: var(--color-accent); color: var(--color-ink); font-weight: 600;
padding: 0.8rem 1.4rem; border: 0; border-radius: var(--radius-pill); cursor: pointer;
box-shadow: 0 4px 0 0 var(--color-accent-deep), 0 6px 12px -3px oklch(76% 0.20 95 / 0.45);
@@ -384,7 +384,7 @@ Those lines carry 50% of the theme. The rest is the character moment + the multi
## What Hum refuses (restated)
-Disqualifiers — if any appears in a Hum build, it is not Hum:
+Disqualifiers - if any appears in a Hum build, it is not Hum:
- No serif anywhere.
- No pure white paper.
diff --git a/skills/hallmark/references/themes/lumen.md b/skills/hallmark/references/themes/lumen.md
index cb0623c..ff96721 100644
--- a/skills/hallmark/references/themes/lumen.md
+++ b/skills/hallmark/references/themes/lumen.md
@@ -1,22 +1,22 @@
-# Theme — Lumen
+# Theme - Lumen
-Premium AI-tool register, built around a **hand-engineered apparatus** rather than a glowing orb. One precision SVG/CSS object per page, with leader-line callouts in mono micro-type, set against dead space alongside a **lowercase classical-serif headline** and a technical mono eyebrow. Three font families. Two palette drops (Night Foundry / Day Foundry) with different physics — Night emits, Day refracts — and entirely different visual languages, not the same shape in two colours.
+Premium AI-tool register, built around a **hand-engineered apparatus** rather than a glowing orb. One precision SVG/CSS object per page, with leader-line callouts in mono micro-type, set against dead space alongside a **lowercase classical-serif headline** and a technical mono eyebrow. Three font families. Two palette drops (Night Foundry / Day Foundry) with different physics - Night emits, Day refracts - and entirely different visual languages, not the same shape in two colours.
-Lumen runs a strict **two-register typography system**: all prose is **lowercase** (hero titles, section titles, lede, body, buttons, nav, brand, footer copy — even acronyms when they appear in body text); all mono labels are **UPPERCASE** (eyebrows, callouts, meter labels, stat labels). The contrast between quiet lowercase prose and loud UPPERCASE machine-readout is the typographic signature.
+Lumen runs a strict **two-register typography system**: all prose is **lowercase** (hero titles, section titles, lede, body, buttons, nav, brand, footer copy - even acronyms when they appear in body text); all mono labels are **UPPERCASE** (eyebrows, callouts, meter labels, stat labels). The contrast between quiet lowercase prose and loud UPPERCASE machine-readout is the typographic signature.
Loaded eagerly by SKILL.md Step 3 whenever the catalog pick is `lumen`. Palettes + font stack live in [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="lumen"]` (Night, default) and `[data-theme="lumen"][data-drop="day"]` (Day). This file carries the drops + apparatus family + signature moves + motion + anti-patterns.
## Axes (diversification)
-- **Paper band** — Night: dark cool-violet (`L 13%, H 265`). Day: light cool bone with violet pull (`L 97%, H 265`). The 265° hue is deliberate — sits 25° from Midnight's 250 and 65° from Aurora's 200, so a Lumen page is not confusable with either neighbour at a glance.
-- **Display style** — **classical-serif-lowercase** (Instrument Serif 400, upright, **all-lowercase**, with verb landmark via accent colour + draw-in underline). No italic anywhere. Distinct from italic-serif (Specimen/Studio/Atelier ship italic as default) and from roman-serif (Newsprint uses sentence case). Lumen is the catalog's only lowercase-headline theme.
-- **Accent hue** — Night: **molten brass** (`H 50`, not amber). Day: **deep indigo with violet tilt** (`H 268`). Coral chord (`H 18`) sits behind both as the secondary chromatic.
+- **Paper band** - Night: dark cool-violet (`L 13%, H 265`). Day: light cool bone with violet pull (`L 97%, H 265`). The 265° hue is deliberate - sits 25° from Midnight's 250 and 65° from Aurora's 200, so a Lumen page is not confusable with either neighbour at a glance.
+- **Display style** - **classical-serif-lowercase** (Instrument Serif 400, upright, **all-lowercase**, with verb landmark via accent colour + draw-in underline). No italic anywhere. Distinct from italic-serif (Specimen/Studio/Atelier ship italic as default) and from roman-serif (Newsprint uses sentence case). Lumen is the catalog's only lowercase-headline theme.
+- **Accent hue** - Night: **molten brass** (`H 50`, not amber). Day: **deep indigo with violet tilt** (`H 268`). Coral chord (`H 18`) sits behind both as the secondary chromatic.
## Reference register
Modal · Anthropic (Claude product surfaces) · Together AI · ElevenLabs · Cluely · Adept · Granola · Cohere · Inflection · Linear (premium pricing pages) · Vercel (design guidelines, frontier-AI sections) · Cursor (high-fidelity product mockup heroes).
-The aesthetic to match: a single hand-engineered artefact in dead space; a lowercase classical-serif headline with one accent-coloured verb; mono UPPERCASE technical labels that read as if pulled from an internal docs site; tabular numerals everywhere a number appears. The combination is what AI-tool defaults do not ship — and exactly the combination that breaks every default the model was trained on.
+The aesthetic to match: a single hand-engineered artefact in dead space; a lowercase classical-serif headline with one accent-coloured verb; mono UPPERCASE technical labels that read as if pulled from an internal docs site; tabular numerals everywhere a number appears. The combination is what AI-tool defaults do not ship - and exactly the combination that breaks every default the model was trained on.
**Patron-saint reference (internal):** *Modal homepage rate sheet* (the receipt is the artwork) + *Together AI hero diagram* (annotated apparatus + leader lines + labelled callouts) + *Anthropic Claude landing typography* (transitional serif + humanist sans). When in doubt about restraint, ask "would Modal ship this much chrome?" If yes, you've gone too far.
@@ -26,32 +26,32 @@ A Lumen drop is a named palette + apparatus-physics pair. The structural signatu
### Drop 01 · Night Foundry *(default · canonical)*
-Cool-violet near-black canvas. Molten-brass accent that *emits*. The apparatus is an instrument — a filament-in-chamber, a circuit topology, a precision indicator — and it generates the light. Halos and inner-emit washes use `--color-glow` at 42% opacity.
+Cool-violet near-black canvas. Molten-brass accent that *emits*. The apparatus is an instrument - a filament-in-chamber, a circuit topology, a precision indicator - and it generates the light. Halos and inner-emit washes use `--color-glow` at 42% opacity.
-- `--color-paper: oklch(13% 0.014 265)` — late-night studio, violet tilt
-- `--color-ink: oklch(96% 0.006 262)` — near-white headlines
-- `--color-accent: oklch(76% 0.17 50)` — molten brass
-- `--color-accent-2: oklch(68% 0.16 18)` — coral chord
-- `--color-glow: oklch(80% 0.16 50 / 0.42)` — dense halo
-- `--color-paper-emit: oklch(76% 0.17 50 / 0.04)` — inner-emit canvas wash
-- `--rule-blueprint: oklch(96% 0.006 262 / 0.04)` — grid hairline
+- `--color-paper: oklch(13% 0.014 265)` - late-night studio, violet tilt
+- `--color-ink: oklch(96% 0.006 262)` - near-white headlines
+- `--color-accent: oklch(76% 0.17 50)` - molten brass
+- `--color-accent-2: oklch(68% 0.16 18)` - coral chord
+- `--color-glow: oklch(80% 0.16 50 / 0.42)` - dense halo
+- `--color-paper-emit: oklch(76% 0.17 50 / 0.04)` - inner-emit canvas wash
+- `--rule-blueprint: oklch(96% 0.006 262 / 0.04)` - grid hairline
-**Apparatus physics — emission.** The focal element is a built object (filament, circuit, indicator dial, layered lens stack) that *contains* the light source. Subtle pulse animation (`--dur-pulse: 4s`) suggests the instrument is *running*. Card shadows are soft depth (`0 24px 60px -28px oklch(0% 0 0 / 0.55)`), not glows — the apparatus is the only thing that emits.
+**Apparatus physics - emission.** The focal element is a built object (filament, circuit, indicator dial, layered lens stack) that *contains* the light source. Subtle pulse animation (`--dur-pulse: 4s`) suggests the instrument is *running*. Card shadows are soft depth (`0 24px 60px -28px oklch(0% 0 0 / 0.55)`), not glows - the apparatus is the only thing that emits.
**When to pick:** inference platforms · serverless GPU · model APIs · AI coding agents · voice synthesis · agentic tools · developer infra · anything that wants to feel "after hours" and "instrument-grade." Default.
### Drop 02 · Day Foundry
-Cool-bone canvas with a violet pull. Deep indigo accent that *refracts*. The apparatus is a transparent prism / lens stack / chromatic dispersion element — light passes through and is *separated*, not generated. Spectrum exit-fan + measurement annotations + scale bar give it the feel of a calibrated optical instrument, not a vibey gradient.
+Cool-bone canvas with a violet pull. Deep indigo accent that *refracts*. The apparatus is a transparent prism / lens stack / chromatic dispersion element - light passes through and is *separated*, not generated. Spectrum exit-fan + measurement annotations + scale bar give it the feel of a calibrated optical instrument, not a vibey gradient.
-- `--color-paper: oklch(97% 0.008 265)` — cool bone, violet pull
-- `--color-ink: oklch(18% 0.014 265)` — near-black, cool
-- `--color-accent: oklch(46% 0.24 268)` — deep violet-indigo
-- `--color-accent-2: oklch(68% 0.16 18)` — coral chord (red end of spectrum)
-- `--color-glow: oklch(58% 0.22 268 / 0.28)` — indigo halo through prism
-- `--color-paper-emit: oklch(46% 0.24 268 / 0.03)` — canvas wash, faint
+- `--color-paper: oklch(97% 0.008 265)` - cool bone, violet pull
+- `--color-ink: oklch(18% 0.014 265)` - near-black, cool
+- `--color-accent: oklch(46% 0.24 268)` - deep violet-indigo
+- `--color-accent-2: oklch(68% 0.16 18)` - coral chord (red end of spectrum)
+- `--color-glow: oklch(58% 0.22 268 / 0.28)` - indigo halo through prism
+- `--color-paper-emit: oklch(46% 0.24 268 / 0.03)` - canvas wash, faint
-**Apparatus physics — refraction.** The focal element is *static at rest* with a 320ms reveal on first paint (the prism appears, the spectrum fans, both settle). No perpetual motion. The light is captured, not generated. Annotations carry mono micro-labels: `λ = 612 nm`, `θ_out = 38°`, etc. — the prism reads as a *measurement instrument*, not decoration.
+**Apparatus physics - refraction.** The focal element is *static at rest* with a 320ms reveal on first paint (the prism appears, the spectrum fans, both settle). No perpetual motion. The light is captured, not generated. Annotations carry mono micro-labels: `λ = 612 nm`, `θ_out = 38°`, etc. - the prism reads as a *measurement instrument*, not decoration.
**When to pick:** AI for science · climate / research labs · document AI · typography / design tools · daytime productivity · briefs that want "considered" and "clear" rather than "after-dark and intense."
@@ -65,13 +65,13 @@ Lumen's identity is the apparatus, not the palette. Adding more drops would dilu
## The apparatus family
-Lumen's central commitment: **never a generic glowing orb**. The orb is the most overworked AI-tool tell of 2024–2025; every inference platform ships one. Lumen builds a *specific* hand-engineered object per page, chosen to reflect what the product *does*.
+Lumen's central commitment: **never a generic glowing orb**. The orb is the most overworked AI-tool tell of 2024-2025; every inference platform ships one. Lumen builds a *specific* hand-engineered object per page, chosen to reflect what the product *does*.
The canonical family (pick one per build, in the order of preference for the brief):
### Apparatus type · Filament chamber *(Night Foundry, instrument-grade)*
-A vertical glowing rod inside a rounded-rect cylindrical chamber, crossed by 3–4 horizontal hairline "electrodes." Subtle pulse on the filament (3% intensity oscillation, 4s period). References vacuum tubes, Tesla coils, fusion experiments, mass spectrometers. Reads as a *machine*.
+A vertical glowing rod inside a rounded-rect cylindrical chamber, crossed by 3-4 horizontal hairline "electrodes." Subtle pulse on the filament (3% intensity oscillation, 4s period). References vacuum tubes, Tesla coils, fusion experiments, mass spectrometers. Reads as a *machine*.
**When to pick:** inference, runtime, model serving, anything that *produces* output. Brand verbs: think, run, generate, infer, render, execute.
@@ -149,7 +149,7 @@ A vertical glowing rod inside a rounded-rect cylindrical chamber, crossed by 3
### Apparatus type · Codebase graph / topology *(Night Foundry)*
-An annotated SVG graph: one central node + 5–7 satellite nodes connected by hairlines, each satellite labelled with a mono filename or symbol. Light "flows" along the connecting lines at a slow walk (subtle gradient dot moving along each path). References CAD schematics, dependency graphs, electrical circuits, knowledge graphs.
+An annotated SVG graph: one central node + 5-7 satellite nodes connected by hairlines, each satellite labelled with a mono filename or symbol. Light "flows" along the connecting lines at a slow walk (subtle gradient dot moving along each path). References CAD schematics, dependency graphs, electrical circuits, knowledge graphs.
**When to pick:** AI coding agents, knowledge tools, anything that *traverses* a structured space. Brand verbs: read, trace, explore, connect.
@@ -169,8 +169,8 @@ A clip-path triangle (the prism) + an incoming beam from the left + a chromatic
- **Pure CSS + SVG.** Never `<img>`, never icon fonts, never SVG paths copied from Figma. The apparatus is *constructed*, not *placed*.
- **One per page.** Never two apparatus objects on a single Lumen build.
-- **Leader-line callouts.** Every apparatus carries 3–5 mono micro-type annotations (`P50 · 28 ms`, `λ = 612 nm`, `→ refunds.ts`) on horizontal leader lines. The callouts MUST contain real values from the brief — never `LOREM · 000`.
-- **Size.** 240–480 px max dimension on desktop. Scales down to ~180 px on mobile but never disappears.
+- **Leader-line callouts.** Every apparatus carries 3-5 mono micro-type annotations (`P50 · 28 ms`, `λ = 612 nm`, `→ refunds.ts`) on horizontal leader lines. The callouts MUST contain real values from the brief - never `LOREM · 000`.
+- **Size.** 240-480 px max dimension on desktop. Scales down to ~180 px on mobile but never disappears.
- **Pulse, not rotation.** Night apparatus *pulses* (3% intensity oscillation, 4s period). It does *not* rotate. Rotation was the orb's signature; the apparatus's signature is that it's clearly machined.
- **Day Foundry: no perpetual motion.** Day apparatus reveals once on first paint (320ms) and stays static. The light is captured.
- **`prefers-reduced-motion: reduce`:** all pulses freeze at maximum intensity, all reveals collapse to final state.
@@ -185,7 +185,7 @@ See § The apparatus family above. The single most important move.
### 2. Lowercase headline with verb-landmark (no italics)
-Classical Instrument Serif at `--text-display`, **all-lowercase, upright**, with **exactly one word** rendered in `--color-accent-2` (coral chord) — and that word is the verb. A 1px underline in the same accent draws in over 320ms on first paint and stays. **No `font-style: italic` is used anywhere** in Lumen — the verb landmark is built from colour + line, not from a glyph variation.
+Classical Instrument Serif at `--text-display`, **all-lowercase, upright**, with **exactly one word** rendered in `--color-accent-2` (coral chord) - and that word is the verb. A 1px underline in the same accent draws in over 320ms on first paint and stays. **No `font-style: italic` is used anywhere** in Lumen - the verb landmark is built from colour + line, not from a glyph variation.
```html
<h1 class="hero__title">built to&nbsp;<em>think</em>&nbsp;in real time.</h1>
@@ -193,10 +193,10 @@ Classical Instrument Serif at `--text-display`, **all-lowercase, upright**, with
```css
.hero__title {
- text-transform: lowercase; /* defensive — also applied at the prose level */
+ text-transform: lowercase; /* defensive - also applied at the prose level */
}
.hero__title em {
- font-style: normal; /* explicit — em is repurposed as the verb landmark */
+ font-style: normal; /* explicit - em is repurposed as the verb landmark */
color: var(--color-accent-2);
position: relative;
white-space: nowrap;
@@ -218,15 +218,15 @@ Classical Instrument Serif at `--text-display`, **all-lowercase, upright**, with
}
```
-**Rules:** the coloured word is the verb, never a noun. One word per headline, never two. The underline is the persistent landmark — once drawn, never animates again. `<em>` is repurposed semantically (still emphasis), but renders without italic.
+**Rules:** the coloured word is the verb, never a noun. One word per headline, never two. The underline is the persistent landmark - once drawn, never animates again. `<em>` is repurposed semantically (still emphasis), but renders without italic.
### 3. Mono eyebrow above every section
-`01 · INFERENCE` style — JetBrains Mono, uppercase, 11px, tracking `0.10em`, half-opacity. Numbered roman ordinal (01, 02, 03), middle-dot separator, then the section role. Sits directly above the heading on its own line. Cap at 6 per page.
+`01 · INFERENCE` style - JetBrains Mono, uppercase, 11px, tracking `0.10em`, half-opacity. Numbered roman ordinal (01, 02, 03), middle-dot separator, then the section role. Sits directly above the heading on its own line. Cap at 6 per page.
### 4. Blueprint grid background (4% opacity)
-The hero `<section>` and the meter strip both carry a **ruled grid background** at 4% opacity — 32px or 48px square cells, single hairline in `--rule-blueprint`. This is the "engineered, not vibed" signal. Aurora has blooms; Lumen has the grid. The grid sits beneath `--color-paper-emit` so the canvas appears to emit *through* the grid lines.
+The hero `<section>` and the meter strip both carry a **ruled grid background** at 4% opacity - 32px or 48px square cells, single hairline in `--rule-blueprint`. This is the "engineered, not vibed" signal. Aurora has blooms; Lumen has the grid. The grid sits beneath `--color-paper-emit` so the canvas appears to emit *through* the grid lines.
```css
.hero {
@@ -240,7 +240,7 @@ The hero `<section>` and the meter strip both carry a **ruled grid background**
### 5. Meter strip (below the hero)
-A full-bleed 32–48px band beneath the hero showing 60–80 thin vertical ticks (1px wide, varying height/opacity). Mono labels at each end name the readout (`SIGNAL · 12.4 KHZ` left, `DRIFT · 0.04 σ` right). Reads as spectrum analyser / oscilloscope output. The values match the brief — never invented.
+A full-bleed 32-48px band beneath the hero showing 60-80 thin vertical ticks (1px wide, varying height/opacity). Mono labels at each end name the readout (`SIGNAL · 12.4 KHZ` left, `DRIFT · 0.04 σ` right). Reads as spectrum analyser / oscilloscope output. The values match the brief - never invented.
```html
<aside class="meter" aria-label="Signal readout">
@@ -270,15 +270,15 @@ A full-bleed 32–48px band beneath the hero showing 60–80 thin vertical ticks
}
```
-The meter MUST be procedurally varied — never a flat row of equal ticks. Heights drawn from a clean envelope (sine, gaussian, log) so the strip reads as a *measurement*, not a decorative pattern.
+The meter MUST be procedurally varied - never a flat row of equal ticks. Heights drawn from a clean envelope (sine, gaussian, log) so the strip reads as a *measurement*, not a decorative pattern.
### 6. Hairline cards with inner emission
-Cards carry a 1px hairline border in `--color-rule` and an inner radial gradient at 4–6% accent opacity — they feel **lit from within**, not dropped. On hover, inner glow brightens to 10–12% and the card lifts 4px. Never drop-shadow cards (the shadow Lumen uses is for elevated chrome only).
+Cards carry a 1px hairline border in `--color-rule` and an inner radial gradient at 4-6% accent opacity - they feel **lit from within**, not dropped. On hover, inner glow brightens to 10-12% and the card lifts 4px. Never drop-shadow cards (the shadow Lumen uses is for elevated chrome only).
### 7. Three-stat row with Instrument Serif numerals + tabular-nums
-Stats display in Instrument Serif at large size (`clamp(2.5rem, 4vw + 1rem, 4.5rem)`), `font-variant-numeric: tabular-nums`, label in mono uppercase 11px. Hairline vertical dividers. **Always three cells** — never two (reads as comparison), never four (reads as bento). If the brief has fewer than three honest numbers, skip the row entirely.
+Stats display in Instrument Serif at large size (`clamp(2.5rem, 4vw + 1rem, 4.5rem)`), `font-variant-numeric: tabular-nums`, label in mono uppercase 11px. Hairline vertical dividers. **Always three cells** - never two (reads as comparison), never four (reads as bento). If the brief has fewer than three honest numbers, skip the row entirely.
## Motion direction
@@ -291,7 +291,7 @@ Lumen's motion stack is **lighter than Hum, heavier than Coral**.
| Verb landmark | Color set permanently to accent-2; 1px underline draws in 320ms `delay: 900ms`. No font-style change. |
| Cards | `translateY(-4px)` + inner-glow brighten on hover, 220ms `--ease-soft`. |
| Section heads | Opacity 0→1 + translateY 12px→0 on view enter, 600ms, 60ms stagger. |
-| Meter strip | Static. No "live" animation — the strip is a printed readout, not a streaming feed. |
+| Meter strip | Static. No "live" animation - the strip is a printed readout, not a streaming feed. |
| Scroll | Lenis optional (`duration: 0.7, lerp: 0.08`). |
**No magnetic cursors. No bento tile flips. No flashy parallax. No particle systems. No rotating orbs.** If you reach for any of these, you've drifted out of Lumen.
@@ -312,27 +312,27 @@ Three families, three weights each at most. No fourth family.
**Lumen loves these.**
-- **Marquee Hero** — canonical: apparatus at hero-right, italic-pivot headline at hero-left, meter strip below
-- **Workbench** — when the page has live product UI to show (used with annotated codebase graph)
-- **Stat-Led** — numbers carry the story (latency, throughput)
-- **Long Document** — technical narrative with the apparatus at hero (Day Foundry canonical)
-- **Specimen** — only when typography is the subject
+- **Marquee Hero** - canonical: apparatus at hero-right, italic-pivot headline at hero-left, meter strip below
+- **Workbench** - when the page has live product UI to show (used with annotated codebase graph)
+- **Stat-Led** - numbers carry the story (latency, throughput)
+- **Long Document** - technical narrative with the apparatus at hero (Day Foundry canonical)
+- **Specimen** - only when typography is the subject
## Macrostructure rejection
**Lumen refuses these.**
-- **Bento Grid** — too playful; Lumen is one apparatus, not a tile collage
-- **Quote-Led** — too literary
-- **Conversational FAQ** — too soft
-- **Photographic** — Lumen is pure-code; no photographic anchor
-- **Catalogue** — one apparatus, not a grid of products
+- **Bento Grid** - too playful; Lumen is one apparatus, not a tile collage
+- **Quote-Led** - too literary
+- **Conversational FAQ** - too soft
+- **Photographic** - Lumen is pure-code; no photographic anchor
+- **Catalogue** - one apparatus, not a grid of products
## Voice fixtures
Lumen voice is **direct, technical, slightly aphoristic**. Verbs over nouns. Mono labels read as if from internal docs. No marketing-ese.
-Headlines — **all lowercase**, with one verb in accent-2 colour (underlined):
+Headlines - **all lowercase**, with one verb in accent-2 colour (underlined):
- "built to **think** in real time."
- "inference, **rendered**."
@@ -341,20 +341,20 @@ Headlines — **all lowercase**, with one verb in accent-2 colour (underlined):
- "models for a **moving** atmosphere."
- "code that **knows** the codebase."
-Body patterns — also lowercase, including acronyms:
+Body patterns - also lowercase, including acronyms:
- "p50 latency at 28 ms. p99 at 84. the numbers hold under load."
- "one primitive. scales down to zero. scales up to a thousand replicas."
- "three engineers built this in fourteen weeks."
-Mono eyebrows — UPPERCASE (these are tags, not language):
+Mono eyebrows - UPPERCASE (these are tags, not language):
- `00 · INFERENCE`
- `01 · RUNTIME`
- `02 · PRICING`
- `03 · CHANGELOG`
-Leader-line callouts (real values only) — UPPERCASE:
+Leader-line callouts (real values only) - UPPERCASE:
- `P50 · 28 MS`
- `Λ = 612 NM`
@@ -362,16 +362,16 @@ Leader-line callouts (real values only) — UPPERCASE:
- `RX-04 · H100 80GB`
- `INDEXED · 412 FILES`
-Brand wordmarks — lowercase: `cinder`, `wright`, `stratum`. Legal entity names and person names in fine print also lowercase (`cinder labs, inc.`, `maya okonkwo`). The lowercase commitment is total — only mono labels break it.
+Brand wordmarks - lowercase: `cinder`, `wright`, `stratum`. Legal entity names and person names in fine print also lowercase (`cinder labs, inc.`, `maya okonkwo`). The lowercase commitment is total - only mono labels break it.
**Never any of:** experience, journey, elevate, curate, transform, holistic, mindful, ecosystem, platform, leverage, unlock, supercharge, revolutionize, ai-powered, intelligent.
## Anti-patterns (theme-specific)
-- **NEVER a glowing CSS orb / sphere / ring.** The single most reliable AI-tool tell of 2024–2025. Lumen explicitly refuses it. Pick from the apparatus family or build a new precision object — never a generic ball of light.
-- **NEVER `<img>` for the apparatus.** Pure CSS + SVG. Figma-exported SVG paths fail this — the apparatus is constructed in code.
+- **NEVER a glowing CSS orb / sphere / ring.** The single most reliable AI-tool tell of 2024-2025. Lumen explicitly refuses it. Pick from the apparatus family or build a new precision object - never a generic ball of light.
+- **NEVER `<img>` for the apparatus.** Pure CSS + SVG. Figma-exported SVG paths fail this - the apparatus is constructed in code.
- **NEVER sentence-case or title-case prose.** All headlines, lede, body, buttons, nav, captions, brand wordmarks, footer copy, person names, place names, and legal-entity names are lowercase. Mono labels are the ONLY uppercase surface (eyebrows, callouts, meter labels, stat labels). This two-register split is non-negotiable.
-- **NEVER `font-style: italic` anywhere.** The previous italic-pivot signature is retired. The verb landmark is built from colour + a 1px underline, not from a glyph variation. Italic body emphasis, italic founder signatures, italic captions — all banned. `<em>` is repurposed as the verb landmark and renders upright.
+- **NEVER `font-style: italic` anywhere.** The previous italic-pivot signature is retired. The verb landmark is built from colour + a 1px underline, not from a glyph variation. Italic body emphasis, italic founder signatures, italic captions - all banned. `<em>` is repurposed as the verb landmark and renders upright.
- **Never colour-emphasise a noun.** The verb landmark is the verb. Always.
- **Never more than one accent-coloured word per headline.** Two is a marketing landing page; one is a design move.
- **Never invent stats.** If the brief has no real numbers, skip the three-stat row entirely.
@@ -401,7 +401,7 @@ Brand wordmarks — lowercase: `cinder`, `wright`, `stratum`. Legal entity names
| **Midnight** (atmospheric, closest) | Midnight is geometric Geist on cool dark (`H 250`), no apparatus, no italic pivot, no grid. Lumen sits 25° hue away (`H 265`) with classical Instrument Serif, hand-built apparatus + leader callouts, blueprint grid, meter strip. The differentiation is large at every signature axis. |
| **Aurora** (atmospheric) | Aurora is cool cyan blooms on dark, Sentient serif body. Lumen is brass-on-violet apparatus + Instrument Serif headline. Different temperature, different focal-element philosophy (Aurora: ambient blooms; Lumen: built apparatus). |
| **Bloom** (atmospheric) | Bloom is warm cream paper, expressive content (Suno/Runway). Lumen is dark or cool-bone, technical content (Modal/Anthropic). Different register entirely. |
-| **Atelier** (editorial) | Atelier is Playfair Display Didone on warm cream — luxury fashion. Lumen's Instrument Serif is a 1960s technical-journal serif. Atelier sells perfume; Lumen sells inference. |
+| **Atelier** (editorial) | Atelier is Playfair Display Didone on warm cream - luxury fashion. Lumen's Instrument Serif is a 1960s technical-journal serif. Atelier sells perfume; Lumen sells inference. |
## Test brief expectations
@@ -422,7 +422,7 @@ body {
background: var(--color-paper); color: var(--color-ink-2);
font-family: var(--font-body);
font-variant-numeric: tabular-nums;
- text-transform: lowercase; /* prose default — the two-register foundation */
+ text-transform: lowercase; /* prose default - the two-register foundation */
}
.eyebrow, .callout, .meter__label, .stat__label, .card__eyebrow {
@@ -455,12 +455,12 @@ The `text-transform: lowercase` on `<body>` + selective `text-transform: upperca
## What Lumen refuses (restated)
-Disqualifiers — if any appears in a Lumen build, the build is not Lumen:
+Disqualifiers - if any appears in a Lumen build, the build is not Lumen:
- No glowing orb / sphere / ring of any kind.
- No `font-style: italic` anywhere on the page.
-- No sentence-case or title-case prose — headlines, lede, body, buttons, nav, brand are all lowercase.
-- No lowercase mono labels — eyebrows, callouts, meter labels are all UPPERCASE.
+- No sentence-case or title-case prose - headlines, lede, body, buttons, nav, brand are all lowercase.
+- No lowercase mono labels - eyebrows, callouts, meter labels are all UPPERCASE.
- No bento grids.
- No glassmorphism / `backdrop-filter` blur.
- No "trusted by" logo cloud as a full-width band.
diff --git a/skills/hallmark/references/themes/manifesto.md b/skills/hallmark/references/themes/manifesto.md
new file mode 100644
index 0000000..e9f839e
--- /dev/null
+++ b/skills/hallmark/references/themes/manifesto.md
@@ -0,0 +1,140 @@
+# Theme - Manifesto
+
+Loud editorial, broadside register. The page for **a statement, a declaration, a movement, a cause, a defiant brand launch, a set of principles** - the protest-poster / political-broadside school, executed on a **warm near-black ground with condensed-bold uppercase display and exactly ONE fighting red**. Giant Anton headlines slam to the left margin, mono clause numbers march down the side, and the body drops to a quiet grotesque. It reads like a thesis nailed to a door: uncompromising, urgent, set once and set loud.
+
+Loaded eagerly by SKILL.md Step 3 whenever the catalog pick is `manifesto`. The OKLCH palette + font stack live in [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="manifesto"]`. No canonical build yet: mirror the signature moves below.
+
+## Axes (diversification)
+
+- **Paper band** - **dark, warm** (`oklch(10% 0.005 60)`, a warm charcoal near-black). Stepped bands at `paper-2 15%` / `paper-3 20%`. The only dark theme in the editorial cluster.
+- **Display style** - **display-condensed-bold** (Anton 400, single weight, `--display-optical: 96`). Uppercase, tracked at `0.005em`, leaded tight at `--lh-tight: 0.86`. Distinct from Carnival's variable-width Big Shoulders and every serif option.
+- **Accent hue** - **fighting red** (`--color-accent: #E51A1A`; the same red tuned for text is `--color-accent-ink: oklch(58% 0.24 28)`). One warm red (~25-28 deg), used as a signal, never a flood. Sits clear of Carnival's mustard/oxblood duo-tone.
+
+## Reference register
+
+Recorded broadsides and statement pages: the Communist / Futurist / Dada printed manifesto, a strike poster, a punk zine cover, Wikimedia's "we stand for" appeals, agency mission pages set in condensed grotesque, Aesop's plainspoken conviction re-pitched loud. The aesthetic: a political declaration printed at scale in one ink plus red, numbered like articles, no image needed. **Never name any of these in the output.**
+
+**Patron-saint reference (internal):** *the printed manifesto nailed up in public* - condensed-bold caps, clause numbers, one red word per line, argument carried by type alone. When in doubt ask "does this read like a declaration, or like a product page?" Keep the former.
+
+## Required dependencies
+
+1. **Fonts** - **Anton** (display, one weight 400, uppercase only), **Public Sans** (body, 400/600/700), **JetBrains Mono** (clause numbers, labels, meta). The stack also names Bebas Neue / Albert Sans / Hanken Grotesk as fallbacks; load the three primaries. Google Fonts:
+ ```html
+ <link href="https://fonts.googleapis.com/css2?family=Anton&family=Public+Sans:wght@400;600;700&family=JetBrains+Mono:wght@400;500;700&display=swap" rel="stylesheet" />
+ ```
+2. **A hard reveal script** - one `IntersectionObserver` adding `.is-in` that runs a **clip-up mask** on headline blocks (not a soft fade + drift). Snappy cubic-bezier, plays once, gates behind `prefers-reduced-motion: no-preference`.
+
+## Signature moves
+
+1. **Warm near-black ground, never `#000`** - `--color-paper` is `oklch(10% 0.005 60)`, a warm charcoal. Ink is warm near-white `--color-ink` (`oklch(98% 0.003 90)`); body text sits a notch back at `--color-ink-2` (`oklch(88% 0.006 80)`); meta drops to `--color-muted` (`oklch(60% 0.012 65)`). Everything is warm-tinted (hue 60-90), never neutral grey, never pure black or white.
+
+2. **Anton at full display scale, stacked** - the headline is the page. Set `--font-display` uppercase at `clamp(4rem, 8vw+1rem, 9rem)` (`--text-display`), leaded at `--lh-tight: 0.86` so a three-line headline locks into one solid mass. Slam it to the left margin, edge to edge. This is THE move: giant condensed-bold declarations, not a title-and-lede.
+
+3. **One red, three jobs, under 5% of any viewport** - red **words** inside a headline use `--color-accent-ink` (`oklch(58% 0.24 28)`, the text-legible red); red **fills, underlines, and the `--rule-fine: 3px` bar** use flat `--color-accent` (`#E51A1A`); focus rings use `--color-focus` (same red). At most **one red word per headline**. Text placed on a red fill is `--color-ink`, never dark ink.
+
+4. **Numbered clauses** - the manifesto reads as articles. Mark each thesis with a `--font-mono` (JetBrains Mono) label, UPPERCASE, tracked at `--tracking-label: 0.10em`: `01 / 02 / 03` or `ARTICLE I`. The mono machine-voice against the Anton shout is the theme's two-register signature.
+
+5. **Hairlines divide, one thick red bar accents** - `--rule-hair: 1px` (`--color-rule`, `oklch(28% 0.010 60)`) separates clauses like a printed broadsheet; a single `--rule-fine: 3px` red bar sits under a section head or leads the hero. Rules do the structural work: **no boxed cards, no drop-shadows**.
+
+6. **Quiet body, loud display - the whole drama is scale contrast** - `--font-body` (Public Sans) set small and plain at `--measure: 56ch`, `--color-ink-2`. The body never competes; it is the calm argument under the shouting headline. The gap between `9rem` caps and `1rem` grotesque IS the theme.
+
+7. **Square, ruler-drawn controls** - buttons and inputs are `0px` radius or hairline-bordered blocks. A primary action is a flat red `#E51A1A` block with `--color-ink` text, or an outlined block that inverts to red on hover. No pills, no soft radii, no gradients.
+
+8. **At most one red-inverted band, as the climax** - the page may flood red **once** (red paper, `--color-ink` text) for the closing thesis or a pull-quote, giving a dark -> red -> dark rhythm and the single showcase beat. One band only: everywhere else red stays a signal.
+
+## Motion
+
+Hard and staccato, not soft. Headline blocks clip-reveal upward once on load; clauses can enter line by line with a snappy ease, never a drift-and-fade. No bounce, no parallax, no autoplay, no red pulsing. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static and fully visible.
+
+## Anti-patterns
+
+- **No pure `#000` ground / `#fff` ink** - warm-tinted charcoal and warm near-white (hue 60-90).
+- **No second accent** - red is the ONLY colour. No blue, no green, no duo-tone pairing (that is Carnival).
+- **No red flood** beyond the single climactic band (signature 8): red is a signal, not a background.
+- **No light / paper ground** - Manifesto is dark. A light statement page routes to Riso or Carnival.
+- **No decorative ornaments** - no fleurons, stickers, hard-offset shadows, tinted paper tricks (Carnival's vocabulary).
+- **No centred hero** (gate 6) - headlines slam left, edge-aligned.
+- **No serif display** - `--font-serif` resolves to Anton on purpose; there is no roman serif here. Display is condensed-bold uppercase.
+- **No lowercase, timid, or title-cased display** - the display voice is UPPERCASE and declarative.
+- **No image-led hero** - type carries the page; a photograph undercuts the broadside.
+
+## Macrostructure affinity
+
+**Manifesto loves these.**
+
+- **Manifesto** - the numbered-declaration shape *(canonical home)*
+- **Long Document** - theses as numbered articles down the page
+- **Stat-Led** - one enormous red number per belief
+- **Quote-Led** - a single line set at display scale
+- **Marquee Hero** - when the hero is one uncompromising statement
+
+**Manifesto refuses these.**
+
+- **Photographic / image-led** - Manifesto argues in type, not imagery
+- **Bento Grid** - too neat and product-shaped for a broadside
+- **Workbench** - tool-first; Manifesto is a stance, not an instrument
+- **Conversational FAQ** - too soft and helpful; the voice declares, it does not chat
+
+## Voice fixtures
+
+Imperative, short, declarative. Fighting words, verbs over adjectives, one red word.
+
+- *"WE REFUSE THE AVERAGE."*
+- *"PRINT DISCIPLINE. ON SCREEN. NO EXCEPTIONS."*
+- *"EVERY PAGE IS AN ARGUMENT."*
+- *"SET IT LOUD. SET IT ONCE."*
+- *"NOTHING SOFT. NOTHING BORROWED."*
+
+Never any of: *seamless, effortless, delightful, gentle, playful, cozy, maybe, perhaps, leverage, synergy*. No hedging, no hype-marketing. State it and stand behind it.
+
+## How Manifesto differs from neighbouring themes
+
+| vs | difference |
+|---|---|
+| **Carnival** (loud-editorial sibling) | Carnival is a **light**, tinted-paper, **duo-tone** decorative page (mustard + oxblood, ornaments, hard-offset shadows, variable Big Shoulders). Manifesto is **dark**, **one red**, raw, condensed-bold Anton, no ornament. Light-decorative vs dark-declarative settles it instantly. |
+| **Brutal** (raw-editorial sibling) | Brutal is a **light 98% sheet** with heavy black rules and Albert Sans 700 - rigid, grid-structural, its one red cutting the near-white. Manifesto is a **dark** warm-charcoal ground with condensed-bold Anton and numbered clauses - composed loudness, not grid rawness. Light-vs-dark and the display face settle it. |
+| **Riso** (print-editorial sibling) | Riso is a **light** print-texture / duotone-registration page. Manifesto is a dark, textureless broadside carried by scale and one red bar, not by ink-misregistration charm. |
+
+## Test brief expectations
+
+Manifesto should be a candidate when the brief mentions:
+
+- *manifesto · statement · declaration · principles · beliefs · mission · movement · protest · cause · campaign · activism · advocacy · "what we stand for" · values · take a stand · bold launch · defiant · anti-establishment · punk*
+- Product categories: *activist / cause org · advocacy campaign · defiant brand launch · editorial statement · agency with an attitude · loud record label · movement or petition page*
+- Emotional tone: *loud · defiant · urgent · declarative · high-contrast · uncompromising · righteous*
+
+Briefs that are calm / product / consumer / image-led route elsewhere (Cobalt for dev-tools, Carnival for light-maximal, the quiet editorial themes for content). When the brief wants to **shout a conviction in type**, it is Manifesto.
+
+## Build hint
+
+The first lines of CSS establish Manifesto's anchor moves:
+
+```css
+html, body { overflow-x: clip; }
+body { background: var(--color-paper); color: var(--color-ink-2);
+ font-family: var(--font-body); font-weight: 400; }
+
+/* The headline is the page - condensed-bold caps, slammed left, leaded tight */
+.display { font-family: var(--font-display); text-transform: uppercase;
+ font-size: var(--text-display); line-height: var(--lh-tight);
+ letter-spacing: var(--tracking-display); color: var(--color-ink);
+ text-align: left; text-wrap: balance; }
+.display .hot { color: var(--color-accent-ink); } /* one red word, max */
+
+/* Mono clause number + the one thick red bar */
+.clause-no { font-family: var(--font-mono); text-transform: uppercase;
+ letter-spacing: var(--tracking-label); color: var(--color-muted); }
+.rule-red { height: var(--rule-fine); background: var(--color-accent); border: 0; }
+
+/* Square controls - a flat red block, never a pill */
+.btn { border-radius: 0; background: var(--color-accent); color: var(--color-ink);
+ border: var(--rule-hair) solid var(--color-accent); }
+:focus-visible { outline: 2px solid var(--color-focus); outline-offset: 2px; }
+
+/* Hard clip-reveal - the whole motion engine */
+.reveal { clip-path: inset(0 0 100% 0); transition: clip-path .5s cubic-bezier(0.2,0.9,0.1,1); }
+.reveal.is-in { clip-path: inset(0 0 0 0); }
+@media (prefers-reduced-motion: reduce) { .reveal { clip-path: none; transition: none; } }
+```
+
+Plus the Anton + Public Sans + JetBrains Mono link and the small clip-reveal script.
diff --git a/skills/hallmark/references/themes/midnight.md b/skills/hallmark/references/themes/midnight.md
new file mode 100644
index 0000000..bdcf81a
--- /dev/null
+++ b/skills/hallmark/references/themes/midnight.md
@@ -0,0 +1,132 @@
+# Theme - Midnight
+
+Atmospheric, cool-nocturnal register. The page for an **AI or dev tool you open after dark** - a generative model playground, a rendering pipeline, an observability console, a late-night creative instrument - but rendered in **cold azure moonlight, not the genre's warm firelight**. A deep midnight-blue canvas (`oklch(15% 0.022 250)`), near-white cool ink, one azure signal, and thin airy Geist display. It reads calm, spacious, cerebral: the small hours, not the golden hour.
+
+Loaded eagerly by SKILL.md Step 3 when the catalog pick is `midnight`. Tokens: [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="midnight"]`. No canonical build yet; mirror the moves below.
+
+> **Why cool, not warm.** The atmospheric cluster defaults to warm blooms (Bloom terracotta, Lumen Night amber). Midnight is the deliberate **cool** exception: it keeps the dark canvas + fade-only motion + centred hero, but aims a single azure accent (hue 220) at the cold-light lane. The blue chill is the differentiator, not a recolour of a warm sibling.
+
+## Axes (diversification)
+
+- **Paper band** - **dark, blue-tinted** (`oklch(15% 0.022 250)`, ~15% L, hue 250). A midnight blue with real chroma, never `#000`. Elevation climbs to `paper-2` `oklch(20% 0.024 250)` and `paper-3` `oklch(25% 0.026 250)`.
+- **Display style** - **geometric-sans, thin** (Geist at `--display-weight: 300`). Airy light-weight display, tracking `-0.03em`. Distinct from Bloom's weighty Geist 600 and every serif sibling.
+- **Accent hue** - **azure / cool cyan-blue** (`oklch(72% 0.16 220)`). Sits a few degrees cyan of the blue ground (250), so it reads as a separate cold light, not a brighter canvas. Clear of Cobalt/Lumen indigos (~256/268). Signal, never flood.
+
+## Reference register
+
+Linear (dark) · Raycast · Vercel dark mode · Resend dark · Cron / calendar dark · Perplexity dark · Diagram · cool nocturnal model playgrounds.
+
+The aesthetic: the cool-dark product page - a deep blue canvas, one cold signal, thin confident display, generous void. Hand-built, moody without being warm.
+
+**Patron-saint reference (internal):** *Linear's cool-dark restraint* + *an observatory at 2 a.m.* - a calm instrument lit by one distant azure light. Ask "does this feel like a cold clear night, or a warm-lit room?" Keep the former.
+
+## Required dependencies
+
+1. **Fonts** - **Geist** (display 300 + body 400/500), **Geist Mono** (labels), **Instrument Serif** (one roman accent moment only). Google Fonts:
+ ```html
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+ <link href="https://fonts.googleapis.com/css2?family=Geist:wght@300;400;500;600&family=Geist+Mono:wght@400;500&family=Instrument+Serif&display=swap" rel="stylesheet" />
+ ```
+2. **A reveal script** - one `IntersectionObserver` adding `.is-in` (fade + ~10px rise, ease-out ~600ms). Fade is the whole motion budget.
+
+## Signature moves
+
+1. **Deep midnight-blue canvas, never black** - `--color-paper: oklch(15% 0.022 250)`. The 0.022 chroma is load-bearing: it is midnight *blue*, not void. Ink is cool near-white `--color-ink: oklch(95% 0.008 230)`; body sits at `--color-ink-2: oklch(86% 0.010 230)`.
+
+2. **Thin Geist display, the airy nocturnal signature** - `--display-weight: 300`, tracking `-0.03em`, `--text-display: clamp(2.75rem, 5vw + 1rem, 5.25rem)`. Light-weight display at large size is the theme's face: spacious, cold, calm. Never the genre-default 600.
+
+3. **One azure signal, used sparingly** (< 5% of any viewport) - `--color-accent: oklch(72% 0.16 220)` on the eyebrow tick, a link hover, the one primary button, focus rings, an active nav item, a single glowing numeral. Everything else is cool-white on blue-dark.
+
+4. **A single cool glow, not two warm blooms** - one fixed radial-gradient low or behind the hero, azure hue ~220-240 at low chroma, fading into the paper like light on a night horizon. Fixed-attached, no animation. Cold light only; never a warm bloom.
+
+5. **Layered dark surfaces + faint hairlines** - build depth with `paper` / `paper-2` / `paper-3`, separated by 1px `--color-rule: oklch(33% 0.024 245)` (or `rule-2` `oklch(48% 0.020 240)` for a brighter edge). Cards float on the elevated layers; hairlines draw the seams. No drop-shadow theatre.
+
+6. **Wide-tracked mono eyebrows** - `--font-label` (Geist Mono), UPPERCASE, `--tracking-label: 0.16em`. The cold machine-readout voice under the thin Geist display. Meta, status, kbd hints all take it.
+
+7. **Generous nocturnal void** - `--section-gap: 6rem`, `--measure: 60ch`, centred or near-centred hero (genre gate 6 loosened). The dark and the space do the work; let the type breathe.
+
+8. **Instrument Serif for one roman moment** - `--font-serif` is available for a single large numeral or a pulled line, **roman only, never italic** (a top AI tell, banned in headers). Never the running display; Geist thin owns that.
+
+## Motion
+
+Fade only, composed and slow. Section reveals fade + rise once. Hover: an azure underline-grow on links, a 1px border shift to `--color-accent` on focusable surfaces. No slide, no bounce, no parallax, no autoplay - the atmosphere carries it. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static and fully visible.
+
+## Anti-patterns
+
+- **No warm accent** (amber, orange, terracotta, gold) - that is Bloom and Lumen-Night. Midnight is azure hue 220.
+- **No pure black canvas** - the ground is blue-tinted `15% 0.022 250`, never `#000` / `#111`.
+- **No heavy display weight** - stay at 300; Geist 600 is Bloom's face, not Midnight's.
+- **No serif display, no italics anywhere** - Geist thin is the display; Instrument Serif is a roman accent only.
+- **No light-paper sections** - Midnight is dark throughout; do not sneak a white band in (genre rule).
+- **No warm-and-cool bloom juggling** - one cool glow, single hue family. No second warm light.
+- **No glassmorphism, no gradient text** (universal gates), no aurora-of-many-hues; one azure light on a blue-dark ground.
+
+## Macrostructure affinity
+
+**Midnight loves:** Marquee Hero (one confident thin-type hero on the dark canvas) · Manifesto (the cold canvas argues a statement) · Stat-Led (azure numerics glowing on blue-dark) · Photographic (the dark ground frames moody visuals) · Feature-stack (stacked capabilities on layered dark surfaces).
+
+**Midnight refuses:** Long Document (prose wants light editorial paper) · Letter (too warm and intimate) · Catalogue (too busy and commercial for the calm dark) · Conversational FAQ (too casual for the cool register).
+
+## Voice fixtures
+
+Cool, nocturnal, spare, a touch cerebral. Name the thing plainly.
+
+- *"Made for the small hours."*
+- *"Render the night in a single pass."*
+- *"A quiet instrument for loud ideas."*
+- *"Ship between midnight and dawn."*
+- *"Cool, exact, awake."*
+
+Never any of: *warm, cozy, golden, firelit, seamless, cutting-edge, revolutionary, supercharge, unlock*. Never italics. Never "click here"; name the command or the number.
+
+## How Midnight differs from neighbouring themes
+
+| vs | what settles it instantly |
+|---|---|
+| **Cobalt** (cool-blue neighbour) | Cobalt is a **light** engineered canvas, Space Grotesk, a literal code/API hero, hue 256. Midnight is a **dark** blue canvas, thin Geist 300, diffuse cool glow, hue 220. Light vs dark, code-hero vs atmosphere. |
+| **Lumen** (atmospheric sibling) | Lumen is **warm** amber-gold (or light indigo), Instrument Serif *display*, one *built* light artefact. Midnight is **cool** azure, Geist thin display, a soft diffuse glow. Warm-serif-apparatus vs cool-thin-sans atmosphere. |
+| **Aurora** (dark cool sibling) | Aurora blooms cyan and runs a **Sentient serif body**. Midnight is all-Geist (sans throughout), more restrained, one azure *signal* rather than a blooming cyan field. Serif-body-blooms vs all-sans-restraint. |
+
+## Test brief expectations
+
+Midnight is a candidate when the brief mentions:
+
+- *AI tool · generative · model playground · render · pipeline · observability · dark mode · nocturnal · late-night · after-hours · moody · cinematic · cool · cerebral · midnight · azure · calm-technical*
+- Product categories: *AI creative tool · generative model UI · dev tool with a moody register · data / observability console · cool nocturnal SaaS*
+- Emotional tone: *cool · calm · nocturnal · spacious · cerebral · quiet-confident · cold-clarity*
+
+Warm / consumer / editorial / image-led-light briefs route elsewhere (Bloom or Lumen-Night for warm atmospheric, Cobalt for a light code tool). When the brief wants dark **and cold**, it is Midnight.
+
+## Build hint
+
+```css
+html, body { overflow-x: clip; }
+body { background: var(--color-paper); color: var(--color-ink-2);
+ font-family: var(--font-body); font-weight: 400; }
+
+/* One fixed cool glow - the whole canvas treatment */
+body::before { content: ""; position: fixed; inset: 0; z-index: -1; pointer-events: none;
+ background: radial-gradient(60% 45% at 50% 82%,
+ oklch(30% 0.06 230 / 0.55), transparent 70%); }
+
+/* Thin airy display + wide-tracked mono eyebrow */
+.display { font-family: var(--font-display); font-weight: var(--display-weight);
+ letter-spacing: var(--tracking-display); font-size: var(--text-display); }
+.eyebrow { font-family: var(--font-label); text-transform: uppercase;
+ letter-spacing: var(--tracking-label); color: var(--color-accent); }
+
+/* The one azure signal */
+.btn--primary { background: var(--color-accent); color: var(--color-paper);
+ border-radius: 8px; }
+a:hover { color: var(--color-accent); }
+
+/* Reveal - fade only */
+.reveal { opacity: 0; transform: translateY(10px);
+ transition: opacity .6s ease, transform .6s ease; }
+.reveal.is-in { opacity: 1; transform: none; }
+@media (prefers-reduced-motion: reduce) {
+ .reveal { opacity: 1; transform: none; transition: none; }
+}
+```
+
+Plus the Geist + Geist Mono + Instrument Serif link and the small reveal script.
diff --git a/skills/hallmark/references/themes/newsprint.md b/skills/hallmark/references/themes/newsprint.md
new file mode 100644
index 0000000..9e32ddb
--- /dev/null
+++ b/skills/hallmark/references/themes/newsprint.md
@@ -0,0 +1,143 @@
+# Theme - Newsprint
+
+The broadsheet front page, rebuilt for the screen. The page for an **essay, an op-ed, a magazine piece, a journalism or newsletter brand, a literary review, a longform publication** - the front-page-of-record school, executed in **warm cream, warm ink, one dried-brick signal**. A masthead over a double rule, hairline column rules, a drop cap opening the lede. It reads like something filed this morning and set by hand: authoritative, literary, calm.
+
+Loaded eagerly by SKILL.md Step 3 whenever the catalog pick is `newsprint`. The OKLCH palette + font stack live in [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="newsprint"]`.
+
+## Axes (diversification)
+
+- **Paper band** - warm light (`L 92%`, hue ~50, low chroma). A warm newsprint cream (`--color-paper: oklch(92% 0.045 50)`), never a cool white and never a neutral grey.
+- **Display style** - **roman serif / Didone** (Playfair Display 700, optical 48). High-contrast: hairline verticals against thick stems. Distinct from any sans or slab; italic is body-emphasis only, never the header face.
+- **Accent hue** - **dried brick** (`--color-accent: oklch(32% 0.10 28)`; text-weight `--color-accent-ink: oklch(45% 0.13 30)`). A muted warm red, used only as furniture. Sits clear of Coral's bright coral and Carnival's oxblood.
+
+## Reference register
+
+The New York Times · The Guardian · The Economist · Financial Times · Le Monde · Bloomberg Businessweek · The Atlantic · The Pudding · The Marginalian · Reuters.
+
+The aesthetic: the front page and the opinion column - centred masthead, dateline furniture, hairline columns, drop-cap ledes, pull-quotes set off by rules. **Never name any of these in the output.**
+
+**Patron-saint reference (internal):** *a broadsheet front page* + *The Economist's rule discipline*, recoloured brick. When in doubt, ask "does this read like a printed page of record, or a marketing template?" Keep the former.
+
+## Required dependencies
+
+1. **Fonts** - **Playfair Display** (display, 700/800/900), **Crimson Pro** (body + italic emphasis, 400/500/600), **Inter** (kickers, bylines, meta labels), **IBM Plex Mono** (folios, edition numerals). Google Fonts:
+ ```html
+ <link href="https://fonts.googleapis.com/css2?family=Playfair+Display:ital,wght@0,700;0,800;0,900;1,700&family=Crimson+Pro:ital,wght@0,400;0,500;0,600;1,400;1,500&family=Inter:wght@500;600&family=IBM+Plex+Mono:wght@400;500&display=swap" rel="stylesheet" />
+ ```
+2. **A small reveal script** - one `IntersectionObserver` adding `.is-in` (fade + ~10px rise, ease-out ~600ms). No type-in, no counters. The page is print; motion is a single quiet entrance.
+
+## Signature moves
+
+1. **Masthead over a double rule.** The hero is a **centred** wordmark in Playfair Display 700+ at display size (`--text-display`), with a thin dateline/edition row (VOL · NO · date · edition) in Inter UPPERCASE, `0.06em` tracking (`--tracking-label`), closed by a **double rule** - two lines in `--color-rule-2` oklch(35% 0.020 35) with a hairline gap. The double-rule masthead is the single most-recognisable Newsprint move. A left-aligned wordmark hero reads as SaaS nav, not broadsheet - centre it.
+
+2. **Warm cream paper, warm ink, never `#fff` / `#000`.** Paper `oklch(92% 0.045 50)`; ink `--color-ink: oklch(15% 0.030 25)` (warm near-black); body sits a notch up at `--color-ink-2: oklch(20% 0.030 28)`; meta/bylines at `--color-muted: oklch(46% 0.022 35)`. Every value is warm (hue 25-50); no neutral grey anywhere.
+
+3. **Didone headline against book-serif body.** Playfair Display 700, optical 48, `--tracking-display: -0.022em` for heads and decks; Crimson Pro at `--text-base: 1.0625rem`, `--lh-normal: 1.55`, `--measure: 58ch` for body. The tension between the sparkling high-contrast head and the calm book serif is the voice. Italic = Crimson Pro emphasis in running text only.
+
+4. **Multi-column body with a hairline column rule.** Longform flows in 2-3 columns split by a single `--color-rule` hairline oklch(68% 0.030 40): `column-rule: 1px solid var(--color-rule)`. The broadsheet sets text in columns, never one wide wall.
+
+5. **Drop cap opens the lede.** The lead story's first paragraph opens with a Playfair Display drop cap (float, ~3 lines tall) in `--color-ink` or the brick accent. One per page - the newspaper's classic entry.
+
+6. **One brick signal, < 5% of any viewport.** `--color-accent` oklch(32% 0.10 28) for a kicker tick, a pull-quote rule, a section marker; `--color-accent-ink` oklch(45% 0.13 30) when brick must read as coloured **text** (the one link, a standfirst dash); `--color-focus` oklch(48% 0.18 30) for focus rings. Never a fill behind a whole section, never a flood.
+
+7. **Furniture in the label voice.** Kickers ("OPINION", "CULTURE"), bylines ("BY A. REPORTER"), datelines, and folios in Inter UPPERCASE `0.06em`, small; edition numerals in IBM Plex Mono. This small-caps furniture frames the serif columns - it is the broadsheet's machine-readout register.
+
+8. **Rules and whitespace, no cards.** Sections divide with a `--color-rule` hairline and a `--color-rule-2` double rule at major breaks. No boxed cards, no drop-shadows, no rounded corners (radius 0). Pull-quotes hang between a top-and-bottom hairline with a brick indent, never in a box.
+
+## Motion
+
+Quiet and singular. One orchestrated reveal (fade + ~10px rise) as sections enter. Hover: a brick underline-grow on links. **No parallax, no type-in, no counters, no autoplay.** Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static and fully visible.
+
+## Anti-patterns
+
+- **No pure `#fff` paper / `#000` ink.** Warm cream + warm near-black only (hue 25-50).
+- **No cool or blue accent.** Newsprint's signal is warm brick (hue 28); cool signals belong to Cobalt / Midnight.
+- **No left-aligned wordmark hero.** The masthead centres; a left wordmark is modern-minimal vocabulary.
+- **No boxed cards, drop-shadows, or rounded corners.** Hairlines and double rules carry structure; radius 0.
+- **No duo-tone, ornaments, or hard-offset shadows.** That loudness is Carnival. Newsprint is one brick signal, no mustard, no `✱` dividers.
+- **No single wide column of body text.** Longform runs in columns with a hairline column rule.
+- **No sans-serif body.** Crimson Pro serif is the body; Inter is confined to kickers, bylines, and meta.
+- **No gradient, glassmorphism, or background pattern.** The paper is flat warm cream; a faint fibre texture is the most it tolerates, off by default.
+
+## Macrostructure affinity / rejection
+
+**Newsprint loves these.**
+
+- **Long Document** - prose-led broadsheet; *the* canonical fit
+- **Letter** - the opinion column or editor's note
+- **Quote-Led** - pull-quotes are native furniture
+- **Manifesto** - a masthead opinion statement (quieter than Carnival's)
+- **index-first** - a front-page index of headlines and standfirsts
+
+**Newsprint refuses these.**
+
+- **Bento Grid** - gridded product tiles; too boxed, too SaaS - broadsheet uses columns
+- **Workbench** - technical tool spec; route Cobalt
+- **Marquee Hero** - kinetic and loud; route Carnival
+- **Photographic** - image-led hero; Newsprint leads with type and rules (a captioned cut is fine, not the hero)
+
+## Voice fixtures
+
+Specific, declarative, a dry editorial wit. Name the section, the date, the fact.
+
+- *"All the type that's fit to set."*
+- *"Filed this morning. Set by hand."*
+- *"The front page, rebuilt for the screen."*
+- *"Opinion: the hairline still holds."*
+- *"Vol. IV, No. 12. Read on."*
+
+Never any of: *seamless, robust, cutting-edge, leverage, synergy, unlock, supercharge, revolutionary, curated experience, storytelling journey*. Never "click here" - name the section or the byline.
+
+## How Newsprint differs from neighbouring themes
+
+| vs | difference |
+|---|---|
+| **Carnival** (same warm paper band) | Carnival is loud duo-tone maximalism: mustard + oxblood, Big Shoulders 800, ornaments, hard-offset shadows. Newsprint is quiet broadsheet: one brick signal, Playfair Didone, hairlines, no ornaments. Same cream, opposite volume. |
+| **Almanac** (reference-desk cousin) | Almanac is the data / reference register - tabular figures, seasonal tables, ledger rules. Newsprint is the front-page story register - masthead, drop-cap ledes, bylines, running columns. Table vs column settles it. |
+| **Riso** (print-craft cousin) | Riso is risograph craft: peach paper, CMYK misregistration, cyan + yellow. Newsprint is letterpress broadsheet: warm cream, one brick, crisp registration, Didone. Different print tradition. |
+| **Manifesto** (editorial sibling) | Manifesto is black paper + ALL-CAPS Anton in red - inverted polarity, loud. Newsprint is cream paper + Playfair + brick furniture - light and composed. Dark-vs-light settles it instantly. |
+
+## Test brief expectations
+
+Newsprint should be a candidate when the brief mentions:
+
+- *newspaper · broadsheet · editorial · magazine · journalism · publication · newsletter · op-ed · opinion · essay · longform · column · reportage · press · gazette · review · dispatch · weekly · daily · print · literary*
+- Product categories: *news publication · magazine · editorial site · newsletter · essay or blog · journalism · opinion / review · media brand · literary journal*
+- Emotional tone: *authoritative · considered · literary · print-craft · warm · trustworthy · hand-set · timeless*
+
+Route elsewhere: dev / API -> Cobalt; loud music / zine -> Carnival; data / reference / seasonal -> Almanac; risograph print-craft -> Riso.
+
+## Build hint
+
+The first lines of CSS establish Newsprint's anchor moves:
+
+```css
+html, body { overflow-x: clip; }
+body { background: var(--color-paper); color: var(--color-ink-2);
+ font-family: var(--font-body); font-weight: 400; line-height: var(--lh-normal); }
+
+/* Masthead: centred wordmark closed by a double rule */
+.masthead { text-align: center; font-family: var(--font-display); font-weight: 700;
+ letter-spacing: var(--tracking-display); }
+.masthead::after { content: ""; display: block; height: 4px;
+ border-top: 1px solid var(--color-rule-2);
+ border-bottom: 1px solid var(--color-rule-2); }
+.kicker, .byline { font-family: var(--font-label); text-transform: uppercase;
+ letter-spacing: var(--tracking-label); color: var(--color-muted); }
+
+/* Columns with a hairline rule; drop cap opens the lede */
+.story { columns: 2; column-gap: 2.5rem; column-rule: 1px solid var(--color-rule);
+ max-width: var(--measure); }
+.story > p:first-of-type::first-letter { float: left; font-family: var(--font-display);
+ font-weight: 800; font-size: 3.4em; line-height: 0.8; padding-right: 0.06em; }
+
+/* The one brick signal */
+a { color: var(--color-accent-ink); text-decoration-color: var(--color-accent); }
+
+.reveal { opacity: 0; transform: translateY(10px);
+ transition: opacity .6s ease-out, transform .6s ease-out; }
+.reveal.is-in { opacity: 1; transform: none; }
+@media (prefers-reduced-motion: reduce) { .reveal { opacity: 1; transform: none; transition: none; } }
+```
+
+Plus the Playfair Display + Crimson Pro + Inter + IBM Plex Mono link and the small reveal script.
diff --git a/skills/hallmark/references/themes/riso.md b/skills/hallmark/references/themes/riso.md
new file mode 100644
index 0000000..3e759f9
--- /dev/null
+++ b/skills/hallmark/references/themes/riso.md
@@ -0,0 +1,139 @@
+# Theme - Riso
+
+Risograph-print register. The page for a **print fair, zine fest, small press, poster shop, illustration studio, art-book event** - warm blush stock, two saturated spot inks printed slightly out of register, paper you can almost smell. It reads like a soy-ink poster that got a URL: heavy grotesk headlines misregistered in cyan and pink, a serif lede, a machine-set catalogue underneath.
+
+Loaded eagerly by SKILL.md Step 3 when the catalog pick is `riso`. Tokens: [`site/css/tokens.css`](../../../../site/css/tokens.css) `[data-theme="riso"]`. Canonical build: [`site/examples/riso-01/`](../../../../site/examples/riso-01/) (an "OFF-REGISTER" risograph print fair - masthead, misregistered hero mark, exhibitor catalogue).
+
+## Axes (diversification)
+
+- **Paper band** - light warm blush, `oklch(91% 0.034 30)`. A soft pink/peach newsprint ground, ink `oklch(18% 0.060 30)`. Not white, not cool - everything tinted hue 30.
+- **Display style** - grotesk-sans: **Public Sans 800/900**, tight `--tracking-display: -0.04em`, `--lh-tight: 0.92`. Heavy poster grotesk, distinct from every serif-display sibling.
+- **Accent hue** - cool riso cyan/teal, `oklch(58% 0.170 220)`, paired with riso yellow `oklch(78% 0.180 95)`. Two spot inks overprinted, never flooded.
+
+## Reference register
+
+Risotto Studio · Hato Press · Nieves · Colorama · People of Print · Present & Correct · Draw Down Books · It's Nice That · Printed Matter fairs.
+
+The aesthetic: the risograph poster and small-press catalogue - warm stock, spot-colour duotone, deliberate misregistration, halftone grain, an inventory laid out like a listings page. Never name any of these in the output.
+
+**Patron-saint reference (internal):** *a two-colour riso print that missed register by a hair* - the offset is the charm, not a defect. When in doubt, ask "does this look printed on a drum, or exported from a vector tool?" Keep the former.
+
+## Required dependencies
+
+1. **Fonts** - **Public Sans** (display 800/900 + labels), **Newsreader** (serif body/lede), **Geist Mono** (uppercase machine labels, captions, counts). Google Fonts:
+ ```html
+ <link href="https://fonts.googleapis.com/css2?family=Public+Sans:wght@400;600;800;900&family=Newsreader:ital,opsz,wght@0,6..72,400;0,6..72,500;1,6..72,400&family=Geist+Mono:wght@400;500;700&display=swap" rel="stylesheet" />
+ ```
+2. **A small reveal script** - one `IntersectionObserver` adding `.is-in` (fade + ~10px rise, ease-out ~600ms). No autoplay, no loop.
+3. **The `riso-mis` overprint** - a headline word / wordmark carries two offset echoes via `data-text` + `::before`/`::after`, `mix-blend-mode: multiply`. This is the theme's whole identity; ship it on at least the hero title and the masthead.
+
+## Signature moves
+
+1. **Off-register overprint (THE move)** - a key headline word and the wordmark get a misregistered echo: `::before` in cyan `oklch(58% 0.170 220)` nudged up-left ~2px, `::after` in a riso pink nudged down-right ~2px, both `mix-blend-mode: multiply` over the black `data-text`. The colour fringes read as ink that missed the drum. Use on 1-2 focal words only, never every heading.
+
+2. **Warm blush paper, never white** - ground is `oklch(91% 0.034 30)`, panels step to `--color-paper-2` / `--color-paper-3` (87% / 82%, same hue). Ink is warm near-black `oklch(18% 0.060 30)`, body `--color-neutral` `oklch(34% 0.060 30)`. Every neutral tilts hue 30.
+
+3. **Two spot inks, overprinted and multiply-blended** - cyan 220° + yellow 95° are the only colours. Where they cross, `mix-blend-mode: multiply` makes a third hue for free. The pure-CSS riso plate centrepiece = three ink shapes stacked, misregistered, multiplied, with a grain layer on top.
+
+4. **Halftone / paper grain** - a faint noise or dot-grain overlay sits on the ink art (and optionally very lightly on paper) so fills read printed, not vector. Riso is the one editorial theme where texture belongs - keep it on the ink, subtle, never a loud full-page flood.
+
+5. **Newspaper masthead + catalogue body** - N6 masthead: issue line (`Edition 04 · Govanhill · Free entry`), big wordmark, thin nav, double rule. The page body is a **Catalogue/Specimen** - a uniform, filterable grid of exhibitors/items. Riso is an index, not a sales pitch.
+
+6. **Heavy grotesk over serif** - Public Sans 800/900 display at `-0.04em` and `--lh-tight: 0.92`; Newsreader serif for lede and running body at 45-75ch. The poster-headline / reading-serif contrast is load-bearing.
+
+7. **Mono machine labels** - Geist Mono, UPPERCASE, `--tracking-label: 0.06em` for kickers, plate captions (`Plate 04 · 3 colours · 280 gsm`), item counts, meta. The print-shop readout voice against the grotesk.
+
+8. **Spot highlight + hairlines, zero shadow** - single-accent `<mark>` band at x-height, `--color-rule` `oklch(70% 0.040 30)` hairlines, solid rectangle buttons. No boxed cards, no drop-shadow, no blur; depth comes from overprint and rule.
+
+## Motion
+
+Quiet and printed. Section reveals fade + rise once. The misregistration may settle on load (echoes drift a hair into their offset, then rest) but never loops. Hover: rule-colour shift to accent, mark-band grow. No bounce, no parallax, no autoplay. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships the offsets static and fully visible.
+
+## Anti-patterns
+
+- **No clean vector flatness** - riso must show the offset fringe + grain. Perfectly-registered, texture-free fills read as generic and kill the theme.
+- **No cool-white or pure-white paper** - that is Cobalt's ground. Riso paper is warm blush, hue 30.
+- **No pure `#000` ink** - warm near-black `oklch(18% 0.060 30)`.
+- **No gradient / glow / neon / aurora-mesh** - riso is flat spot inks multiplied, not RGB light. Colour comes from overprint, not luminance.
+- **No drop shadows, no boxed or card-in-card layouts** - hairlines and overprint carry structure.
+- **No floating pill nav, no pill-gradient CTA** - masthead + a solid rectangle button.
+- **Don't drown the page in ink** - two spot colours as accents (< ~15% of any viewport); the blush paper stays dominant.
+- **Don't borrow Carnival's kit** - its offset is a hard solid box-shadow and its duo is mustard/oxblood. Riso's offset is ink misregistration; its duo is cyan/yellow. Keep them apart.
+
+## Macrostructure affinity / rejection
+
+**Riso loves these.**
+
+- **Catalogue** - the exhibitor / item / stockist index grid *(canonical - riso-01)*
+- **Specimen** - a type or print specimen shown in overprint
+- **Marquee Hero** - one big off-register poster statement above the fold
+- **Type-specimen** - the grotesk face demoed in spot colour
+- **Manifesto** - a loud printed statement page (print-fair voice)
+
+**Riso refuses these.**
+
+- **Workbench / component-playground** - too instrument-panel; that is Cobalt's shape
+- **Conversational FAQ** - too chatty-product for a print object
+- **Photographic** - riso leads with printed ink art, not photography
+- **Stat-Led / Bento dashboard** - riso is a printed page, not a metrics grid
+
+## Voice fixtures
+
+Specific, hand-set, a little literary. Verbs and counts over adjectives.
+
+- *"Thirty-four studios. Eight presses. Soy ink everywhere."*
+- *"Design like print: warm, off-register, intentional."*
+- *"One drum at a time."*
+- *"Fluorescent pink that won't sit still, teal that bleeds a hair past its edge."*
+- *"Free entry - first 200 get a printed map."*
+
+Never any of: *seamless, cutting-edge, revolutionary, synergy, leverage, premium, glossy, pixel-perfect*. Never "click here." Riso is deliberately imperfect - never sell it as flawless.
+
+## How Riso differs from neighbouring themes
+
+| vs | what settles it instantly |
+|---|---|
+| **Carnival** (loud editorial sibling) | Carnival = duotone mustard + oxblood, chunky variable display, hard-offset **box-shadow**, decorative ornaments. Riso = cyan + yellow **spot inks**, off-register overprint + grain (misregistration, not a solid shadow), warm blush paper. Offset-as-ink vs offset-as-shadow. |
+| **Newsprint** (paper sibling) | Newsprint = warm cream stock, columns, one-brick ink-only restraint (no spot colour). Riso = warm pink paper + two saturated spot inks (cyan + yellow) + printed grain. Spot colour and print-artifact texture settle it. |
+| **Brutal** (editorial sibling) | Brutal = raw system type, hard mono borders, cold. Riso = crafted print object - grotesk + serif, spot inks, grain, warmth. Craft and colour vs raw and monochrome. |
+
+## Test brief expectations
+
+Riso should be a candidate when the brief mentions:
+
+- *risograph · riso · print fair · zine · zine fest · small press · letterpress · screenprint · poster · gig poster · art book · book fair · spot colour · illustration studio · indie press · DIY · print studio · stockist*
+- Product categories: *print fair · zine fest · art-book event · poster shop · illustration / print studio · indie publisher · creative-studio event*
+- Emotional tone: *warm · tactile · handmade · off-register · analog · spot-colour · playful-craft · printed*
+
+Briefs that are cool/technical route to Cobalt; loud-decorative editorial routes to Carnival; grey ink-only routes to Newsprint. When the brief wants ink on warm stock with a colour that misses register, it is Riso.
+
+## Build hint
+
+The first lines of CSS establish Riso's anchor moves:
+
+```css
+html, body { overflow-x: clip; }
+body { background: var(--color-paper); color: var(--color-ink);
+ font-family: var(--font-body); font-weight: 400; }
+
+/* Grotesk display, tight and heavy */
+.display { font-family: var(--font-display); font-weight: var(--display-weight);
+ letter-spacing: var(--tracking-display); line-height: var(--lh-tight); }
+
+/* THE move - off-register overprint via data-text echoes */
+.riso-mis { position: relative; color: var(--color-ink); }
+.riso-mis::before, .riso-mis::after {
+ content: attr(data-text); position: absolute; inset: 0;
+ mix-blend-mode: multiply; pointer-events: none; }
+.riso-mis::before { color: var(--color-accent); transform: translate(-2px, -2px); } /* cyan */
+.riso-mis::after { color: oklch(64% 0.19 12); transform: translate( 2px, 2px); } /* pink */
+
+/* Hairlines + solid rectangle button, never a pill or shadow */
+.rule { border-top: 1px solid var(--color-rule); }
+.btn--solid { background: var(--color-accent); color: var(--color-paper); border-radius: 2px; }
+mark { background: var(--color-accent-2); color: var(--color-ink); } /* yellow band at x-height */
+
+@media (prefers-reduced-motion: reduce) { .reveal { opacity: 1; transform: none; } }
+```
+
+Plus the Public Sans + Newsreader + Geist Mono link and the small reveal script. The canonical build to mirror is [`site/examples/riso-01/`](../../../../site/examples/riso-01/).
diff --git a/skills/hallmark/references/themes/specimen.md b/skills/hallmark/references/themes/specimen.md
new file mode 100644
index 0000000..e2f0e45
--- /dev/null
+++ b/skills/hallmark/references/themes/specimen.md
@@ -0,0 +1,134 @@
+# Theme - Specimen
+
+The `:root` default and the canonical Hallmark editorial voice. The page for a **type foundry, a design portfolio, a magazine essay, an agency site, a considered brand story** - the type-specimen school, where one high-contrast serif set enormous and thin *is* the page. Warm oat paper, a single signal-orange mark, ruler-drawn hairlines, and Fraunces shown at specimen scale. It reads like a well-set printed page: quiet, warm, exact.
+
+Loaded eagerly by SKILL.md Step 3 whenever the catalog pick is `specimen` (also the silent default when no other theme signal fires). Tokens: [`site/css/tokens.css`](../../../../site/css/tokens.css) under `:root` / `[data-theme="specimen"]`. No canonical example folder yet - build to this spec.
+
+## Axes (diversification)
+
+- **Paper band** - warm oat (`oklch(96% 0.018 80)`, hue 80). A cream near-white with real yellow warmth, distinct from Almanac's cool blue-grey oat and Atelier's near-neutral taupe.
+- **Display style** - **high-contrast serif** (Fraunces, light). `--display-weight: 340`, `--display-optical: 144` (the largest, highest-contrast optical cut), `--display-soft: 20`. Thin and elegant, never the black display of Atelier/Newsprint.
+- **Accent hue** - **signal orange** (`#FC4C02`, hue ~33). One warm spark, `--color-accent-ink: oklch(55% 0.21 32)` for legible orange text on oat. A signal, never a flood.
+
+## Reference register
+
+Klim / Commercial Type foundry specimens · Pentagram · Aesop · Cereal · Kinfolk · It's Nice That · Readymag editorial · Frere-Jones. The aesthetic: the printed type specimen and the considered editorial portfolio - one serif shown at scale, hairline structure, mono folios, generous paper. **Never name any of these in the output.**
+
+**Patron-saint reference (internal):** *a type foundry's specimen sheet* - one word set at 96pt, a weight ladder, a glyph grid, a single ink colour. When in doubt ask "does this read like a printed specimen, or a marketing template?" Keep the former.
+
+## Required dependencies
+
+1. **Fonts** - **Fraunces** (display + serif emphasis, variable opsz/wght/SOFT), **Geist** (body sans, 400/500/600), **Geist Mono** (labels + meta). Google Fonts:
+ ```html
+ <link rel="preconnect" href="https://fonts.googleapis.com">
+ <link href="https://fonts.googleapis.com/css2?family=Fraunces:ital,opsz,wght,SOFT@0,9..144,300..700,0..100;1,9..144,300..700,0..100&family=Geist:wght@400;500;600&family=Geist+Mono:wght@400;500&display=swap" rel="stylesheet">
+ ```
+2. **A small reveal script** - one `IntersectionObserver` adding `.is-in` (fade + ~10px rise, `--ease-out`, ~600ms). Optional one-shot: a weight/optical ladder that settles once, then static. No other required JS - Specimen is a reading page, not a tool.
+
+## Signature moves
+
+1. **Warm oat paper, never `#fff`** - `--color-paper: oklch(96% 0.018 80)`. Ink is warm near-black `--color-ink: oklch(18% 0.014 60)`, never `#000`; body sits a notch up at `--color-ink-2: oklch(26% 0.014 60)`. Everything tinted warm (hue 60-80).
+
+2. **Specimen-scale Fraunces, thin and huge** - the hero is one word or a short phrase set enormous and LIGHT: `--display-weight: 340`, `font-variation-settings: "opsz" 144, "SOFT" 20`, `--text-display: clamp(3rem, 5.5vw + 1rem, 5.75rem)`, `--tracking-display: -0.025em`, `--lh-tight: 1.02`. The high-contrast serif carries the page; the type *is* the graphic.
+
+3. **One signal-orange mark, < 5% of any viewport** - `--color-accent: #FC4C02` on the eyebrow tick, a link underline, one CTA, the drop cap, the focus ring, a single italic emphasis. Everything else is warm ink on oat. Orange never fills a band or a card.
+
+4. **Hairlines, square corners, no shadow** - `--rule-card: 1px`, `--radius-card: 0`, `--shadow-card: none`, `--rule-hair: 0.5px`. Structure is drawn with rules, columns, double-rules and fleurons - never boxed cards or blur. Editorial ornament (fleuron, drop cap) is welcome; depth is not.
+
+5. **Geist Mono uppercase labels** - eyebrows, meta, folios, figure captions in `--font-mono` (Geist Mono), UPPERCASE, `--tracking-label: 0.12em`, `--text-xs`, colour `--color-muted`. The machine-readout counterpoint that keeps the warm serif from going soft.
+
+6. **Sans body under a serif display** - body is Geist (`--font-body`) at `--measure: 62ch`, `--lh-normal: 1.45`. The sans-under-serif contrast is the specimen tension. Fraunces italic is for pull-quotes and single-word emphasis only, never the display face (global rule).
+
+7. **Asymmetric editorial grid** - `--page-max: 76rem`, left-biased hero (headline left, meta or figure right), 2:5 or 3:7 prose columns, edge-aligned headlines. Never centred-everything (gate 6).
+
+8. **Specimen character on show** - an orange Fraunces drop cap, a weight/optical ladder, a glyph or figure row, mono folio numbers. The page quietly demonstrates the typeface it is set in.
+
+## Motion
+
+Quiet and composed. One orchestrated entrance: section reveals fade + rise (`--ease-out`, ~600ms). Optionally one weight/optical ladder that settles once, then holds static. Hover: orange underline-grow on links; a 1px rule shift toward accent on focusable surfaces. No bounce, no parallax, no autoplay. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static and fully visible.
+
+## Anti-patterns
+
+- **No pure `#fff` paper / `#000` ink.** Warm oat, warm near-black - always tinted toward hue 60-80.
+- **No heavy/black display.** Fraunces stays light (340). Playfair-900 heft is Atelier's move; a bold hero reads as a different theme.
+- **No cool paper.** Cool blue-grey oat is Almanac's; salmon-pink is Newsprint's. Specimen is warm.
+- **No second accent.** One signal orange only - no teal, blue, or companion hue.
+- **No rounded corners, pills, or shadows.** Square, hairline, flat.
+- **No card-in-card, no three-equal-icon-tile grid, no glassmorphism, no gradient text, no mesh/aurora blob, no background texture.** Oat paper + hairlines + one orange mark carry it.
+- **No orange flood.** The accent is a spark on a mark, never a fill behind type or a full band.
+
+## Macrostructure affinity / rejection
+
+**Specimen loves:** **Type Specimen / Specimen** *(canonical - one face at scale, weight ladder, glyph grid)* · **Long Document** (editorial essay, drop cap, hairlines) · **Portfolio Grid** (a considered work index) · **Manifesto** (when the serif carries a statement) · **Letter / Quote-Led** (intimate editorial voice).
+
+**Specimen refuses:** **Workbench / component-playground** (tool-first, route Cobalt/Almanac) · **Bento Grid** (modular tile logic fights the column) · **Stat-Led dashboard** (numbers-first apparatus) · **Map-diagram / ecosystem-index** (systems diagram, not a printed page).
+
+## Voice fixtures
+
+Editorial, hand-set, lightly literary. Verbs over adjectives; name the thing concretely.
+
+- *"Set in Fraunces, at ninety-six points."*
+- *"One typeface, argued at length."*
+- *"Warm paper, cold rules, one orange mark."*
+- *"Weight three-forty. Optical size one-forty-four. Nothing louder."*
+- *"The page, composed like a specimen sheet."*
+
+Never any of: *seamless, robust, cutting-edge, leverage, synergy, elevate, unlock, supercharge, curated*. Never "click here" - name the section, the number, the face.
+
+## How Specimen differs from neighbouring themes
+
+| vs | what settles it instantly |
+|---|---|
+| **Atelier** (editorial serif sibling) | Atelier is Playfair Display at weight **900** (heavy, dramatic), near-neutral taupe paper, oxblood/near-black accent (`oklch(22% 0.060 40)`). Specimen is Fraunces at **340** (thin), warmer oat, signal-orange accent. Thin-plus-orange vs black-plus-oxblood. |
+| **Newsprint** (broadsheet) | Newsprint is salmon-pink paper (`oklch(92% 0.045 50)`), **serif body** (Crimson Pro), Playfair-700 display, burgundy accent, broadsheet columns. Specimen has **sans body** (Geist), oat not pink, orange not burgundy. |
+| **Almanac** (technical almanac) | Almanac is **cool** blue-grey paper (hue 245), **sans display** (Hanken Grotesk), blue accent, dense small type. Specimen is warm, serif-display, orange. Warm-serif vs cool-sans. |
+
+## Test brief expectations
+
+Specimen is a candidate (and the default fallback) when the brief mentions:
+
+- *type specimen · typography · foundry · letterform · portfolio · editorial · magazine · essay · manifesto · studio · agency · brand story · print · publication · considered · craft · design-led*
+- Product categories: *type foundry · design portfolio · editorial/magazine · agency site · personal site · brand story · indie publication*
+- Emotional tone: *literary · hand-set · warm · considered · high-craft · quiet-confident · editorial*
+
+When the brief names no specialised aesthetic ("a landing page for X"), it lands here. Cool/technical routes to Almanac or Cobalt; loud-maximalist to Carnival; heavy-dramatic serif to Atelier.
+
+## Build hint
+
+The first lines of CSS establish Specimen's anchor moves:
+
+```css
+html, body { overflow-x: clip; }
+body { background: var(--color-paper); color: var(--color-ink-2);
+ font-family: var(--font-body); font-weight: 400; }
+
+/* Specimen-scale display - Fraunces, light, max optical size */
+.display { font-family: var(--font-display); font-weight: var(--display-weight); /* 340 */
+ font-variation-settings: "opsz" var(--display-optical), "SOFT" var(--display-soft);
+ font-size: var(--text-display); letter-spacing: var(--tracking-display);
+ line-height: var(--lh-tight); }
+
+/* Mono label - the machine-readout counterpoint */
+.label { font-family: var(--font-mono); text-transform: uppercase;
+ letter-spacing: var(--tracking-label); font-size: var(--text-xs);
+ color: var(--color-muted); }
+
+/* Hairline structure, square corners, no shadow */
+.rule { border-top: var(--rule-fine) solid var(--color-rule); }
+.card { border: var(--rule-card) solid var(--color-rule);
+ border-radius: var(--radius-card); box-shadow: var(--shadow-card); }
+
+/* The one signal - orange, used sparingly */
+a { text-decoration-color: var(--color-accent); }
+.dropcap::first-letter { color: var(--color-accent); font-family: var(--font-display); }
+:focus-visible { outline: 2px solid var(--color-focus); }
+
+.reveal { opacity: 0; transform: translateY(10px);
+ transition: opacity .6s var(--ease-out), transform .6s var(--ease-out); }
+.reveal.is-in { opacity: 1; transform: none; }
+@media (prefers-reduced-motion: reduce) {
+ .reveal { opacity: 1; transform: none; transition: none; }
+}
+```
+
+Plus the Fraunces + Geist + Geist Mono link and the small reveal script.
diff --git a/skills/hallmark/references/themes/sport.md b/skills/hallmark/references/themes/sport.md
new file mode 100644
index 0000000..77b59f7
--- /dev/null
+++ b/skills/hallmark/references/themes/sport.md
@@ -0,0 +1,143 @@
+# Theme - Sport
+
+Athletic editorial, scoreboard register. The page for a running club, a race event, a training program, a team or league, a performance-gear drop, a fixtures / standings board. A cool concrete-grey ground (`oklch(98% 0.003 250)`), blue-black ink (`oklch(16% 0.080 260)`), uppercase condensed Inter Tight heads, tabular JetBrains Mono numerals, and exactly ONE blaze-orange signal (`oklch(58% 0.190 35)`). It reads like a timed event: fast, measured, competitive.
+
+Loaded eagerly by SKILL.md Step 3 when the catalog pick is `sport`. Tokens: `site/css/tokens.css` `[data-theme="sport"]`. No canonical build yet; mirror the token anchors in Build hint below.
+
+## Axes (diversification)
+
+- **Paper band** - light, cool concrete (`--color-paper oklch(98% 0.003 250)`, L 98, hue 250, near-zero chroma). An engineered near-white with a faint cool cast. Not warm cream (Carnival, Riso), not black (Manifesto).
+- **Display style** - display-condensed, uppercase. Inter Tight `--display-weight 700`, opsz token `96`, `--tracking-display -0.04em`, all-caps on the `--lh-tight 1.02` floor. Upright, never italic (`--display-style: normal`).
+- **Accent hue** - warm blaze-orange (`--color-accent oklch(58% 0.190 35)`; as text `--color-accent-ink oklch(54% 0.20 35)`). High-chroma safety-orange, used as a single signal, never a flood. Clear of Coral's coral and Lumen's brass.
+
+## Reference register
+
+On Running · Bandit Running · Soar · District Vision · Strava · Whoop · Formula 1 result boards · NBA scoreboards · Wilson · Gymshark.
+
+The aesthetic: the clinical performance grid, the race-bib crop, the standings table, the split-time readout. **Patron-saint (internal):** a stadium scoreboard's mono precision + a running-club singlet, recoloured blaze-orange on cool concrete. When in doubt ask "does this read like a timed result board, or a wellness landing page?" Keep the former. **Never name any of these in the output.**
+
+## Required dependencies
+
+1. **Fonts** - **Inter Tight** (display, 700/800, uppercase), **Albert Sans** (body, 400/500/600), **JetBrains Mono** (numerals + UPPERCASE labels). All-sans; no serif. Google Fonts:
+ ```html
+ <link href="https://fonts.googleapis.com/css2?family=Inter+Tight:wght@500;600;700;800&family=Albert+Sans:wght@400;500;600&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet" />
+ ```
+2. **A reveal script** - one `IntersectionObserver` adding `.is-in` (fade + ~10px rise, ease-out ~600ms).
+3. **A count-up script** - stat numerals tick to their final value once on reveal (the scoreboard flip). Reduced-motion renders the final number static.
+
+## Signature moves
+
+1. **Cool concrete paper, blue-black ink, never `#fff` / `#000`.** Paper `oklch(98% 0.003 250)`; ink `oklch(16% 0.080 260)` is a cool near-navy black (chroma 0.08, visibly blue, not warm charcoal). Body sits at `--color-ink-2 oklch(22% 0.060 258)`, meta at `--color-muted oklch(50% 0.020 250)`.
+
+2. **Uppercase condensed display, tracked tight.** Inter Tight 700 all-caps at `--tracking-display -0.04em`, `--lh-tight 1.02`. The tension lives in the caps and the tracking, not a slant - upright, never italic. Two-line all-caps heads risk ascender/descender collision (see the token note): hold the 1.02 floor, never drop under it.
+
+3. **One blaze-orange signal, < 5% of any viewport.** `oklch(58% 0.190 35)` marks the race-bib number, the one primary CTA, the active fixture, a link underline, the focus ring, the single lane stripe. Everything else is cool grey + ink. Orange-as-text uses `--color-accent-ink`.
+
+4. **The scoreboard: mono tabular numerals, set large.** JetBrains Mono with `font-variant-numeric: tabular-nums` for times, splits, scores, distances, dates. The number is the content and outsizes its label. The stopwatch / standings voice.
+
+5. **Two-weight rule system, never boxed cards.** Hairline `--color-rule oklch(78% 0.008 250)` at `--rule-hair 1px` rules table rows and fine grids; heavy `--color-rule-2 oklch(36% 0.060 255)` at `--rule-fine 2px` frames the scoreboard and breaks sections. Depth from rules, never soft shadows or card-in-card.
+
+6. **A single lane stripe.** One vertical or diagonal orange bar (a track lane / speed stripe / finish line) in `--color-accent`, pure CSS, placed ONCE as the page's kinetic graphic. Never repeated as decoration.
+
+7. **Mono labels, uppercase, tracked wide.** Eyebrows, meta, bib tags in JetBrains Mono, uppercase, `--tracking-label 0.10em`. The wide mono label is the ONLY place caps go loose; the display stays tight (move 2).
+
+8. **Fast section rhythm.** Sections at `--section-gap 5.5rem`, heads tight above their content at `--section-head-gap 1.25rem`, prose capped at `--measure 58ch`.
+
+## Motion
+
+Kinetic but disciplined. Section reveals fade + rise. Stat numerals count up once on reveal (the scoreboard flip). Hover: orange underline-grow on links, a 2px border shift to orange on focusable rows. No parallax, no autoplay, no bounce. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships final numbers, full visibility, static.
+
+## Anti-patterns
+
+- **No italic display.** `--display-style: normal`; the athletic lean comes from tracking and layout, not slanted type.
+- **No warm paper.** Sport is cool (hue 250). Warm grey / cream is Carnival, Riso, Almanac.
+- **No second accent, no duo-tone.** One orange signal only; duo-tone belongs to Carnival.
+- **No hard-offset poster shadow** (`4px 4px 0`). Rules carry structure; the offset shadow is Carnival's.
+- **No loose tracking on the display.** The hero is tight (`-0.04em`); wide caps live only on mono labels (`0.10em`). Spread display caps read as AI-stretched.
+- **No pill / gradient CTA.** One solid orange button, square-ish radius (4px), destination named.
+- **No serif anywhere.** All-sans: Inter Tight / Albert Sans / JetBrains Mono.
+- **No stadium skeuomorphism** - no grass texture, jersey-mesh gradient, medal / trophy emoji.
+
+## Macrostructure affinity / rejection
+
+**Sport loves these.**
+
+- **Stat-Led** - *canonical.* The scoreboard, the standings, the split table, the season figures.
+- **Marquee Hero** - one big uppercase word + the lane stripe.
+- **Bento Grid** - fixtures / results / kit tiles, each rule-framed.
+- **Type Specimen** - the condensed caps as the content.
+- **Feature-stack** - training-plan or spec rows down a hairline column.
+
+**Sport refuses these.**
+
+- **Letter** - too intimate; Sport is a result, not a note.
+- **Conversational FAQ** - too soft.
+- **Long Document** - prose-led; route Newsprint / Editorial.
+- **Quote-Led** - too pensive; Sport is present-tense and timed.
+
+## Voice fixtures
+
+Imperative, kinetic, numbered. Caps on the headline, sentence case in the body.
+
+- *"EVERY SPLIT COUNTS."*
+- *"42.195 KM. ONE MORNING."*
+- *"TRAIN FOR THE DISTANCE, NOT THE DAY."*
+- *"BUILT FOR THE FINAL LAP."*
+- *"FASTER THAN LAST SEASON. PROVE IT."*
+
+Numerals over words (5K, not five-K). Verbs and numbers, not adjectives. **Never any of:** *journey, wellness, holistic, elevate, unleash, game-changer, next-level, curated.*
+
+## How Sport differs from neighbouring themes
+
+| vs | difference |
+|---|---|
+| **Manifesto** | Manifesto is BLACK paper + red Anton, caps as protest. Sport is light cool-grey paper + blaze-orange + Inter Tight, caps as scoreboard. Both uppercase; opposite polarity (dark vs light) and purpose (declaration vs result). |
+| **Carnival** | Carnival is duo-tone poster art (Big Shoulders width axis, ornaments, hard-offset shadows). Sport is single-signal data (Inter Tight, mono tabular numerals, hairlines). Expressive vs measured. |
+| **Brutal** | Brutal is raw heavy-border slab brutalism. Sport is fast and hairline-precise, one heavy rule, the number as hero. Structure from rules and data, not slab weight. |
+
+## Test brief expectations
+
+Sport should be a candidate when the brief mentions:
+
+- *running · marathon · race · training · fitness · gym · team · league · fixtures · standings · scoreboard · athletics · performance · splits · PR / PB · kit · sportswear · club · season · match · tournament · endurance*
+- Product categories: *sportswear · running brand · fitness app · sports team or club · race event · training program · performance gear · league / standings site*
+- Emotional tone: *fast · competitive · measured · kinetic · disciplined · timed · hard*
+
+## Build hint
+
+```css
+html, body { overflow-x: clip; }
+body { background: var(--color-paper); color: var(--color-ink-2);
+ font-family: var(--font-body); font-weight: 400; }
+
+/* Scoreboard heads: uppercase condensed Inter Tight, tight + upright */
+h1, h2 { font-family: var(--font-display); font-weight: var(--display-weight);
+ text-transform: uppercase; letter-spacing: var(--tracking-display);
+ line-height: var(--lh-tight); font-style: normal; }
+
+/* The scoreboard number: mono, tabular, larger than its label */
+.stat-num { font-family: var(--font-mono); font-variant-numeric: tabular-nums;
+ font-size: var(--text-2xl); color: var(--color-ink); }
+.label { font-family: var(--font-label); text-transform: uppercase;
+ letter-spacing: var(--tracking-label); color: var(--color-muted); }
+
+/* Two-weight rule system, never boxed cards */
+.hair { border-top: var(--rule-hair) solid var(--color-rule); }
+.rule { border-top: var(--rule-fine) solid var(--color-rule-2); }
+
+/* One blaze-orange signal: the CTA, the single lane stripe */
+.btn--primary { background: var(--color-accent); color: var(--color-paper);
+ border-radius: 4px; }
+.lane { background: var(--color-accent); }
+
+.reveal { opacity: 0; transform: translateY(10px);
+ transition: opacity .6s cubic-bezier(0.16,1,0.3,1),
+ transform .6s cubic-bezier(0.16,1,0.3,1); }
+.reveal.is-in { opacity: 1; transform: none; }
+
+@media (prefers-reduced-motion: reduce) {
+ .reveal { opacity: 1; transform: none; transition: none; }
+}
+```
+
+Plus the Inter Tight + Albert Sans + JetBrains Mono link and the reveal + count-up script.
diff --git a/skills/hallmark/references/themes/studio.md b/skills/hallmark/references/themes/studio.md
new file mode 100644
index 0000000..094a1ee
--- /dev/null
+++ b/skills/hallmark/references/themes/studio.md
@@ -0,0 +1,145 @@
+# Theme - Studio
+
+Editorial, design-studio register. The page for a **creative studio, a branding practice, an art-direction shop, a design portfolio, a selected-work index** - the considered-agency school, executed in **high-contrast Fraunces on a cool studio-white, with one deep botanical green**. A faintly cool near-white ground (`oklch(96.5% 0.005 200)`), ruler-drawn hairlines, huge thick/thin display serif, and a numbered work-index doing the structural work. It reads like a studio that sets its own type: crafted, confident, curatorial.
+
+Loaded eagerly by SKILL.md Step 3 when the catalog pick is `studio`. Tokens: `site/css/tokens.css` under `[data-theme="studio"]`.
+
+## Axes (diversification)
+
+- **Paper band** - light, cool: `oklch(96.5% 0.005 200)`. An engineered studio-white, hue ~200, almost no chroma. Distinct from warm editorial grounds and from any dark canvas.
+- **Display style** - **high-contrast serif** (Fraunces at optical 144, `SOFT` 30, weight 400, tracking `-0.022em`). The thick/thin contrast is the theme. Not a grotesk, not a slab, not a condensed.
+- **Accent hue** - **chromatic green** `oklch(46% 0.140 145)`. A deep botanical emerald, mid-dark and saturated but never neon. One signal only, ink-on-white everywhere else.
+
+## Reference register
+
+Aesop · Stripe Press · Readymag · Instrument · Locomotive · Area 17 · Cosmos · Semplice · a type foundry's Fraunces specimen.
+
+The aesthetic: the design-studio case-study index - a cool crafted canvas, one green signal, big high-contrast serif, a hairline project ledger, mono meta-lines. **Never name any of these in the output.**
+
+**Patron-saint reference (internal):** a branding studio's selected-work index, set in high-contrast Fraunces and recoloured deep green - the specimen discipline of a type foundry with the warmth of a working studio. When in doubt ask "does this read like a studio that hand-sets its own page, or a template?" Keep the former.
+
+## Required dependencies
+
+1. **Fonts** - **Fraunces** (display, variable opsz/wght/SOFT, roman + italic for body emphasis), **Geist** (body 400/500/600), **Geist Mono** (labels + meta). Google Fonts:
+ ```html
+ <link href="https://fonts.googleapis.com/css2?family=Fraunces:ital,opsz,wght,SOFT@0,9..144,400..700,0..100;1,9..144,400..700,0..100&family=Geist:wght@400;500;600&family=Geist+Mono:wght@400;500&display=swap" rel="stylesheet" />
+ ```
+2. **A small reveal script** - one `IntersectionObserver` adding `.is-in` (fade + ~10px rise, ease-out ~600ms). One orchestrated entrance, then static. Reduced-motion safe.
+
+## Signature moves
+
+1. **Cool studio-white, never `#fff`** - paper `oklch(96.5% 0.005 200)`, second surface `oklch(93.5% 0.007 200)`. Ink is cool near-black `oklch(13% 0.024 205)`; body sits at `--color-neutral` `oklch(34% 0.016 205)`. Everything tints faintly toward hue 200-205.
+
+2. **Fraunces set big and high-contrast** - the display face at optical size 144 (`--display-optical`), weight 400, `SOFT` 30, letter-spacing `-0.022em`. `font-variation-settings: "opsz" 144, "SOFT" 30`. Headlines run 2-3 lines, **edge-aligned left**, up to `6.25rem` (`--text-display`). The dramatic thick/thin stroke is the signature - do not flatten it with a low optical size.
+
+3. **One botanical green signal** (< 5% of any viewport) - `--color-accent-ink` `oklch(46% 0.140 145)` for a green word in a headline, a link underline, a small index tick, the active nav item. The **one filled button** uses `--color-accent` as background with a `--color-paper` label (never green-on-green). Everything else is ink-on-white.
+
+4. **Geist body against a Fraunces display** - the tension of a clean neutral sans body under a high-contrast display serif. Body Geist 400 at a 45-75ch measure. **Never set running body in the serif**; Fraunces is display and pull-quotes only.
+
+5. **Geist Mono spec-sheet labels** - eyebrows, section numbers, project indices, dates, roles, captions in Geist Mono UPPERCASE, tracking `0.08em` (`--tracking-label`). The machine-readout counterpoint to the lush serif - a studio's colophon voice.
+
+6. **A hairline work-index, not cards** - 1px `--color-rule` `oklch(82% 0.008 200)` rules define sections and a numbered project ledger (index no. / title in Fraunces / discipline / year across hairline-separated rows). **No boxed cards, no drop-shadows.** Depth is rules and whitespace.
+
+7. **Whitespace as material** - `--section-gap` 6.5rem between beats, `--section-head-gap` 1.5rem under heads. Asymmetric columns: title left, mono meta/index right. Generous, unhurried, never centre-stacked.
+
+8. **Green emphasis, never italic headers** - a single emphasized headline word takes the green (`--color-accent-ink`) or a green underline; the display face stays roman. Fraunces **italic is body-emphasis and pull-quotes only** (genre rule).
+
+## Motion
+
+Quiet and editorial. One orchestrated entrance per section (fade + ~10px rise, ease-out ~600ms) via a single `IntersectionObserver`. Hover: green underline-grow on links, a 1px rule shift toward green on index rows. **No bounce, no parallax, no autoplay, no marquee.** Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships fully visible and static.
+
+## Anti-patterns
+
+- **No warm paper** - Studio is cool (hue ~200-205); warm cream is Atelier/Garden vocabulary.
+- **No pure `#fff` / `#000`** - cool studio-white and cool near-black only.
+- **Never flatten Fraunces** - a low optical size kills the thick/thin contrast that defines the theme. Keep opsz high on the display.
+- **No italic display headers** - roman only; italic is body emphasis (genre rule).
+- **No green flood / neon green** - one deep botanical signal, < 5%. Green backgrounds or bright green break it.
+- **No boxed cards, shadows, or glassmorphism** - hairlines and whitespace carry the page.
+- **No centred-everything hero** - left-biased, title-left / meta-right.
+- **No pill / gradient CTA** - one filled green button + typographic links.
+
+## Macrostructure affinity / rejection
+
+**Studio loves.**
+
+- **Portfolio-grid / split-studio** - the selected-work case-study index (its native shape)
+- **Index-first** - a numbered hairline project ledger
+- **Type-specimen / Specimen** - Fraunces set big; the theme is specimen-capable
+- **Photographic** - a studio shows its work; cool paper frames imagery cleanly
+- **Manifesto** - a studio statement of approach in big composed serif (quiet register)
+
+**Studio refuses.**
+
+- **Workbench** - instrument-panel / dev-tool shape belongs to the cool-modern lane, not a studio
+- **Bento Grid** - tiled product boxes fight the hairline editorial structure
+- **Stat-Led** - a studio does not open with a dashboard of numbers
+- **Conversational FAQ** - too chatty/support; Studio is curatorial
+
+## Voice fixtures
+
+Confident, spare, a little literary. Verbs over adjectives. Name the work.
+
+- *"We design the things a brand is remembered by."*
+- *"A small studio. Considered work."*
+- *"Identity, editorial, and the space between."*
+- *"Selected work - 2016 to present."*
+- *"Set with care. Shipped with nerve."*
+
+Never any of: *seamless, cutting-edge, disrupt, synergy, elevate, next-level, world-class, digital solutions*. Never "click here." Name the project, the discipline, the year.
+
+## How Studio differs from neighbouring themes
+
+| vs | what settles it instantly |
+|---|---|
+| **Garden** (green sibling) | Garden is a warm, botanical, organic nature register where green floods a soft world. Studio is a cool engineered studio-white where the same green is one restrained signal - agency, not garden. Temperature + role of the green settle it. |
+| **Atelier** (quiet-serif sibling) | Atelier is the hushed, letter-shaped, small-serif personal practice. Studio is bigger and more confident - Fraunces at opsz 144, a work-index ledger, a green signal. Scale and structure settle it. |
+| **Specimen** (Fraunces/high-contrast sibling) | Specimen exists to display a typeface (type is the subject). Studio uses Fraunces as its voice to present a studio's work (the studio is the subject). Same face possible, different subject. |
+
+## Test brief expectations
+
+Studio should be a candidate when the brief mentions:
+
+- *design studio · creative studio · branding · brand identity · art direction · agency · portfolio · case study · selected work · editorial design · typography · creative direction · graphic design · design practice*
+- Product categories: *design studio · creative/branding agency · art-direction shop · portfolio site · editorial/publishing practice*
+- Emotional tone: *considered · crafted · confident · curatorial · high-contrast · editorial · tasteful · warm-precise*
+
+Briefs that are dev-tool / enterprise / warm-consumer / loud-maximalist route elsewhere (the cool-modern lane for developer products, Carnival for loud editorial, Garden for organic/nature).
+
+## Build hint
+
+```css
+html, body { overflow-x: clip; }
+body { background: var(--color-paper); color: var(--color-neutral);
+ font-family: var(--font-body); font-weight: 400; }
+
+/* Fraunces display - big, high-contrast, roman, tight */
+.display { font-family: var(--font-display); font-weight: var(--display-weight);
+ font-variation-settings: "opsz" 144, "SOFT" 30;
+ font-size: var(--text-display); line-height: 0.98;
+ letter-spacing: var(--tracking-display); color: var(--color-ink); }
+.display .mark { color: var(--color-accent-ink); } /* the one green signal */
+
+/* Mono spec-sheet label */
+.label { font: 500 0.75rem/1 var(--font-mono); text-transform: uppercase;
+ letter-spacing: var(--tracking-label); color: var(--color-muted); }
+
+/* Hairline index row - no cards, no shadow */
+.row { border-top: 1px solid var(--color-rule); padding: 1.25rem 0; }
+
+/* The one filled button - paper label, never green-on-green */
+.btn--primary { background: var(--color-accent); color: var(--color-paper);
+ border-radius: 4px; }
+
+/* Reveal - the whole motion engine */
+.reveal { opacity: 0; transform: translateY(10px);
+ transition: opacity .6s cubic-bezier(0.16,1,0.3,1),
+ transform .6s cubic-bezier(0.16,1,0.3,1); }
+.reveal.is-in { opacity: 1; transform: none; }
+
+@media (prefers-reduced-motion: reduce) {
+ .reveal { opacity: 1; transform: none; transition: none; }
+}
+```
+
+Plus the Fraunces + Geist + Geist Mono link and the small reveal script.
diff --git a/skills/hallmark/references/themes/terminal.md b/skills/hallmark/references/themes/terminal.md
new file mode 100644
index 0000000..397800f
--- /dev/null
+++ b/skills/hallmark/references/themes/terminal.md
@@ -0,0 +1,142 @@
+# Theme - Terminal
+
+Green-phosphor CRT, rendered as a landing page. The page for a **CLI, a shell tool, a self-hosted binary, an open-source dev utility, a homelab/DevOps product** - the page that *is* a terminal session, not one that shows a screenshot of one. Dark green-black ground (`oklch(11% 0.018 145)`), phosphor-green ink (hue 138, up to `chroma 0.19`), one hue top to bottom, every glyph monospace, a blinking block cursor. It reads like a live shell: fast, raw, competent, no ornament.
+
+Loaded eagerly by SKILL.md Step 3 when the catalog pick is `terminal`. Tokens: [`site/css/tokens.css`](../../../../site/css/tokens.css) under `[data-theme="terminal"]`. Canonical build: none yet - mirror the signature moves below.
+
+## Axes (diversification)
+
+- **Paper band** - dark, green (`oklch(11% 0.018 145)`, a near-black with a green cast). The darkest ground in the catalog, and the only one tinted green rather than neutral or indigo.
+- **Display style** - **mono** (JetBrains Mono 500, `--tracking-display 0.01em`). No proportional face exists on the page; display just sizes the mono up (`--text-display` clamps to 4rem).
+- **Accent hue** - **chromatic phosphor** (`oklch(78% 0.190 138)`). A lit P1-green, not neon `#00ff00`. It is the *same* hue as the ink and the paper - the whole page is one hue.
+
+## Reference register
+
+Warp - Charm / charm.sh - Ghostty - Fig - Vercel's monospace - old DEC/VT220 green screens - man pages - `htop`/`btop` TUIs.
+
+The aesthetic: a shell session as a homepage - monochrome phosphor, box-drawn chrome, prompt prefixes, a cursor that blinks. Hand-built, precise, never a costume. **Patron-saint reference (internal):** *a green VT220 phosphor screen, recoloured for the web* + *a README you can run*. When in doubt ask "does this read like a live terminal, or like a hacker-themed skin?" Keep the former. **Never name any of these in the output.**
+
+## Required dependencies
+
+1. **Font** - **JetBrains Mono** only (display 500, body 400, bold 700). No sans, no serif anywhere. Google Fonts:
+ ```html
+ <link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;700&display=swap" rel="stylesheet" />
+ ```
+2. **A reveal script** - one `IntersectionObserver` adding `.is-in` (fade only, ~500ms; no rise - the screen does not slide).
+3. **A one-shot type-in** - the hero command line types itself once, then a block cursor (`▋`) blinks steadily. Both gate behind `prefers-reduced-motion`.
+
+## Signature moves
+
+1. **One hue, top to bottom.** Paper (`oklch(11% 0.018 145)`), rules, muted meta (`oklch(58% 0.090 140)`), body (`oklch(78% 0.140 138)`), bright ink (`oklch(86% 0.160 138)`), accent (`oklch(78% 0.190 138)`) all sit on hue 138-145. There is no second hue on the page. The monochrome *is* the design. Hierarchy comes from the L/chroma ramp, since hue cannot carry it.
+
+2. **Every glyph is JetBrains Mono.** Display, headings, body, labels, meta, buttons - all `--font-mono`. No proportional type exists anywhere, not even a "friendlier" body. A sans or serif on the page means the theme is broken.
+
+3. **Zero radius, sharp rectangles.** `--radius-card / --radius-pill / --radius-input` all resolve to `0`. Windows, buttons, inputs, chips have square corners. No pill CTA, no soft card - the hard edge is the CRT bezel.
+
+4. **The shell prompt is the grammar.** Eyebrows, section labels, and nav items are prefixed `$`, `>`, or `~/`. A blinking block cursor (`▋`) trails the hero headline or the active input. The page behaves as one continuous session, not a marketing page describing one.
+
+5. **Phosphor glow, not drop-shadow.** Bright text (ink, accent) carries a soft `text-shadow` bloom in the accent hue - the phosphor bleeding past its pixel. Depth otherwise steps through `--color-paper-2` (`15%`) / `--color-paper-3` (`19%`) elevation. Never a grey box-shadow, never blur.
+
+6. **Scanline atmosphere.** A fixed, low-opacity horizontal scanline overlay (`repeating-linear-gradient`, ~3px pitch, under ~6% alpha), optionally a faint vignette. This is Terminal's answer to the genre's warm blooms - the atmosphere is CRT, not dusk. It must never fight legibility.
+
+7. **Rules are TUI chrome.** 1px `--color-rule` (`oklch(28% 0.030 140)`) borders framed like a terminal: a window title bar carrying `● ● ●` or `[ session ]`, box-drawn (`+--+`, `│`) dividers, a `~/project $` breadcrumb. Structure reads as terminal furniture, not as web cards.
+
+8. **Bright green is the signal.** `--color-ink` (86% L) and `--color-accent` (`chroma 0.19`) are the brightest greens - reserve them for the one headline verb, the active prompt, the cursor, focus rings, and a `OK` / `200` / `PASS` chip. Body holds at `--color-ink-2` (78% / 0.14), meta drops to `--color-muted` (58% / 0.09).
+
+## Motion
+
+The hero command types in once, then the block cursor blinks on a steady 1s `step-end` loop. Section reveals fade only (no rise, the screen does not scroll its content in). An optional one-time boot flicker on load is allowed. No parallax, no bounce, no autoplay. Everything gates behind `prefers-reduced-motion: no-preference`; reduced-motion ships static, cursor solid, scanlines still (or absent).
+
+## Anti-patterns
+
+- **No second hue.** No warm bloom, no cyan, no amber, no indigo. If it is not green (hue 138-145), it does not belong. This is what separates Terminal from Midnight / Aurora / Lumen.
+- **No proportional type.** No sans, no serif, ever - JetBrains Mono carries the whole page.
+- **No rounded corners.** No pill CTA, no soft card, no rounded input. Radius stays `0`.
+- **No pure `#000` or neon `#00ff00`.** Paper is a green-black (`oklch(11% 0.018 145)`); accent is a lit phosphor (`oklch(78% 0.190 138)`), not a `#0f0` highlighter.
+- **No light sections.** Unlike Cobalt (a light page with one dark band), Terminal is dark end to end. Never sneak a white section in.
+- **No skeuomorphic terminal screenshot as hero.** The *page* is the terminal; do not paste a picture of one.
+- **No heavy CRT costume.** Overdense scanlines or a fat glow read as a theme skin, not an instrument. Keep the effects subtle.
+- **No emoji or colour icons.** Monochrome glyphs, box-drawing, and ASCII only.
+
+## Macrostructure affinity / rejection
+
+**Loves.**
+- **Workbench** - the tool-first, panelled shape; Terminal's native register
+- **Dev-tool / CLI** - install line + a clean run + `PASS` / `exit 0`
+- **Marquee Hero** - one confident shell demo carrying the fold
+- **Stat-Led** - benchmark numbers in a mono table (throughput, latency, exit codes)
+- **Long Document** - a README or man-page rendered as the page
+
+**Refuses.**
+- **Photographic / image-led** - Terminal is text; no photography survives the phosphor screen
+- **Letter** - too intimate and warm; Terminal speaks in a machine voice
+- **Quote-Led** - testimonial pull-quotes want a serif Terminal does not have
+- **Catalogue / portfolio-grid** - image-thumbnail grids fight the text-only surface
+
+## Voice fixtures
+
+Speak in commands, flags, and exit codes. Declarative, terse, specific.
+
+- `$ curl -sSL install.sh | sh`
+- *"Runs where you run. Nothing to configure."*
+- *"One binary. No daemon. Exit 0."*
+- *"Pipe it, grep it, ship it."*
+- `> ready.` (block cursor blinking after)
+
+Never any of: *seamless, robust, magical, revolutionary, next-gen, effortless, delightful, supercharge*. Never "click here." Name the command, the flag, the exit code.
+
+## How Terminal differs from neighbouring themes
+
+| vs | difference |
+|---|---|
+| **Midnight** (atmospheric) | Midnight is dark **blue** (hue ~250) with a real proportional display face (thin Geist) and a diffuse azure glow. Terminal is monochrome **green** (138-145), all-mono, with a shell prompt and scanlines. Hue + all-mono settle it instantly. |
+| **Cobalt** (modern-minimal) | Cobalt is a **light** engineered page with one dark graphite code band. Terminal is dark end to end and green - it *is* the code surface, not a light page containing one. Light-vs-dark + hue settle it. |
+| **Aurora** (atmospheric) | Aurora blooms **cyan** and sets body in a serif. Terminal has no bloom (scanlines instead), no serif (all-mono), and one green hue. |
+| **Lumen** (atmospheric) | Lumen carries Instrument Serif, a built light artefact, and two palette drops. Terminal is single-drop, all-mono, no serif, phosphor-glow rather than emitted-light. |
+
+## Test brief expectations
+
+Terminal should be a candidate when the brief mentions:
+
+- *CLI - terminal - shell - command-line - TUI - self-hosted - open-source - binary - hacker - ssh - sysadmin - DevOps - homelab - install script - package manager - REPL - retro - CRT - phosphor - green screen*
+- Product categories: *CLI tool - terminal/shell product - self-hosted infra - dev CLI - open-source binary - sysadmin/DevOps tool - retro-computing product*
+- Emotional tone: *hacker - raw - fast - no-nonsense - retro-technical - machine - underground - competent*
+
+When the brief wants a page that *is* a shell (not one that shows a code card), with green-CRT energy, it is Terminal. Warm / consumer / editorial / image-led briefs route elsewhere.
+
+## Build hint
+
+```css
+html, body { overflow-x: clip; }
+body { background: var(--color-paper); color: var(--color-ink-2);
+ font-family: var(--font-mono); font-weight: 400; letter-spacing: 0; }
+
+/* Display just sizes the mono up - no other face exists */
+.display { font: 500 var(--text-display)/var(--lh-tight) var(--font-mono); }
+
+/* Phosphor glow on bright text - the CRT bleed */
+.ink, .accent { color: var(--color-ink);
+ text-shadow: 0 0 8px oklch(78% 0.19 138 / 0.35); }
+
+/* Scanline atmosphere - fixed, faint, above paper, below content */
+body::after { content: ""; position: fixed; inset: 0; pointer-events: none; z-index: 9;
+ background: repeating-linear-gradient(oklch(86% 0.16 138 / 0.04) 0 1px, transparent 1px 3px); }
+
+/* Blinking block cursor - the live prompt */
+.cursor::after { content: "\25AE"; color: var(--color-accent);
+ animation: blink 1s step-end infinite; }
+@keyframes blink { 50% { opacity: 0; } }
+
+/* Zero radius everywhere - sharp CRT edges */
+.card, .btn, .input { border-radius: 0; border: 1px solid var(--color-rule); }
+
+.reveal { opacity: 0; transition: opacity .5s ease; }
+.reveal.is-in { opacity: 1; }
+
+@media (prefers-reduced-motion: reduce) {
+ .cursor::after { animation: none; }
+ .reveal { opacity: 1; transition: none; }
+}
+```
+
+Plus the JetBrains Mono link and the reveal + one-shot type-in script.