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.mdindex 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.cssindex 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.cssindex 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 displayInspiration: 14islands, Mathieu Triay, Frame, Gretel, contemporarystudio 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.htmlindex 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" />