Skip to content

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

CSS

Second round of gallery lessons: caps leading, quiet rows, real alt text

Youssef0bdb4545d15a
diff --git a/skills/hallmark/references/craft.md b/skills/hallmark/references/craft.md
index d190806..40664b0 100644
--- a/skills/hallmark/references/craft.md
+++ b/skills/hallmark/references/craft.md
@@ -81,7 +81,7 @@ Every posture, every hero:
- **One reveal per page**, staggered by a `--i` custom property, capped at 500ms, and the content is visible without it (62): scope the hidden state to a `.js` class the script adds, or animate from visible with `@starting-style`. Reduced motion collapses spatial motion to a 150ms opacity crossfade and keeps functional loaders running.
- **Scroll:** IntersectionObserver for reveals and for any state that flips at a threshold; a passive scroll listener, throttled to one read per frame, only where direction matters (a bar that hides on the way down); reveal once; scroll-scrubbed motion exists only as the named patterns in `scroll-choreography.md`, one per page (F8).
- **State:** hover `translateY(-1px)` at micro, active back to 0; menus `--ease-out` open and `--ease-in` close with the Popover API; modals scale 0.96 to 1 with a backdrop fade over `--dur-long` using `<dialog>` and `inert`; accordions animate `grid-template-rows: 0fr` to `1fr`; tooltips delay 800 to 1000ms on hover and 0ms on focus (17); focus rings never animate (15).
-- **Never:** parallax, custom cursors, cursor followers, infinite loops other than loaders and a paused-on-hover marquee, `will-change` on a whole class, an image that scales or rotates on hover (11), a pulsing dot that is not live data.
+- **Never:** parallax, custom cursors, cursor followers, infinite loops other than loaders, a paused-on-hover marquee, and one ambient loop a theme declares as its material (8s or slower, stopped under reduced motion and while off-screen), `will-change` on a whole class, an image that scales or rotates on hover (11), a pulsing dot that is not live data.
Full recipes (buttons, inputs, validation, toasts, modals, menus, drag, command palette, optimistic updates) are in `microinteractions.md`; load it when the page has stateful UI.
@@ -118,7 +118,7 @@ Two moves can share a section; three is panic. Pick one opening and repeat it, o
A landing page is a demo. The first screen shows the thing working; later screens show it from other angles. Prose is what a page falls back on when it has nothing to show.
-A slot is a container carrying `data-slot="<name>"` (`hero`, `demo-2`, `demo-3`, `photo-1`) at a real size (an `aspect-ratio` or a fixed height, never the image's own), holding a designed placeholder that the user's image replaces without touching the layout. Both snippets ship in every page that has a slot; in a framework the same contract is a `<Slot name="hero">` component.
+A slot is a container carrying `data-slot="<name>"` (`hero`, `demo-2`, `demo-3`, `photo-1`) and a `data-alt` describing what will be in it, at a real size (an `aspect-ratio` or a fixed height, never the image's own), holding a designed placeholder that the user's image replaces without touching the layout. Both snippets ship in every page that has a slot; in a framework the same contract is a `<Slot name="hero">` component.
```css
[data-slot] { position: relative; overflow: hidden; }
@@ -127,7 +127,7 @@ A slot is a container carrying `data-slot="<name>"` (`hero`, `demo-2`, `demo-3`,
```
```js
-window.hallmarkSlots = (m) => { for (const [k, v] of Object.entries(m)) { const s = document.querySelector(`[data-slot="${k}"]`); if (!s) continue; const im = new Image(); im.src = v; im.alt = ''; s.prepend(im); } };
+window.hallmarkSlots = (m) => { for (const [k, v] of Object.entries(m)) { const s = document.querySelector(`[data-slot="${k}"]`); if (!s) continue; const im = new Image(); im.src = typeof v === 'string' ? v : v.src; im.alt = (typeof v === 'object' && v.alt) || s.dataset.alt || ''; s.prepend(im); } };
```
**The placeholder is designed, not grey.** A gradient of two or three OKLCH stops from the theme's paper and accent with a slow hue path (a mesh of two radial gradients is the richer version; dark themes glow from a corner, light themes wash from an edge), optionally a sparse drawn interface of five shapes or fewer in the theme's material, one corner label in the theme's caption style saying what goes there (`your screenshot`, `product photo`), inside a frame that suits the theme (a hairline panel with a slight tilt, a device silhouette, a plain rounded panel, a kiss-cut print, an enamel plate). Never traffic lights, a URL pill or a notch (47a); never invented figures presented as real (47c); never the word *placeholder* at display size.
diff --git a/skills/hallmark/references/gates.md b/skills/hallmark/references/gates.md
index 7da4b83..24959ce 100644
--- a/skills/hallmark/references/gates.md
+++ b/skills/hallmark/references/gates.md
@@ -196,7 +196,7 @@ The gates above that a script cannot settle, with enough to judge them well.
## 6. The finish review, in fresh context
-The thread that built the page is its weakest reviewer. Spawn a reviewer with no inherited transcript (a subagent in Claude Code) and give it only: the artifact paths, the screenshots at 1280 x 800, 1440 x 900 and 375, the direction contract or theme line from the stamp, and § 4 of this file. Its brief:
+The thread that built the page is its weakest reviewer. Spawn a reviewer with no inherited transcript (a subagent in Claude Code) and give it only: the artifact paths, the screenshots the render tier wrote (the folds at 1280 x 800, 1440 x 900 and 1920 x 1080, and the full page at 1440 and at 375), the direction contract or theme line from the stamp, and § 4 of this file. Its brief:
> Review a built page against a fixed list. You did not build it and will not be told why anything is the way it is. Read the page, not the intent. Reading is an allowance: the inputs above and nothing else, batched, and by the tenth turn stop reading and write.
>
diff --git a/skills/hallmark/references/themes/ledger.md b/skills/hallmark/references/themes/ledger.md
index 07842ef..bf74eaf 100644
--- a/skills/hallmark/references/themes/ledger.md
+++ b/skills/hallmark/references/themes/ledger.md
@@ -46,7 +46,7 @@ Credit is money in: it takes the headline figure and the one solid button. Debit
- **Display:** Instrument Sans 600, `--tracking-display`. No thin weight.
- **Body:** Instrument Sans 400 and 500 at 1.0625rem, line-height 1.55.
-- **Figures and column heads:** IBM Plex Mono 400 and 500 with `tabular-nums` on every number and on column heads at 12px, sentence case, untracked. Mono is this theme's material; columns align digit for digit. The headline figure is mono 500 at `clamp(2.4rem, 6vw, 3.6rem)` in its side's ink.
+- **Figures:** IBM Plex Mono 400 and 500 with `tabular-nums` on every number; a column head is mono only over a column of figures, and the body face over a column of words (64), 12px, sentence case, untracked. Mono is this theme's material; columns align digit for digit. The headline figure is mono 500 at `clamp(2.4rem, 6vw, 3.6rem)` in its side's ink.
- **Captions, field labels, status words, meta:** Instrument Sans 500 one step smaller, sentence case, `--color-muted`.
## Material
@@ -54,13 +54,13 @@ Credit is money in: it takes the headline figure and the one solid button. Debit
- The sheet is ruled, and the ruling is the theme: it never brightens, never animates, never carries chroma.
- Every figure foots and carries an as-of: columns sum to their totals and balances state their moment. A figure without a date is an assertion, not a record.
- The foot: a 1px rule above the total, the total, then a double rule (two 1px rules 3px apart). The kit: the T-account, the statement extract as a real `<table>` with right-aligned amounts, one credit-ink sparkline with no axes, a status column, and a rotated outline stamp in one ink. A stamp carries a fact, a date or a frame number, or does not appear.
-- Rows, never tiles: repeated data is a ruled table whose hover lifts the row one paper step. At most one chart, and it is the sparkline.
+- Rows, never tiles: repeated data is a ruled table; a row lifts one paper step on hover only when the whole row is a link (11). At most one chart, and it is the sparkline.
- Depth: 1px `--color-rule` on every edge, raised paper on `--color-paper-2` under one deep offset shadow. Radii 10px and 6px, never a pill.
- The control pair: one solid credit-ink button at 6px with `--color-accent-ink` text beside a hairline-outlined one in `--color-rule`.
## Motion
-Near-still, the way a printed page behaves: rows shift one paper step on hover; buttons dip 1px on active; one live dot may pulse over 2.4s, once per page. Nothing counts up, nothing reveals.
+Near-still, the way a printed page behaves: linked rows shift one paper step on hover; buttons dip 1px on active; one live dot may pulse over 2.4s, once per page. Nothing counts up, nothing reveals.
## Voice
diff --git a/skills/hallmark/references/themes/manifesto.md b/skills/hallmark/references/themes/manifesto.md
index 35a2e28..5bd8275 100644
--- a/skills/hallmark/references/themes/manifesto.md
+++ b/skills/hallmark/references/themes/manifesto.md
@@ -20,7 +20,7 @@ A warm near-black ground, Anton uppercase up to 9rem leaded at 0.86 and slammed
```css
:root {
--color-paper: oklch(10% 0.005 60); --color-paper-2: oklch(15% 0.006 60); --color-paper-3: oklch(20% 0.007 60);
- --color-ink: oklch(98% 0.003 90); --color-ink-2: oklch(88% 0.006 80); --color-muted: oklch(60% 0.012 65);
+ --color-ink: oklch(98% 0.005 90); --color-ink-2: oklch(88% 0.006 80); --color-muted: oklch(60% 0.012 65);
--color-rule: oklch(28% 0.010 60);
--color-accent: oklch(56% 0.23 28); --color-accent-text: oklch(62% 0.23 28); --color-accent-ink: oklch(98% 0.003 90);
--color-focus: oklch(56% 0.23 28);
diff --git a/skills/hallmark/references/themes/piste.md b/skills/hallmark/references/themes/piste.md
index f490625..d856d33 100644
--- a/skills/hallmark/references/themes/piste.md
+++ b/skills/hallmark/references/themes/piste.md
@@ -19,7 +19,7 @@ Snow-white paper, Barlow Condensed 800 caps in black, cobalt for the runs, the b
```css
:root {
- --color-paper: oklch(98.5% 0.004 260); --color-paper-2: oklch(96% 0.004 260); --color-paper-3: oklch(92% 0.006 260);
+ --color-paper: oklch(98.5% 0.005 260); --color-paper-2: oklch(96% 0.005 260); --color-paper-3: oklch(92% 0.006 260);
--color-ink: oklch(16% 0.01 260); --color-ink-2: oklch(28% 0.012 260); --color-muted: oklch(50% 0.015 260);
--color-rule: oklch(90% 0.006 260);
--color-accent: oklch(52% 0.25 265); --color-accent-ink: oklch(98.5% 0.004 260); --color-focus: oklch(58% 0.22 28);
@@ -42,14 +42,14 @@ Committed: cobalt is `--color-field` and carries a band, a column and a block; t
## Faces
-- **Display:** Barlow Condensed 800, uppercase, line-height 0.92, `--tracking-display`, up to 116px; every head and every figure. Roman.
+- **Display:** Barlow Condensed 800, uppercase, line-height 1.0 when a head can wrap (55a) and 0.92 only on a single nowrap line, `--tracking-display`, up to 7.25rem on a Marquee or Ledge hero; every head and every figure. Roman.
- **Body:** Barlow 400 and 500, 16 to 19px, line-height 1.5.
- **Signs and buttons:** Barlow Condensed 700, uppercase, tracked 0.04em, 14 to 16px, following the display's capitals. Table heads, captions and meta: Barlow 500 one step smaller, sentence case, untracked. No mono outside code.
## Material
- Rules `--rule-bar` ink on top of a table and under a nav; `--rule-hair` in paper-3 between rows. Radius 0: signs are cut, tables are ruled, cards are rare.
-- The sign: a strip of condensed caps with one end cut to a point by clip-path, filled cobalt, red or black, or outlined 2px. Signs are the nav items and the tags.
+- The sign: a strip of condensed caps with one end cut to a point by clip-path, filled cobalt, red or black, or outlined 2px. Signs are the nav items, in the display's capitals at 16px or more tracked 0.04em at most; a tag smaller than that is a sign in sentence case (67).
- Grade marks: 10px discs in blue, red or black that mean a piste's grade and nothing else. A disc never decorates a label.
- The mountain: one SVG polyline of six to ten points in ink for the profile and two or three curved cobalt paths for the runs on it; that is the whole drawing, under 40 lines. Snow-depth bars are plain rects. The cobalt band sweeping the hero is a single wide SVG path.
- Shadow: none on chrome; the soft `--shadow-card` under the one framed report.
@@ -78,7 +78,7 @@ The morning report: the hour, the depth in centimetres, the lifts open, the run
```
```css
-.display { font: 800 var(--text-display)/0.92 var(--font-display); text-transform: uppercase; letter-spacing: var(--tracking-display); text-wrap: balance; }
+.display { font: 800 var(--text-display)/1 var(--font-display); text-transform: uppercase; letter-spacing: var(--tracking-display); text-wrap: balance; }
.sign { display: inline-flex; align-items: center; height: 34px; padding: 0 22px 0 14px; font: 700 14px var(--font-display); letter-spacing: 0.04em; text-transform: uppercase;
background: var(--color-accent); color: var(--color-accent-ink); clip-path: polygon(0 0, calc(100% - 12px) 0, 100% 50%, calc(100% - 12px) 100%, 0 100%); }
.grade { display: inline-block; width: 10px; height: 10px; border-radius: 50%; background: var(--color-accent); }
diff --git a/skills/hallmark/references/themes/ribbon.md b/skills/hallmark/references/themes/ribbon.md
index adad88d..ca11782 100644
--- a/skills/hallmark/references/themes/ribbon.md
+++ b/skills/hallmark/references/themes/ribbon.md
@@ -20,7 +20,7 @@ Warm off-white paper, Newsreader italic 300 at every display size, pills for eve
```css
:root {
--color-paper: oklch(98.5% 0.006 85); --color-paper-2: oklch(96% 0.009 85); --color-paper-3: oklch(92.5% 0.012 85);
- --color-ink: oklch(18% 0.004 80); --color-ink-2: oklch(30% 0.008 80); --color-muted: oklch(48% 0.012 80);
+ --color-ink: oklch(18% 0.005 80); --color-ink-2: oklch(30% 0.008 80); --color-muted: oklch(48% 0.012 80);
--color-rule: oklch(90% 0.010 85); --color-rule-2: oklch(94% 0.008 85);
--color-accent: oklch(44% 0.075 190); --color-accent-ink: oklch(98% 0.006 85); --color-focus: oklch(52% 0.09 190);
--color-band: oklch(26% 0.045 195); --color-band-ink: oklch(94% 0.012 85);
diff --git a/skills/hallmark/references/themes/rim.md b/skills/hallmark/references/themes/rim.md
index c7f58e6..87209d9 100644
--- a/skills/hallmark/references/themes/rim.md
+++ b/skills/hallmark/references/themes/rim.md
@@ -19,7 +19,7 @@ Warm black paper, one disc lit along a third of its edge by a hard conic rim, Sw
```css
:root {
- --color-paper: oklch(6% 0.004 80); --color-paper-2: oklch(10% 0.005 80); --color-paper-3: oklch(4% 0.004 80);
+ --color-paper: oklch(6% 0.005 80); --color-paper-2: oklch(10% 0.005 80); --color-paper-3: oklch(4% 0.005 80);
--color-ink: oklch(94% 0.010 80); --color-ink-2: oklch(84% 0.011 80); --color-muted: oklch(66% 0.012 80); --color-muted-2: oklch(50% 0.010 80);
--color-rule: oklch(24% 0.010 80); --color-rule-2: oklch(15% 0.008 80);
--color-accent: oklch(72% 0.17 45); --color-accent-ink: oklch(10% 0.02 45); --color-accent-2: oklch(74% 0.12 250); --color-focus: oklch(78% 0.15 45);
diff --git a/skills/hallmark/references/themes/sport.md b/skills/hallmark/references/themes/sport.md
index c542caa..f649678 100644
--- a/skills/hallmark/references/themes/sport.md
+++ b/skills/hallmark/references/themes/sport.md
@@ -19,7 +19,7 @@ Cool concrete paper, blue-black ink, Saira Condensed 700 uppercase heads, JetBra
```css
:root {
- --color-paper: oklch(98% 0.003 250); --color-paper-2: oklch(95.5% 0.004 250); --color-paper-3: oklch(92.5% 0.005 250);
+ --color-paper: oklch(98% 0.005 250); --color-paper-2: oklch(95.5% 0.005 250); --color-paper-3: oklch(92.5% 0.005 250);
--color-ink: oklch(16% 0.080 260); --color-ink-2: oklch(22% 0.060 258); --color-muted: oklch(50% 0.020 250);
--color-rule: oklch(78% 0.008 250); --color-rule-2: oklch(36% 0.060 255);
--color-accent: oklch(88% 0.200 120); --color-accent-ink: oklch(16% 0.080 260); --color-accent-deep: oklch(58% 0.145 125);
diff --git a/skills/hallmark/references/themes/wayfind.md b/skills/hallmark/references/themes/wayfind.md
index 7967a8d..7ffe680 100644
--- a/skills/hallmark/references/themes/wayfind.md
+++ b/skills/hallmark/references/themes/wayfind.md
@@ -19,7 +19,7 @@ Cool grey paper, all type in Space Mono and JetBrains Mono, 2px ink borders on e
```css
:root {
- --color-paper: oklch(95% 0.005 250); --color-paper-2: oklch(91% 0.008 250); --color-paper-3: oklch(99.5% 0.003 250);
+ --color-paper: oklch(95% 0.005 250); --color-paper-2: oklch(91% 0.008 250); --color-paper-3: oklch(99.5% 0.005 250);
--color-ink: oklch(15% 0.01 260); --color-ink-2: oklch(28% 0.012 260); --color-muted: oklch(48% 0.015 260);
--color-rule: oklch(82% 0.01 250); --color-plate: oklch(15% 0.01 260);
--color-accent: oklch(52% 0.22 264); --color-accent-2: oklch(80% 0.16 85); --color-accent-ink: oklch(99.5% 0.003 250); --color-focus: oklch(52% 0.22 264);
diff --git a/skills/hallmark/scripts/sloplint-render.mjs b/skills/hallmark/scripts/sloplint-render.mjs
index 334fb1f..b412fea 100644
--- a/skills/hallmark/scripts/sloplint-render.mjs
+++ b/skills/hallmark/scripts/sloplint-render.mjs
@@ -79,6 +79,7 @@ export async function renderCheck(htmlFiles, metaIn) {
for (const [w, h] of [[1440, 900], [1920, 1080]]) {
await page.setViewport({ width: w, height: h });
await shoot(page, file, `${prefix}${w}x${h}`, false);
+ if (!heroOnly && w === 1440) await shoot(page, file, '1440-full', true);
await page.evaluate(async () => { for (let y = 0; y < document.documentElement.scrollHeight; y += 800) { window.scrollTo(0, y); await new Promise((r) => setTimeout(r, 15)); } window.scrollTo(0, 0); });
await new Promise((r) => setTimeout(r, 200));
const res = await page.evaluate(observeSpace, w === 1440, heroOnly, meta.heroPostureByFile[file] || '');
@@ -93,7 +94,7 @@ export async function renderCheck(htmlFiles, metaIn) {
} finally {
await browser.close().catch(() => {});
}
- if (SHOTS.length) console.error(heroOnly ? `render tier: ${SHOTS.length} hero screenshots in ${dirname(SHOTS[0])} (1280x800, 1440x900, 1920x1080 and 375x812 first screens)` : `render tier: ${SHOTS.length} screenshots in ${dirname(SHOTS[0])} (1280x800, 1440x900, 1920x1080 folds; 375 full page)`);
+ if (SHOTS.length) console.error(heroOnly ? `render tier: ${SHOTS.length} hero screenshots in ${dirname(SHOTS[0])} (1280x800, 1440x900, 1920x1080 and 375x812 first screens)` : `render tier: ${SHOTS.length} screenshots in ${dirname(SHOTS[0])} (1280x800, 1440x900, 1920x1080 folds; 1440 and 375 full pages)`);
const seen = new Set();
return findings.filter((f) => {
diff --git a/skills/hallmark/scripts/theme.mjs b/skills/hallmark/scripts/theme.mjs
index 641cb27..ce03a43 100644
--- a/skills/hallmark/scripts/theme.mjs
+++ b/skills/hallmark/scripts/theme.mjs
@@ -224,7 +224,7 @@ button, input, select, textarea { font: inherit; }
@media (max-width: 40rem) { :root { --gutter: 16px; --section-gap: 72px; --gap-columns: 16px; } }
@media (prefers-reduced-motion: reduce) { *:not(.keep-motion), *:not(.keep-motion)::before, *:not(.keep-motion)::after { animation-duration: 0.01ms !important; animation-iteration-count: 1 !important; transition-duration: 0.01ms !important; scroll-behavior: auto !important; } }`;
-const SLOTS_JS = `window.hallmarkSlots = (m) => { for (const [k, v] of Object.entries(m)) { const s = document.querySelector(\`[data-slot="\${k}"]\`); if (!s) continue; const im = new Image(); im.src = v; im.alt = ''; s.prepend(im); } };`;
+const SLOTS_JS = `window.hallmarkSlots = (m) => { for (const [k, v] of Object.entries(m)) { const s = document.querySelector(\`[data-slot="\${k}"]\`); if (!s) continue; const im = new Image(); im.src = typeof v === 'string' ? v : v.src; im.alt = (typeof v === 'object' && v.alt) || s.dataset.alt || ''; s.prepend(im); } };`;
function scaffold() {
const custom = has('custom');
@@ -298,6 +298,7 @@ function validate(files) {
}
const fence = tokenBlockOf(src, f);
if (/\/\*/.test(fence)) problems.push('comment inside the token block');
+ if (!/waive 22/.test(src)) for (const m of fence.matchAll(/(--color-(?:paper|paper-2|paper-3|ink|ink-2|muted|rule|rule-2)):\s*oklch\(\s*[\d.]+%\s+([\d.]+)/g)) if (Number(m[2]) < 0.005) problems.push(`${m[1]} chroma ${m[2]} is under the 0.005 floor (gate 22), or the file names waive 22`);
for (const k of ['--color-paper', '--color-ink', '--color-muted', '--color-rule', '--color-accent', '--color-accent-ink', '--color-focus', '--font-display', '--font-body', '--radius-card', '--tracking-display']) if (!fence.includes(k + ':')) problems.push(`token block lacks ${k}`);
if (problems.length) { bad++; console.log(`${f}: ${problems.join('; ')}`); } else console.log(`${f}: ok (${e.name}, ${triple(e)}, ${src.length} bytes)`);
} catch (err) { bad++; console.log(`${f}: ${err.message}`); }