Skip to content

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

CSS

Copy refresh — README + landing page stats reflect new nav/footer/hero archetypes

Youssef2f2c59e14239
diff --git a/README.md b/README.md
index a8d1e77..6dab947 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,7 @@
→ Live demo: **[hallmark-murex.vercel.app](https://hallmark-murex.vercel.app)** · twenty-two themes, eight worked tests, press `T` to cycle.
→ Current version: **v0.8.0** — adds genres (editorial · modern-minimal · atmospheric · playful), `design.md` for whole-project redesigns, lazy reference loading, the 2+1 font rule with 55-gate slop test, component-library exports (tokens.css always emitted; Tailwind / DTCG / shadcn formats inline in design.md), a Study gallery on the marketing site, and seven new themes (Quiet refreshed, plus Bloom, Coral, Violet, Aurora, Halo, Plume).
+→ **Latest:** **9 nav archetypes** (Floating pill · Newspaper masthead · Brutal slab · Terminal command · Edge-aligned minimal — plus the original 4) and **8 footer archetypes** (Statement · Letter close · Newsletter-first · Marquee scroll — plus the original 4), with per-genre routing. **4 hero polish patterns** (Vertical-rail · Marquee-overflow · Cursor-spotlight · Decorative-numeral). Five new slop-test gates (51–55) catch the AI nav fingerprint, the AI footer fingerprint, centred-everything heroes, hero padding asymmetry, and decorative-without-purpose. Terminal cursor constraint codified — no standalone blinks, only inside typed commands.
<table>
<tr>
@@ -98,9 +99,9 @@ Each page is its own self-contained HTML + CSS — no shared theme, no shared la
## What's inside
- **[`SKILL.md`](skill/SKILL.md)** — the routing file. Six-step design flow (including `Step 2.5 · Check project memory` reading `.hallmark/log.json`), 55-gate slop test, output contract, always-on `tokens.css` export.
-- **[`references/`](skill/references/)** — short, opinionated rule files: typography, colour, layout, motion, microinteractions, interaction-and-states (with the input-state checklist), responsive, copy, anti-patterns, the 21 named macrostructures, the 36 component archetypes with variation knobs, the 6 primitive structure axes, the vision-extraction protocol for `study`, hero enrichment, custom-craft (CSS art over Lottie), assets, the slop-test gates, four genre rule-overlays, per-verb dispatchers, and the export-formats reference (Tailwind / DTCG / shadcn / tokens.css).
+- **[`references/`](skill/references/)** — short, opinionated rule files: typography, colour, layout, motion, microinteractions, interaction-and-states (with the input-state checklist), responsive, copy, anti-patterns, the 21 named macrostructures, the **40 component archetypes** with variation knobs (9 hero · 6 feature · 4 CTA · 4 testimonial · **8 footer · 9 nav**), the **4 hero polish patterns** (in `hero-enrichment.md`), the 6 primitive structure axes, the vision-extraction protocol for `study`, hero enrichment, custom-craft (CSS art over Lottie), assets, the slop-test gates, four genre rule-overlays (each with nav + footer voice routing), per-verb dispatchers, and the export-formats reference (Tailwind / DTCG / shadcn / tokens.css).
- **[`docs/`](docs/)** — human-reading content: **[`recipes.md`](docs/recipes.md)** (8 worked briefs + a canonical try-it prompt) and **[`study-examples.md`](docs/study-examples.md)** (3 worked DNA-extractions). Not auto-loaded by the skill.
-- **[`site/`](site/)** — a self-demonstrating landing page. Hand-written HTML + CSS + ES module, no framework, no build step. **Twenty-two themes** clustered into four genres: **editorial** (Specimen, Atelier, Newsprint, Salon, Linen, Almanac, Garden, Studio, Sport, Riso, Brutal, Manifesto), **modern-minimal** (Quiet, Coral, Violet), **atmospheric** (Midnight, Terminal, Bloom, Aurora, Halo), **playful** (Pastel, Plume). Switching themes literally rebuilds the page — different hero archetype, different footer archetype.
+- **[`site/`](site/)** — a self-demonstrating landing page. Hand-written HTML + CSS + ES module, no framework, no build step. **Twenty-two themes** clustered into four genres: **editorial** (Specimen, Atelier, Newsprint, Salon, Linen, Almanac, Garden, Studio, Sport, Riso, Brutal, Manifesto), **modern-minimal** (Quiet, Coral, Violet), **atmospheric** (Midnight, Terminal, Bloom, Aurora, Halo), **playful** (Pastel, Plume). Switching themes literally rebuilds the page — different hero archetype, different footer archetype, different nav archetype.
---
diff --git a/site/index.html b/site/index.html
index c63c51f..d17125c 100644
--- a/site/index.html
+++ b/site/index.html
@@ -970,8 +970,10 @@
<ul>
<li>22 themes</li>
<li>21 macrostructures</li>
- <li>32 archetypes</li>
- <li>50 slop-test gates</li>
+ <li>40 archetypes</li>
+ <li>9 navs · 8 footers</li>
+ <li>4 hero polish patterns</li>
+ <li>55 slop-test gates</li>
</ul>
</div>
<div class="foot__col">
diff --git a/site/js/main.js b/site/js/main.js
index 001c626..db44ed7 100644
--- a/site/js/main.js
+++ b/site/js/main.js
@@ -129,9 +129,9 @@ const COPY = {
lede: "Hallmark is a skill for Claude Code, Cursor, and Codex. It encodes the anti-slop consensus — typography, colour, layout, motion, interaction — into one holistic ruleset your AI assistant will actually follow.",
ctaLabel: "01 ⁄ Install",
proofLabel: "Proof",
- proofA: "21 macrostructures",
- proofB: "32 component archetypes",
- proofC: "50-gate slop test",
+ proofA: "21 macrostructures · 40 archetypes",
+ proofB: "9 navs · 8 footers · 4 hero polish",
+ proofC: "55-gate slop test",
cta: "Read the rules",
stat: "21",
qualifier: "macrostructures",
@@ -146,7 +146,7 @@ const COPY = {
newsprint: {
eyebrow: "Volume I · Issue 02 · 28 April 2026",
title: HERO_TITLE,
- lede: "Twelve themes. Twenty-one named page shapes. Thirty-two component archetypes. A 50-gate slop test that gates every output before it ships. Hallmark is the rulebook the LLM never read.",
+ lede: "Twenty-two themes. Twenty-one named page shapes. Forty component archetypes — nine navs, eight footers, four hero polish patterns. A 55-gate slop test that gates every output before it ships. Hallmark is the rulebook the LLM never read.",
ctaLabel: "Distribution",
proofLabel: "From the rule sheet",
proofA: "Multi-column body, justified",
@@ -249,16 +249,16 @@ const COPY = {
lede: "A reference book of structural choices, indexed and cross-referenced. Hallmark looks up the right page-shape for the brief and refuses to use the same one twice.",
ctaLabel: "Open the index",
proofLabel: "Catalogued",
- proofA: "21 macrostructures",
- proofB: "32 component archetypes",
- proofC: "29 slop-test gates",
+ proofA: "21 macrostructures · 40 archetypes",
+ proofB: "9 navs · 8 footers · 4 polish patterns",
+ proofC: "55 slop-test gates",
cta: "Open the index",
- stat: "252",
+ stat: "462",
qualifier: "theme × shape combinations",
quote: "An almanac is a book that knows where to look.",
attrib: "Almanac, frontispiece",
salutation: "Reference note,",
- letterBody: "This page is a reference, not an argument. The numbers are the point: 21 macrostructures, 32 archetypes, 12 themes, 29 slop-test gates. Cross-referenced so the next page Hallmark builds is genuinely different from the last.",
+ letterBody: "This page is a reference, not an argument. The numbers are the point: 21 macrostructures, 40 archetypes, 22 themes, 55 slop-test gates. Cross-referenced so the next page Hallmark builds is genuinely different from the last.",
signoff: "— editor",
captionA: "Vol. III",
captionB: "Plate 12",
@@ -612,8 +612,8 @@ function buildDenseColophon(themeName) {
`# hallmark · v0.8.0 · ${themeName.toLowerCase()}`,
`# build: ${today} · MIT · powered by together ai`,
`#`,
- `# stats: 21 macrostructures · 32 archetypes · 22 themes · 50 gates`,
- `# catalog (16 named) + custom (per-brand, opt-in)`,
+ `# stats: 21 macros · 40 archetypes · 9 navs · 8 footers · 22 themes · 55 gates`,
+ `# catalog (22 named) + custom (per-brand, opt-in)`,
`#`,
`# repo: github.com/Luffixos/hallmark`,
].join("\n");
diff --git a/skill/SKILL.md b/skill/SKILL.md
index 041c6da..22d2d75 100644
--- a/skill/SKILL.md
+++ b/skill/SKILL.md
@@ -196,7 +196,7 @@ If two non-default signals fire (rare), ask one short follow-up: *"This brief fi
State the genre out loud at Step 2.5 alongside the macrostructure and theme picks: *"Genre: atmospheric. Macrostructure: Marquee Hero. Theme: Bloom (atmospheric cluster)."*
-**Theme route — only surface when the brief signals it.** Hallmark has two theme routes: **catalog** (the 22 named themes — Specimen, Atelier, Pastel, Brutal, Salon, Newsprint, Linen, Studio, Manifesto, Terminal, Midnight, Almanac, Garden, Quiet, Riso, Sport, Bloom) and **custom** (an OKLCH palette + free-font pairing tuned to this one brief). **Catalog is the default.** The catalog rotation is *scoped to the genre's theme cluster* — atmospheric rotates Bloom/Midnight/Terminal, modern-minimal stays on Quiet, playful stays on Pastel, editorial walks the remaining twelve. Do **not** offer the user a choice on every prompt — that's friction, not discipline. Surface the catalog/custom fork only when the brief carries one of these signals:
+**Theme route — only surface when the brief signals it.** Hallmark has two theme routes: **catalog** (the 22 named themes — Specimen, Atelier, Pastel, Brutal, Salon, Newsprint, Linen, Studio, Manifesto, Terminal, Midnight, Almanac, Garden, Quiet, Riso, Sport, Bloom, Coral, Violet, Aurora, Halo, Plume) and **custom** (an OKLCH palette + free-font pairing tuned to this one brief). **Catalog is the default.** The catalog rotation is *scoped to the genre's theme cluster* — atmospheric rotates Bloom/Midnight/Terminal, modern-minimal stays on Quiet, playful stays on Pastel, editorial walks the remaining twelve. Do **not** offer the user a choice on every prompt — that's friction, not discipline. Surface the catalog/custom fork only when the brief carries one of these signals:
- The user explicitly says **custom theme** / **tailored to our brand** / **make it ours** / **something unique** / **play with the colors and fonts**.
- The user names a **specific brand colour** as the anchor (e.g., "use our terracotta", "the brand red is hex #c0392b", "anchor on sea-blue").
@@ -308,7 +308,7 @@ The non-negotiables live in [`references/`](references/). **Be precise about wha
**Always-load (the eager bundle, ~3 files):**
- The genre file picked in Step 1 — [`genres/editorial.md`](references/genres/editorial.md), [`genres/modern-minimal.md`](references/genres/modern-minimal.md), [`genres/atmospheric.md`](references/genres/atmospheric.md), or [`genres/playful.md`](references/genres/playful.md). Scopes everything downstream.
- [`macrostructures.md`](references/macrostructures.md) — 21 named whole-page shapes; you must pick one before writing code (Step 2 already required this).
-- [`component-cookbook.md`](references/component-cookbook.md) — 32 component archetypes (hero shapes, section heads, feature blocks, CTA shapes, testimonials, footers, navigations) composable into any macrostructure.
+- [`component-cookbook.md`](references/component-cookbook.md) — 40 component archetypes (9 hero shapes, 6 feature blocks, 4 CTA shapes, 4 testimonials, **8 footer archetypes**, **9 nav archetypes**) composable into any macrostructure. Per-genre routing tables for nav and footer live at the bottom of the file.
**Load-per-build (universal rules — load every build):**
- [`typography.md`](references/typography.md) — fonts, scale, pairing, weights, measure
diff --git a/skill/references/custom-theme.md b/skill/references/custom-theme.md
index 30c8e66..a0a76ca 100644
--- a/skill/references/custom-theme.md
+++ b/skill/references/custom-theme.md
@@ -6,8 +6,8 @@ Loaded only when the user has opted into the **custom** theme route in Step 1 of
## Two words, plain English
-- **catalog** — the named-theme catalogue. Hallmark's 16 themes (Specimen, Atelier, Pastel, Brutal, Salon, Newsprint, Linen, Studio, Manifesto, Plain, Terminal, Midnight, Almanac, Garden, Quiet, Riso). Each one is a fixed combination of paper-band, display-style, and accent-hue. The rotation rule cycles through them so two consecutive runs don't read alike. **This is the default.** Most briefs use it.
-- **custom** — made-to-measure. A one-off palette + font pairing constructed specifically for one brief. The skill builds the OKLCH values, picks fonts, and stamps the page — but does **not** add a 17th theme to the catalog. The rules behind the catalog (paper L bands, accent chroma caps, font ban list, slop-test gates) all still apply; only the *combination* is per-brief.
+- **catalog** — the named-theme catalogue. Hallmark's 22 themes (Specimen, Atelier, Pastel, Brutal, Salon, Newsprint, Linen, Studio, Manifesto, Terminal, Midnight, Almanac, Garden, Quiet, Riso, Sport, Bloom, Coral, Violet, Aurora, Halo, Plume). Each one is a fixed combination of paper-band, display-style, and accent-hue. The rotation rule cycles through them so two consecutive runs don't read alike. **This is the default.** Most briefs use it.
+- **custom** — made-to-measure. A one-off palette + font pairing constructed specifically for one brief. The skill builds the OKLCH values, picks fonts, and stamps the page — but does **not** add a 23rd theme to the catalog. The rules behind the catalog (paper L bands, accent chroma caps, font ban list, slop-test gates) all still apply; only the *combination* is per-brief.
## When to surface this fork — Step 1 trigger signals
@@ -15,12 +15,12 @@ Hallmark must **not** offer catalog-vs-custom on every prompt. That's friction,
1. **Explicit ask** — the user types `custom`, "custom theme", "tailored to our brand", "make it ours", "something unique", "play around with the colors and fonts", "I want my own palette".
2. **Named brand colour** — the user gives a specific anchor colour as a hex / OKLCH / brand name. Example: "use our terracotta", "the brand red is hex #c0392b", "anchor on sea-blue".
-3. **Multi-attribute aesthetic the catalog can't carry** — three or more vibe words pointing at a specific, off-catalog feel. Examples: "moss, lichen, soft pink, herbal" / "sun-drenched, market-day, carbon-black" / "late-night, neon, brutalist deli". Compare against the 16 catalog themes; if no single catalog theme is within one axis-step of the vibe, fire the fork. **One adjective ("warm", "technical", "playful") is not a signal — that's a tone, the catalog already carries it.**
+3. **Multi-attribute aesthetic the catalog can't carry** — three or more vibe words pointing at a specific, off-catalog feel. Examples: "moss, lichen, soft pink, herbal" / "sun-drenched, market-day, carbon-black" / "late-night, neon, brutalist deli". Compare against the 22 catalog themes; if no single catalog theme is within one axis-step of the vibe, fire the fork. **One adjective ("warm", "technical", "playful") is not a signal — that's a tone, the catalog already carries it.**
4. **Brand-mood reference attached** — the user attaches a colour swatch, a moodboard, a Pantone chip. (If they attach a *page* screenshot, route to `study` instead; custom is for brand colour / mood, study is for design DNA.)
If any signal fires, ask one short follow-up before picking a theme:
-> *"This brief reads like a custom palette would fit better than the 16 named themes. Want me to construct a custom OKLCH palette + free-font pairing tuned to <one-line summary of the vibe>, or stay on the catalog for variety + speed?"*
+> *"This brief reads like a custom palette would fit better than the 22 named themes. Want me to construct a custom OKLCH palette + free-font pairing tuned to <one-line summary of the vibe>, or stay on the catalog for variety + speed?"*
Wait for the user to answer. If they say custom (or yes / go) → continue this protocol from § A. If they say catalog (or no / stay catalog) → drop the fork and proceed with the catalog route. **Default to catalog** — silence routes to catalog, not custom.