Skip to content

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

CSS

Swap Instrument Serif → Fraunces; tighten README

Youssef958dacdcb8ce
diff --git a/README.md b/README.md
index bab87f9..ace7ae9 100644
--- a/README.md
+++ b/README.md
@@ -8,9 +8,9 @@ A design skill for AI coding assistants. Makes the UIs they generate look made,
## What it is
-A single, opinionated skill — short on purpose — that teaches Claude Code, Cursor, or Codex a firm, consensus-backed set of rules for typography, colour, layout, motion, interaction, microinteractions, copy, responsive behaviour, and structural variety. It refuses to design without a confirmed audience, use case, and tone, and refuses to emit the on-distribution defaults every LLM was trained into.
+A single, opinionated skill that gives Claude Code, Cursor, and Codex a firm rule-set for typography, colour, layout, motion, microinteractions, copy, responsive behaviour, and structural variety. It refuses to emit the on-distribution defaults every LLM was trained into.
-The differentiator: Hallmark insists on **structural variety**, not just visual variety. Two pages by Hallmark for two different briefs should not share the same hero → 3-feature → CTA → footer rhythm.
+The differentiator: Hallmark insists on **structural variety**, not just visual variety. Two pages from two briefs should not share the same hero → 3-feature → CTA → footer rhythm. They should feel like different sites.
---
@@ -18,94 +18,68 @@ The differentiator: Hallmark insists on **structural variety**, not just visual
| Verb | What it does |
| --- | --- |
-| *(default)* | Build new UI — runs the design-context gate (askable, skippable; the skill states what it inferred either way), picks a structural fingerprint, applies the ruleset, runs the slop test before handing back. |
-| `hallmark audit <target>` | Score existing code against the named anti-patterns + structural sameness. Returns a punch list. No edits. |
+| *(default)* | Build new UI. Asks for audience + use case + tone (skippable — the skill states what it inferred either way), picks a macrostructure, applies the rule-set, runs the slop test before handing back. |
+| `hallmark audit <target>` | Score existing code against the named anti-patterns + structural sameness. Punch list, no edits. |
| `hallmark refine <target>` | Polish in place. Smallest possible diff. Preserves structure. |
-| `hallmark redesign <target> [--mood <name>]` | Throw out the structure, keep copy + IA + brand, rebuild with a deliberately different structural fingerprint. |
-| `hallmark study <screenshot>` | The user attached a design they admire. Extract the **DNA** — macrostructure, archetypes, type-pairing role, colour anchor — and produce a diagnosis report. Then optionally rebuild *the user's* content using the extracted DNA. **Refuses paid templates and competitor pages. Names font roles, never font IDs. Never copies pixels.** |
+| `hallmark redesign <target> [--mood <name>]` | Throw out the structure, keep copy + IA + brand, rebuild with a deliberately different fingerprint. |
+| `hallmark study <screenshot>` | Extract the **DNA** from a design the user admires — macrostructure, archetypes, type-pairing role, colour anchor — and produce a diagnosis report. Optionally rebuild *the user's* content using the extracted DNA. Refuses paid templates and competitor pages. Names font roles, never font IDs. Never copies pixels. |
---
## What's inside
-**Skill** — [`skill/SKILL.md`](skill/SKILL.md) plus ten reference files:
-
-- [`typography.md`](skill/references/typography.md) — banned defaults, pairing rules, weight extremes, scale ratios
-- [`color.md`](skill/references/color.md) — OKLCH palette construction, accent discipline (≤3% area), dark-mode recipe
-- [`layout-and-space.md`](skill/references/layout-and-space.md) — 4pt scale, asymmetry, grid-breaks, depth via weight not shadow
-- [`structure.md`](skill/references/structure.md) — six axes of structural variety (heading placement, body composition, divider, button voice, image, reveal); the per-theme structural fingerprint table
-- [`motion.md`](skill/references/motion.md) — duration buckets, three named easings, no bounce on UI, reduced-motion default
-- [`microinteractions.md`](skill/references/microinteractions.md) — 14 interaction recipes (button press, focus, modal, toast, optimistic update, command palette, drag, copy-to-clipboard, search-as-you-type) and the 20 named microinteraction tells
-- [`interaction-and-states.md`](skill/references/interaction-and-states.md) — eight states per element, focus-visible spec, 44px hit targets, undo over confirm
-- [`responsive.md`](skill/references/responsive.md) — mobile-first, content-driven breakpoints, `dvh` not `vh`, safe-area-insets
-- [`copy.md`](skill/references/copy.md) — specific verbs, three-part errors, standalone link text, proper typographic punctuation
-- [`anti-patterns.md`](skill/references/anti-patterns.md) — 30+ named tells with severity, why they fail, and the fix
-- [`macrostructures.md`](skill/references/macrostructures.md) — the 21 named whole-page shapes; pick one before writing code, stamp it in the CSS comment
-- [`component-cookbook.md`](skill/references/component-cookbook.md) — 33 component archetypes across 7 categories, each with 2–3 within-archetype variation knobs
-- [`study.md`](skill/references/study.md) — vision-extraction protocol for the `hallmark study` verb: refusal heuristics, the structured-fields schema, type-role vocabulary, theme mapping table, worked example, limits
-
-**Slop test (29 questions)** — every output must answer *no* to all twenty-nine before shipping. Visual (8), structural (2), microinteraction (10), variety (3), implementation gates (6).
-
-**Site** — [`site/`](site/) is a self-demonstrating landing page. Hand-written HTML + CSS + ES module, no framework, no build step. Uses Together AI's "The Future" typeface plus Google Fonts.
-
-**Twelve themes**, four categories, each with its own structural fingerprint:
-
-- **Editorial** — Specimen, Newsprint, Atelier
-- **Soft** — Garden, Salon, Linen
-- **Technical** — Midnight, Terminal, Almanac
-- **Bold** — Brutal, Manifesto, Sport
-
-Each theme overrides not only colour and typography but section-heading placement, column counts, divider style, button voice, and reveal pattern. The same landing page reorganises itself per theme, demonstrating the structural-variety principle.
-
-**Two test specimens** — [`site/_example-bakery/`](site/_example-bakery/) (an editorial bakery announcement, output of a real `hallmark` run) and [`site/_example-cmdk/`](site/_example-cmdk/) (a keyboard-first command palette demonstrating the microinteraction canon).
-
-**Roadmap** — [`ROADMAP.md`](ROADMAP.md) lists Tier 1, 2, and 3 work, plus an explicit "things to *not* do" list and measurement criteria.
+- **[`SKILL.md`](skill/SKILL.md)** — the routing file. Design flow, slop test (29 questions), output contract.
+- **[`references/`](skill/references/)** — fourteen short, opinionated rule files: typography, colour, layout, motion, microinteractions, interaction-and-states, responsive, copy, anti-patterns, the 21 named macrostructures, the 33 component archetypes with variation knobs, the 6 primitive structure axes, and the vision-extraction protocol for `study`.
+- **[`site/`](site/)** — a self-demonstrating landing page. Hand-written HTML + CSS + ES module, no framework, no build step. **Fifteen themes** — Specimen, Newsprint, Atelier, Garden, Salon, Linen, Almanac, Midnight, Terminal, Brutal, Manifesto, Sport, **Studio**, **Pastel**, **Riso** — that swap not just colour and typography but the page's hero archetype and footer archetype. Switching themes literally rebuilds the page.
+- **[`ROADMAP.md`](ROADMAP.md)** — Tier 1, 2, 3 work plus an explicit "things to *not* do" list.
---
## Install
-### Any harness, via npx
-
```
npx skills add hallmark
```
-### Claude Code (manual)
+Or copy [`skill/`](skill/) into `~/.claude/skills/hallmark/` (Claude Code) or `.cursor/rules/hallmark.mdc` (Cursor — body of `SKILL.md`, no frontmatter).
-Copy [`skill/SKILL.md`](skill/SKILL.md) and [`skill/references/`](skill/references/) into `~/.claude/skills/hallmark/`.
-
-### Cursor
-
-Create `.cursor/rules/hallmark.mdc` with the body of `SKILL.md` (no frontmatter).
-
-### View the landing page locally
+To preview the landing page:
```
-cd site && python3 -m http.server 4173
-# → http://localhost:4173
+cd site && python3 -m http.server 4173 # → http://localhost:4173
```
----
-
-## Philosophy
+Press `T` to cycle themes, `R` for random, `?theme=studio` for a shareable link.
-Five skills — [impeccable](https://github.com/pbakaus/impeccable), [kami](https://github.com/tw93/kami), [taste-skill](https://github.com/Leonxlnx/taste-skill), Anthropic's [frontend-design skill](https://github.com/anthropics/skills), and the Claude [frontend aesthetics cookbook](https://platform.claude.com/cookbook/coding-prompting-for-frontend-aesthetics) — have converged on roughly the same anti-slop ruleset. Hallmark takes that consensus, restates it in one voice, fills the gap on motion and microinteractions, and adds *structural* variety as a first-class principle.
+---
-Distinct choices:
+## What's distinct
-- **One skill, five verbs.** Not eighteen commands. Use the default; reach for `audit`, `refine`, `redesign`, or `study` when you need them.
-- **Design-context gate.** No audience + use case + tone → no design. The skill asks.
-- **Tone as a first-class decision.** "Clean and modern" is rejected. Pick an extreme: editorial, brutalist, soft, utilitarian, luxury, playful, technical, austere.
-- **Structural fingerprint.** Every page picks one option from each of six axes. Two consecutive outputs in a session should never share the same fingerprint.
-- **Microinteractions are not decoration.** Silent success over celebratory toasts. Optimistic update + Undo over confirm dialogs. Hover delay 800 ms, focus delay 0 ms.
-- **The slop test.** Twenty yes/no checks before handing back. One yes fails the output.
+- **One skill, five verbs.** Not eighteen commands.
+- **Tone is a first-class decision.** "Clean and modern" is rejected. Pick an extreme.
+- **Macrostructures over axes.** Pick one of 21 named whole-page shapes wholesale; the macrostructure stamp lives in the CSS comment, so the next Hallmark run picks something different.
+- **Within-archetype variation.** Two Bento Grids should not be twins; each archetype has 2–3 picked-per-output knobs.
+- **Microinteractions as discipline.** Silent success over celebratory toasts. Optimistic update + Undo over confirm dialogs. Hover delay 800 ms, focus delay 0 ms.
+- **A 29-gate slop test** runs before every output. One yes fails the build.
+- **`study` extracts DNA, not pixels.** Vision-extraction with refusal heuristics, type-role vocabulary (no font ID guessing), and a confirmation step before any code.
---
## Credits
-Built on the open work of Paul Bakaus ([impeccable](https://github.com/pbakaus/impeccable)), tw93 ([kami](https://github.com/tw93/kami)), Leonxlnx ([taste-skill](https://github.com/Leonxlnx/taste-skill)), Anthropic's skills team ([frontend-design](https://github.com/anthropics/skills) and [canvas-design](https://github.com/anthropics/skills)), [DESIGN.md](https://getdesign.md) (Google Stitch), MC Dean's [63 design skills](https://marieclairedean.substack.com/p/i-built-63-design-skills-for-claude), [PencilPlaybook](https://github.com/stevembarclay/pencilplaybook), and the [Slopless](https://slopless.design) tactile-rebellion canon. Where rules overlapped, Hallmark adopted; where they diverged, Hallmark picked.
+Built on the open work of:
+
+- Paul Bakaus' [**impeccable**](https://github.com/pbakaus/impeccable) — the named-tells canon
+- tw93's [**kami**](https://github.com/tw93/kami) — the slop-test concept and 20-question scoring
+- Leonxlnx's [**taste-skill**](https://github.com/Leonxlnx/taste-skill) — taste vocabulary and the audit verb
+- Anthropic's [**frontend-design**](https://github.com/anthropics/skills) and [**canvas-design**](https://github.com/anthropics/skills) skills — the design-context-gate pattern
+- Google Stitch's [**DESIGN.md**](https://getdesign.md) — single-source design docs
+- Marie Claire Dean's [**63 design skills for Claude**](https://marieclairedean.substack.com/p/i-built-63-design-skills-for-claude) — coverage map
+- Steve Barclay's [**PencilPlaybook**](https://github.com/stevembarclay/pencilplaybook) — the design-language playbook format
+- The [**Slopless**](https://slopless.design) tactile-rebellion canon — the 2026 anti-AI-perfect movement (informed Studio, Pastel, Riso)
+- Anthropic's [**Skill Engineering**](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills) writeup — file budgets, load-on-demand patterns, frontmatter shape
+
+Where rules overlapped, Hallmark adopted; where they diverged, Hallmark picked.
---
diff --git a/site/css/components.css b/site/css/components.css
index c950a5c..7a244c5 100644
--- a/site/css/components.css
+++ b/site/css/components.css
@@ -742,7 +742,7 @@
animation-timing-function: var(--ease-out);
}
-/* ───────────── STUDIO — italic Instrument Serif display ───────────── */
+/* ───────────── STUDIO — Fraunces italic display ───────────── */
[data-theme="studio"] .hero__display,
[data-theme="studio"] .section__title,
@@ -753,11 +753,13 @@
[data-theme="studio"] .tell__name {
font-style: italic;
letter-spacing: -0.02em;
+ font-variation-settings: "opsz" 144, "SOFT" 30;
}
[data-theme="studio"] .banner__center {
font-style: italic;
letter-spacing: 0;
+ font-variation-settings: "opsz" 24;
}
[data-theme="studio"] .hero__lede,
diff --git a/site/css/tokens.css b/site/css/tokens.css
index 06ec679..55b1c40 100644
--- a/site/css/tokens.css
+++ b/site/css/tokens.css
@@ -621,9 +621,11 @@
}
/* ──────────────────────────────────────────────────────────────
- STUDIO — modern editorial agency · italic Instrument Serif
+ STUDIO — modern editorial agency · Fraunces italic display
Inspiration: 14islands, Mathieu Triay, Frame, Gretel, contemporary
studio portfolios in 2026. Forest-green accent — uncommon, distinctive.
+ Fraunces is a variable serif with conventional italic letterforms;
+ used here at high optical size + soft axis for the editorial agency feel.
────────────────────────────────────────────────────────────── */
[data-theme="studio"] {
@@ -640,14 +642,16 @@
--color-accent-ink: oklch(46% 0.140 145);
--color-focus: oklch(46% 0.140 145);
- --font-display: "Instrument Serif", "Tiempos", ui-serif, Georgia, serif;
+ --font-display: "Fraunces", "Tiempos", ui-serif, Georgia, serif;
--font-body: "Geist", "Söhne", ui-sans-serif, system-ui, sans-serif;
- --font-serif: "Instrument Serif", ui-serif, Georgia, serif;
+ --font-serif: "Fraunces", ui-serif, Georgia, serif;
--font-label: "Geist Mono", "JetBrains Mono", ui-monospace, monospace;
--font-mono: "Geist Mono", "JetBrains Mono", ui-monospace, monospace;
--display-weight: 400;
+ --display-optical: 144;
--display-style: italic;
+ --display-soft: 30;
--text-display: clamp(3.5rem, 7vw + 1rem, 7.5rem);
--text-display-s: clamp(2.25rem, 4vw + 1rem, 4.25rem);
diff --git a/site/index.html b/site/index.html
index 4d6a2c6..3d86755 100644
--- a/site/index.html
+++ b/site/index.html
@@ -15,10 +15,10 @@
<link rel="preload" href="fonts/the-future-medium.woff2" as="font" type="font/woff2" crossorigin />
<link rel="preload" href="fonts/the-future-mono-regular.woff2" as="font" type="font/woff2" crossorigin />
- <!-- Google Fonts — used by Studio (Instrument Serif), Pastel (Geist), Riso (Bricolage + Newsreader). -->
+ <!-- Google Fonts — Fraunces (Specimen + Studio italic display), Geist (Pastel), Bricolage + Newsreader (Riso). -->
<link rel="preconnect" href="https://fonts.googleapis.com" />
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
- <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Bricolage+Grotesque:opsz,[email protected],500;12..96,700;12..96,800&family=Geist:wght@400;500;600;700&family=Geist+Mono:wght@400;500&family=Instrument+Serif:ital@0;1&family=Newsreader:ital,opsz,wght@0,6..72,400;0,6..72,500;1,6..72,400;1,6..72,500&display=swap" />
+ <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Bricolage+Grotesque:opsz,[email protected],500;12..96,700;12..96,800&family=Fraunces:ital,opsz,wght@0,9..144,400;0,9..144,500;0,9..144,600;1,9..144,400;1,9..144,500&family=Geist:wght@400;500;600;700&family=Geist+Mono:wght@400;500&family=Newsreader:ital,opsz,wght@0,6..72,400;0,6..72,500;1,6..72,400;1,6..72,500&display=swap" />
<link rel="stylesheet" href="css/tokens.css" />
<link rel="stylesheet" href="css/base.css" />