Anti-AI-slop design skill for Claude Code, Cursor, and Codex.
CSS
The product picks the image row, collapsed slots are caught, a declared spring needs no waiver
Youssef9efc59a0358d
diff --git a/skills/hallmark/SKILL.md b/skills/hallmark/SKILL.mdindex 5421fa8..0ebcb15 100644--- a/skills/hallmark/SKILL.md+++ b/skills/hallmark/SKILL.md@@ -129,7 +129,7 @@ Emit code that satisfies the theme and the shape. Always:- **Read the exemplar** for the genre, `references/exemplars/<genre>.html`, once: a finished page in another theme that passes every gate. Take how its stamp, tokens, slots, states and openings are written, nothing else. Skip it if it is in your theme.- **Hero first.** Write the nav and the hero, run `node <skill-dir>/scripts/sloplint.mjs <file> --render --stage hero` (the fold at three widths, the hero's words, the visual's place, four first-screen shots), then the hero review in fresh context (`gates.md` § 6). Build the sections only once the hero ships: a hero rewrite after eight sections exist costs eight sections.- **One idea per screen.** Hero: headline (seven words or fewer, 50 characters or fewer), one sentence (twelve words or fewer), one or two actions. A section: a heading of three to five words, at most one line, then its object (a slot, a figure, a drawn thing, a list of four or fewer, a table of five rows or fewer). Four to eight sections, footer included; 450 visible words at most, fewer when the brief has less to say. Never pad to a count.-- **Show, do not describe.** On a product page with material or "leave slots": at least two `data-slot` containers, the hero visual and a demo strip; with neither, the page shows what is real (Step 2). The user's images fill them; otherwise a designed placeholder in the theme's colours with a corner label (`craft.md` § Demo slots). Never a grey box, never a fake screenshot with invented figures.+- **Show, do not describe.** On a product page with material or "leave slots": at least two `data-slot` containers, the hero visual (unless the theme's own object holds the hero) and a demo strip; with neither, the page shows what is real (Step 2). The user's images fill them; otherwise a designed placeholder in the theme's colours with a corner label (`craft.md` § Demo slots). Never a grey box or a fake screenshot with invented figures.- **The fold.** The hero is the first screen and only the first screen at 1440 x 900 and 1920 x 1080, its visual beside the text (centres within 60px, 48 to 120px apart), never pinned in a corner; a Banner shares it with the first section.- **Room.** 120px or more between sections at desktop, varied; 32 to 48px from a heading to its content; 24 to 40px between grid items. More space above a heading than below it.- **Page invariants.** One primary button style, one container width, one column gap for every multi-column section below the hero, one radius per nesting level, and never more centred heading groups than left-aligned ones. A subhead over 120 characters is set left-aligned.diff --git a/skills/hallmark/references/components/n5-floating-pill.md b/skills/hallmark/references/components/n5-floating-pill.mdindex 4f85a45..f556d2e 100644--- a/skills/hallmark/references/components/n5-floating-pill.md+++ b/skills/hallmark/references/components/n5-floating-pill.md@@ -1,6 +1,6 @@### N5 · Floating pillA rounded, content-sized nav, visibly detached from the edges, `--space-md` from the top, a blurred backdrop and a hairline ring. It is a pill from the first paint, or it starts as a full bar and morphs into the pill once the reader scrolls.-*Use when:* modern-minimal or atmospheric pages where the hero has a surface or imagery for the blur to sit over; the morph only when one kinetic moment earns its place on the page.+*Use when:* modern-minimal or atmospheric pages where the hero has a surface or imagery for the blur to sit over, or a playful page with the pill on solid paper and no blur; the morph only when one kinetic moment earns its place on the page.*Not:* N9 (edge-aligned, in flow); N2 (a corner chip). A pill 95% of the viewport wide is a full width bar with round ends; if the links push it past 720px, drop a link or use N9.```htmldiff --git a/skills/hallmark/references/gates.md b/skills/hallmark/references/gates.mdindex 4256ba8..8f081be 100644--- a/skills/hallmark/references/gates.md+++ b/skills/hallmark/references/gates.md@@ -66,7 +66,7 @@ One line each. `a`/`b` clauses share a number and carry their own tier. Genre no| Gate | Tier | Class | The tell | The fix || --- | --- | --- | --- | --- || 1 | Reflex | M | Inter, Roboto, Open Sans, Poppins, Lato or a system face as the display | a display face from the theme or `fonts.md` |-| 25 | Reflex | M | Running prose `max-width` outside 45 to 75ch; a one-sentence lede or caption may sit from 28ch | `max-width: 65ch` |+| 25 | Reflex | M | Running prose `max-width` outside 45 to 75ch; a lede or caption of two sentences or fewer may sit from 28ch | `max-width: 65ch` || 37 | Reflex | M | More than three font families | display, body, one outlier || 38i | Floor | M | One italic word inside an otherwise roman heading | a line break, or the whole head set one way || 38ii | Reflex | M | An italic display system. Guard: declared on `--font-display`, applied to every head at that level, true italic with `font-synthesis: none` | roman display |@@ -155,7 +155,7 @@ One line each. `a`/`b` clauses share a number and carry their own tier. Genre no### Finish (F-checks, never block)-F1 straight quotes in prose · F2 `...` for an ellipsis · F3 no `text-wrap: balance` on display heads · F4 more than one filled-primary button recipe on a page (dialogs count as their own page) · F5 an icon in a coloured coin · F6 display-size figures without tabular numerals · F7 one container recipe stamped on six or more selectors · F8 more than one scroll-choreography pattern · F9 fake-human avatar hotlinks (this half is a FAIL) or person-keyword stock URLs · F10 a Lottie where CSS or SVG would do · F11 a highlighter band at the baseline instead of behind the x-height, or an underline thicker than 2px or offset more than 0.25em · F12 a flex row of unequal heights without `align-items: center` · F13 the outlier face carrying more than one role · F14 a helper-text slot with no reserved `min-height: 1lh` · F15 page invariants broken: more than one primary button style, more than one container width, more than one column gap below the hero, more than one radius per nesting level, or more centred heading groups than left-aligned ones · F16 browser surfaces unthemed: no `::selection`, no `caret-color`, no `scrollbar-color` on a page with a committed palette. · F17 a text block squeezed into a sliver at 1440 (under about 16 characters wide over four lines or more), usually a grid placement gone wide (render).+F1 straight quotes in prose · F2 `...` for an ellipsis · F3 no `text-wrap: balance` on display heads · F4 more than one filled-primary button recipe on a page (dialogs count as their own page) · F5 an icon in a coloured coin · F6 display-size figures without tabular numerals · F7 one container recipe stamped on six or more selectors · F8 more than one scroll-choreography pattern · F9 fake-human avatar hotlinks (this half is a FAIL) or person-keyword stock URLs · F10 a Lottie where CSS or SVG would do · F11 a highlighter band at the baseline instead of behind the x-height, or an underline thicker than 2px or offset more than 0.25em · F12 a flex row of unequal heights without `align-items: center` · F13 the outlier face carrying more than one role · F14 a helper-text slot with no reserved `min-height: 1lh` · F15 page invariants broken: more than one primary button style, more than one container width, more than one column gap below the hero, more than one radius per nesting level, or more centred heading groups than left-aligned ones · F16 browser surfaces unthemed: no `::selection`, no `caret-color`, no `scrollbar-color` on a page with a committed palette. · F17 a text block squeezed into a sliver at 1440 (under about 16 characters wide over four lines or more), usually a grid placement gone wide (render). · F18 a `data-slot` that renders under 40px in either dimension at 1440, collapsed by a percentage width inside a shrink-to-fit parent (render).## 5. Judged clauses@@ -187,7 +187,7 @@ The gates above that a script cannot settle, with enough to judge them well.**67, tracked caps.** The small uppercase line with its letters spread apart, whether it sits above a heading, heads a table, names a tag or runs the nav. Delete the transform and the tracking and read it again: a label in the body face at a step smaller says the same thing without announcing that a machine set it. Capitals survive as a wordmark, and as the display voice of a theme built on them, where a control may follow.-**68, the wireframe page.** A page that promises material it does not have shows it as frames: six blank portraits under "Six instructors", three tall empty phones, four grey bottles. Each frame is honest on its own; together they read as a wireframe somebody forgot to finish. Set the set in type, keep a slot or two where the user's images will land, and draw the product's structure inside them.+**68, the wireframe page.** A page that promises material it does not have shows it as frames: six blank portraits under "Six instructors", four tall empty phones in a row, four grey bottles. Each frame is honest on its own; together they read as a wireframe somebody forgot to finish. Set the set in type, keep a slot or two where the user's images will land, and draw the product's structure inside them.**69, the echo.** A thin brief tempts a builder to say its few facts again: the price in the hero, on every card, in the FAQ and the footer. Each repetition reads as filler. Say a fact once, where it does work.@@ -217,7 +217,7 @@ The thread that built the page is its weakest reviewer. Spawn a reviewer with no> Review the first screen of a page that is still being built. You did not build it. First line: `ship` or `fix`. Then at most five findings, one line each, worst first: does the headline say something only this product could say, in seven words or fewer; is the visual beside the text, real or a labelled slot, and does it hold its half of the screen (where the shape puts no image in the fold, a Marquee or a Poster or Banner hero, the type is the visual: does it fill the screen); does anything read as a template (a centred stack, a pill or label above the headline, a gradient blob, a drawn dashboard standing in for a product, two filled buttons side by side; a filled primary beside an outlined or text action that goes somewhere else is the control pair, and a slot's sketch of the product's own structure is its placeholder, neither a finding); is the signature move on this screen; does the type carry the theme at this size; if you have the theme's picture, is this first screen as finished as its first screen, in a composition of its own. What the theme file prescribes (its blooms, its control pair) or refuses is not a finding. Do not fix anything.-Fix, recapture with `--stage hero`, send the recaptures back to be scored, and build the sections once the answer is `ship`. Two rounds is the ceiling here too: after the second, fix what is still owed, record what stays open (`hero-review: fix after 2 rounds, 1 open: the void at 1920`), and build on. Record the verdict in the stamp's finish-review field.+Fix, recapture with `--stage hero`, send the recaptures back to be scored, and build the sections once the answer is `ship`. Two rounds is the ceiling here too: after the second, fix what is still owed, record what stays open (`hero-review: fix after 2 rounds, 1 open: the void at 1920`), and build on. Record it as the stamp's own `hero-review:` field, before `finish-review:`.Score the return: fix what is real, mark each finding `resolved`, `partial` or `unresolved` with a reason, recapture the same files, and send the recaptures back to be scored, not re-reviewed. Two rounds is the ceiling. Record `finish-review: subagent · 4 findings · 3 resolved 1 unresolved · gap: none` in the stamp. No subagents: re-read the artifact cold, run the same brief against yourself, and record `finish-review: in-thread`.diff --git a/skills/hallmark/references/genres/playful.md b/skills/hallmark/references/genres/playful.mdindex e096ad2..dacc87a 100644--- a/skills/hallmark/references/genres/playful.md+++ b/skills/hallmark/references/genres/playful.md@@ -21,6 +21,6 @@ Saturated consumer pinks and violets without a declared posture; Comic-style fac## Chrome that fits-A heavy slab bar, a dense bar with rounded knobs, a banner, a marquee footer. A masthead or a blur pill fights the register. Affinities, not assignments.+A heavy slab bar, a dense bar with rounded knobs, a banner, a marquee footer. A masthead or a blurred pill fights the register; a solid pill does not. Affinities, not assignments.Stamp: `genre: playful`.diff --git a/skills/hallmark/references/hero-enrichment.md b/skills/hallmark/references/hero-enrichment.mdindex c7bb3c2..5bd6246 100644--- a/skills/hallmark/references/hero-enrichment.md+++ b/skills/hallmark/references/hero-enrichment.md@@ -10,18 +10,18 @@ Loaded at Step 4, only when the hero may carry imagery. Run the image-need check## Image-need check: does this brief want imagery at all?-The default is typography only. Match the brief against this table and act on the first row that fires:+The default is typography only. Match the brief against this table and act on the first row that fires; the product decides the row, not its subject (an app about bread takes the app row):| Brief signal | Image strategy || --- | --- |+| API, docs, changelog, CLI, library, SDK, package | No imagery. Typography only; code blocks if needed |+| SaaS landing, app, platform, dashboard, developer tool | A real capture in a slot: E4 (screenshot) or E1 (demo video). No capture, a designed placeholder (`craft.md` § 8), never a drawn mockup (47c) || e-commerce, shop, store, product catalogue, brand, fashion, lookbook | Real product photos; until the user provides them, one hero slot and the range in type (68) || photography, portfolio, gallery, artist | Imagery is the page; slots until the user provides it || food, restaurant, menu, dish, coffee, wine, recipe | A hero photo and product crops; until the user provides them, one hero slot and the dishes in type (68) || team, staff, about us, portraits, hiring, careers | A team `data-slot` sized for the user's real photos; kit avatars ([`imagery-kit.md`](imagery-kit.md) § Categories) may hold the slot with no name, title or quote attached; never pravatar, dicebear or unsplash faces (F9) || travel, hotel, destination, real estate, listing, property | A cover photo and tile photos; until the user provides them, one cover slot and the places in type (68) || news, blog, magazine, journal, publication | A feature image per post; until the user provides them, one slot on the lead post and the rest in type (68) |-| API, docs, changelog, CLI, library, SDK, package | No imagery. Typography only; code blocks if needed |-| SaaS landing, platform, dashboard, developer tool | A real capture in a slot: E4 (screenshot) or E1 (demo video). No capture, a designed placeholder (`craft.md` § 8), never a drawn mockup (47c) || atmospheric, slow and editorial | E7 (a two-colour gradient with grain) or E6 (one small loop), built in-page at tier A or B; any external asset obeys [`imagery-kit.md`](imagery-kit.md) (no URL outside its manifest) and [`assets.md` § Placeholder strategy](assets.md) || agency, studio | E8 photography, or none || manifesto, essay, letter, foundry, type specimen, broadside | No imagery. Display typography is the design |diff --git a/skills/hallmark/references/themes/hum.md b/skills/hallmark/references/themes/hum.mdindex 2b2346e..69aff32 100644--- a/skills/hallmark/references/themes/hum.md+++ b/skills/hallmark/references/themes/hum.md@@ -39,7 +39,7 @@ Cream pulled toward pear-yellow, three accents that never blend, Chillax for eve- **Display:** Chillax 600, `--tracking-display`, sentence case.- **Body:** Chillax 400 with 500 for inline emphasis; no serif anywhere.-- **Labels, captions, table heads, meta, units, ordinals:** Chillax 500 one step smaller, sentence case, `--color-muted`. Mono appears only inside code.+- **Labels, captions, table heads, meta, units, ordinals:** Chillax 500 one step smaller, sentence case, `--color-muted`; an ordinal sits outside its heading as the list's counter, and a number inside a heading takes the heading's weight and colour. Mono appears only inside code.## Material@@ -50,7 +50,7 @@ Cream pulled toward pear-yellow, three accents that never blend, Chillax for eve## Motion-Spring posture declared: gate 12 is waived on the primary CTA and on the one character moment only, both on `--ease-spring`; everything else eases out on `--ease-snap`. The press runs 140ms on hover, 70ms on active, no `scale()`. Cards lift 4px over 220ms. The character mark breathes at rest on a 4s period. Nothing else moves: no count-up, no staggered heads, no burst.+Spring posture declared: gate 12 allows the spring on the primary CTA and on the one character moment only, both on `--ease-spring`, with no waiver; everything else eases out on `--ease-snap`. The press runs 140ms on hover, 70ms on active, no `scale()`. Cards lift 4px over 220ms. The character mark breathes at rest on a 4s period. Nothing else moves: no count-up, no staggered heads, no burst.## Voicediff --git a/skills/hallmark/scripts/sloplint-render.mjs b/skills/hallmark/scripts/sloplint-render.mjsindex 62361cd..78687cc 100644--- a/skills/hallmark/scripts/sloplint-render.mjs+++ b/skills/hallmark/scripts/sloplint-render.mjs@@ -3,7 +3,7 @@ import { existsSync, mkdirSync } from 'node:fs';import { join, dirname, basename, resolve } from 'node:path';import { fileURLToPath } from 'node:url';-const WIDTHS = [320, 375, 414, 768, 1280, 1920];+const WIDTHS = [320, 375, 414, 768, 1024, 1280, 1920];const CHROMES = ['/Applications/Google Chrome.app/Contents/MacOS/Google Chrome', '/Applications/Chromium.app/Contents/MacOS/Chromium', '/usr/bin/google-chrome', '/usr/bin/google-chrome-stable', '/usr/bin/chromium', '/usr/bin/chromium-browser', '/snap/bin/chromium', 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe'];const isUrl = (t) => /^https?:\/\//.test(t);const slugOf = (t) => isUrl(t) ? t.replace(/^https?:\/\//, '').replace(/[^\w.-]+/g, '-').replace(/-+$/, '') : basename(t, '.html');@@ -563,6 +563,12 @@ function observeSpace(atLaptop, heroOnly, heroPosture) {}if (!heroOnly && secs.length > 9) push(59, 'WARN', `${secs.length} sections`, 'Four to eight sections a page; merge or cut');if (!heroOnly) {+ for (const sl of document.querySelectorAll('[data-slot]')) {+ const cs = getComputedStyle(sl);+ if (cs.display === 'none' || cs.visibility === 'hidden') continue;+ const r = sl.getBoundingClientRect();+ if (r.width < 40 || r.height < 40) { push('F18', 'WARN', `slot "${sl.getAttribute('data-slot')}" renders at ${Math.round(r.width)} x ${Math.round(r.height)}px`, 'The slot collapsed: give it a width from its track and a real aspect-ratio, never a percentage of a shrink-to-fit parent'); break; }+ }for (const e of document.querySelectorAll('p, li, dd, td, th, h2, h3, h4, figcaption, blockquote')) {if (!vis(e) || e.closest('nav, svg, [aria-hidden="true"]')) continue;const t = (e.innerText || '').trim();diff --git a/skills/hallmark/scripts/sloplint.mjs b/skills/hallmark/scripts/sloplint.mjsindex c6bc5b0..6fbefde 100644--- a/skills/hallmark/scripts/sloplint.mjs+++ b/skills/hallmark/scripts/sloplint.mjs@@ -1287,10 +1287,15 @@ function check11(ctx) {function check12(ctx) {const uiSel = /:hover|:active|:focus|\b(btn|button|modal|dialog|tooltip|dropdown|menu|popover|toast|tab|input|select|switch|toggle|accordion)\b/i;+ const playful = ctx.genre === 'playful' || /genre:\s*playful/.test(ctx.stampText || '');+ const declared = playful && /--ease-spring/.test(Object.keys(ctx.tokens).join(' '));+ const springHome = (r) => /primary|cta|press|character|mascot|hero__btn|btn--solid|btn--main/i.test(r.selector);+ const springSels = new Set();for (const r of ctx.rules) {if (!uiSel.test(r.selector)) continue;for (const d of r.decls) {if (!/transition|animation/.test(d.prop)) continue;+ if (declared && /var\(--ease-spring\)/.test(d.value) && springHome(r) && (springSels.add(baseSelector(r.selector).split(':')[0]), springSels.size <= 2)) continue;const re = /cubic-bezier\(\s*([-\d.]+)\s*,\s*([-\d.]+)\s*,\s*([-\d.]+)\s*,\s*([-\d.]+)\s*\)/g;let m;while ((m = re.exec(resolveVars(d.value, ctx.tokens)))) {