Skip to content

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

CSS

A crashed render is a FAIL, logs are written by script, reviews hand over

Youssef10565cbbe022
diff --git a/README.md b/README.md
index 427e85d..795674f 100644
--- a/README.md
+++ b/README.md
@@ -39,13 +39,13 @@ Each page is self-contained HTML and CSS, stamped in its first CSS comment with
<td width="25%"><a href="https://www.usehallmark.com/examples/hum-07/"><img src="docs/screenshots/hero-hum-07.jpg" alt="Bubble guided sourdough app hero" /></a></td>
<td width="25%"><a href="https://www.usehallmark.com/examples/cobalt-01/"><img src="docs/screenshots/hero-cobalt-01.jpg" alt="Distil content-extraction API hero" /></a></td>
<td width="25%"><a href="https://www.usehallmark.com/examples/carnival-01/"><img src="docs/screenshots/hero-carnival-01.jpg" alt="Cold Snap record-label EP hero" /></a></td>
- <td width="25%"><a href="https://www.usehallmark.com/examples/lumen-01/"><img src="docs/screenshots/hero-lumen-01.jpg" alt="Cinder AI reasoning tool hero" /></a></td>
+ <td width="25%"><a href="https://www.usehallmark.com/examples/lumen-01/"><img src="docs/screenshots/hero-lumen-01.jpg" alt="Cinder serverless GPU inference hero" /></a></td>
</tr>
<tr>
<td><b>Bubble</b><br/><sub>Sourdough app · Hum</sub></td>
<td><b>Distil</b><br/><sub>Extraction API · Cobalt</sub></td>
<td><b>Cold Snap</b><br/><sub>Record label · Carnival</sub></td>
- <td><b>Cinder</b><br/><sub>AI tool · Lumen</sub></td>
+ <td><b>Cinder</b><br/><sub>GPU inference · Lumen</sub></td>
</tr>
<tr>
<td><a href="https://www.usehallmark.com/examples/custom-03/"><img src="docs/screenshots/hero-custom-03.jpg" alt="Ferns and Fathom tea menu hero" /></a></td>
diff --git a/site/index.html b/site/index.html
index a3bc656..555a67a 100644
--- a/site/index.html
+++ b/site/index.html
@@ -329,7 +329,7 @@
<p class="ex-card__prompt"><span class="ex-card__prompt-mark">$</span> /hallmark build a record-label EP page, Carnival</p>
</a>
- <a class="ex-card" style="--scroll-dur:3.1s" role="listitem" href="examples/lumen-01/" target="_blank" rel="noopener" aria-label="Open the Cinder example, an AI reasoning tool, Lumen, in a new tab">
+ <a class="ex-card" style="--scroll-dur:3.1s" role="listitem" href="examples/lumen-01/" target="_blank" rel="noopener" aria-label="Open the Cinder example, serverless GPU inference, Lumen, in a new tab">
<div class="ex-card__thumb" aria-hidden="true">
<img src="_tests/_thumbs/lumen-01.jpg?v=25" alt="" loading="lazy" width="1600" height="1000" />
</div>
diff --git a/skills/hallmark/SKILL.md b/skills/hallmark/SKILL.md
index 1cfc72e..13190df 100644
--- a/skills/hallmark/SKILL.md
+++ b/skills/hallmark/SKILL.md
@@ -88,7 +88,7 @@ Check in order; the first match wins.
node <skill-dir>/scripts/theme.mjs deal --genre <genre> --brief "<the brief>" [--log .hallmark/log.json]
```
-The script reads the catalog index and the log, applies Rotation (two consecutive systems differ on paper band, display class or accent band; siblings in the log count as occupied) and deals three candidates that fit the brief's words, one line each, with a reproducible seed. Look at the three pictures, pick one, say which and why in one clause, and load only `references/themes/<slug>.md`. Re-deal only when the user asks (`--reroll 1`). No Node: read `references/themes/index.json`, apply the same rule by hand, and stamp `deal: manual`.
+The script reads the catalog index and the log, applies Rotation (consecutive systems differ on paper band, display class or accent band; logged siblings count as taken) and deals three candidates that fit the brief, with a reproducible seed. Look at the three pictures, pick one, say which and why in one clause, and load only `references/themes/<slug>.md`. Re-deal only when the user asks (`--reroll 1`). No Node: read `references/themes/index.json`, apply the same rule by hand, and stamp `deal: manual`.
A catalog theme is a material, not a plan: it says what the page is made of, never what the page contains or in what order. Two pages in one theme should not share a section sequence. Where the theme and a shape, genre, craft or enrichment file disagree on material, controls or motion, the theme wins; nothing beats the Floor.
@@ -126,7 +126,7 @@ On signal 9, [`references/comp.md`](references/comp.md) runs here: two comps of
Emit code that satisfies the theme and the shape. Always:
- **Start from the scaffold.** `node <skill-dir>/scripts/theme.mjs scaffold <slug>` (with the deal's `--dealt`; `--custom` on a derived run) writes `tokens.css` with the theme's tokens and the shared scale, and prints the base rules the Floor already decided under a stamp skeleton. Paste them, fill the stamp, and write only the page.
-- **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; never its shape, theme or copy. Skip it if it is in your theme.
+- **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.
@@ -148,7 +148,7 @@ Emit code that satisfies the theme and the shape. Always:
then any `waive` and `answered` lines, then a custom run's direction contract. Everything the linter reads sits in the first 40 lines.
- **`tokens.css`** is the scaffold's, at the project root, imported by the page; every colour, face, space, size, easing, duration, rule, radius and z level is a token in it. On a `design.md` project, refresh its `## Exports` per [`references/export-formats.md`](references/export-formats.md).
- **Existing stylesheets are append-only.** Keep `@tailwind` and `@import "tailwindcss"` where they are, add Hallmark's `:root` below them, reuse the project's own token names where they exist. A full rewrite only on explicit request.
-- **Log.** Append to `.hallmark/log.json`, newest first, trimmed to 20:
+- **Log.** `node <skill-dir>/scripts/theme.mjs log --entry '<json>'` puts it atop `.hallmark/log.json`, trimmed to 20:
```json
{ "date": "2026-09-22", "shape": "Workbench", "theme": "Coral", "axes": "light/grotesk-sans/warm",
diff --git a/skills/hallmark/references/components/h4-stat-led.md b/skills/hallmark/references/components/h4-stat-led.md
index a450cd2..089f540 100644
--- a/skills/hallmark/references/components/h4-stat-led.md
+++ b/skills/hallmark/references/components/h4-stat-led.md
@@ -12,7 +12,7 @@ One number the user gave is the hero, with its unit, one line saying what it mea
```
```css
.hero-stat { min-height: 80dvh; display: grid; align-content: center; gap: var(--space-md); padding: var(--space-2xl) var(--gutter); }
-.hero-stat__figure { margin: 0; font-family: var(--font-display); font-size: clamp(6rem, 16vw, 14rem); line-height: 0.9; letter-spacing: -0.03em; font-variant-numeric: tabular-nums; }
+.hero-stat__figure { margin: 0; font-family: var(--font-display); font-size: clamp(6rem, 16vw, 14rem); line-height: 0.9; letter-spacing: var(--tracking-display); font-variant-numeric: tabular-nums; }
.hero-stat__unit { font-size: 0.5em; }
.hero-stat__line { margin: 0; max-width: 45ch; }
```
diff --git a/skills/hallmark/references/components/n2-floating-chip.md b/skills/hallmark/references/components/n2-floating-chip.md
index 553ed6b..53068b5 100644
--- a/skills/hallmark/references/components/n2-floating-chip.md
+++ b/skills/hallmark/references/components/n2-floating-chip.md
@@ -10,7 +10,7 @@ A small fixed chip in a corner: wordmark and one verb ("Try it"). Out of documen
</aside>
```
```css
-.nav-chip { position: fixed; top: var(--space-md); right: var(--space-md); z-index: var(--z-sticky-nav); display: inline-flex; align-items: center; gap: var(--space-md); padding: var(--space-xs) var(--space-sm); background: var(--color-paper); border: var(--rule-hair) solid var(--color-rule); border-radius: var(--radius-card); }
+.nav-chip { position: fixed; top: var(--space-md); right: max(var(--space-md), calc(50% - var(--container) / 2 + var(--gutter))); z-index: var(--z-sticky-nav); display: inline-flex; align-items: center; gap: var(--space-md); padding: var(--space-xs) var(--space-sm); background: var(--color-paper); border: var(--rule-hair) solid var(--color-rule); border-radius: var(--radius-card); }
```
## Knobs
diff --git a/skills/hallmark/references/craft.md b/skills/hallmark/references/craft.md
index 33484bc..5b7ece8 100644
--- a/skills/hallmark/references/craft.md
+++ b/skills/hallmark/references/craft.md
@@ -106,7 +106,7 @@ The reflex is a small caps label above the heading, and the reflex is the tell (
3. **A lead-in inside the paragraph**, in a heavier weight, never on its own line.
4. **A drop cap.** One per page, first paragraph only.
5. **A rule that does more than rule**: hairline, fleuron, double rule, colour edge, or pure gap; one divider language down the page, varied in weight and placement from seam to seam (9).
-6. **A numeral at graphic scale** (8 to 18rem), one per page, only when the number is real (an issue, a year, a version, a chapter).
+6. **A numeral at graphic scale**, one per page: a figure the page argues from at `clamp(6rem, 16vw, 14rem)`, a decorative one behind a head to 18rem, only when the number is real (an issue, a year, a version, a chapter).
7. **A real `<ol>`** with `counter()` when the sequence is genuine.
8. **A caption below** the content instead of above it: a plate in a catalogue, not a slide title.
9. **Marginalia** beside the body in the outer margin.
@@ -141,7 +141,7 @@ Four recipes, one per material family:
- **Dark** (atmospheric, night): `linear-gradient(170deg, var(--color-paper-2), var(--color-paper-3))`, a 1px inset ring of ink at 8% alpha; label bottom-right in `--color-muted`. Only a theme whose genre allows blooms adds one radial in the accent at 20% alpha from a corner; a theme that bans radial light keeps the flat step.
- **Print object** (playful, sticker): the accent field with a 2px ink border, a second colour block offset 8px behind it (zero blur, dropped where the theme forbids hard offsets), a dashed kiss-cut line inset 6px; label as a small rotated tag in the corner.
-**Text slots.** A missing fact (a venue, a date, an act, a price) is a text slot, never an invented value: `<span class="fill" data-fill="venue">Venue to be announced</span>`, set in the body face in `--color-muted` on a faint tint of it (`background: color-mix(in oklch, var(--color-muted) 14%, transparent)`, 2px radius, no underline) so it reads as a blank to fill, never as a link, at most three on a page, each listed in the handoff with what belongs there. Text slots do not count toward 68.
+**Text slots.** A missing fact (a venue, a date, an act, a price) is a text slot, never an invented value: `<span class="fill" data-fill="venue">Venue to be announced</span>`, set in the body face in `--color-muted` on a faint tint of it (`background: color-mix(in oklch, var(--color-muted) 14%, transparent)`, 2px radius, no underline) so it reads as a blank to fill, never as a link, at most three on a page, each listed in the handoff with what belongs there. Text slots do not count toward 68. A section the user named but gave nothing for is its heading, one line on what will go there and one text slot, or it merges into a neighbour; never a block of pending rows.
Where slots go: the hero visual on any product page, beside the text; a demo strip of two or three slots with one label of three words or fewer each (this replaces the three-card feature grid); photo slots on business pages. Two to four slots carry a product page; more only when the user has handed over the images. A set of things the page does not have pictures of (a team, a range, a list of venues) is set in type, names and facts in a list or a table, with one slot at most: four empty frames in a row is a wireframe, not a page (68). Inside a slot, sketch the product's own structure from what the brief says it does (rows for a ledger, a waveform for audio, a list for an inbox) in three to five shapes, so the placeholder reads as this product waiting for its screenshot, never as a grey box. Ask for the material once at Step 1; given images go straight in and are named in the Picks block; "leave slots" builds the placeholders and the handoff lists every slot, its size and what belongs there; silence builds from what is real (SKILL.md Step 2), with a slot only where a picture is the point.
diff --git a/skills/hallmark/references/gates.md b/skills/hallmark/references/gates.md
index 2088f75..a9f4ccf 100644
--- a/skills/hallmark/references/gates.md
+++ b/skills/hallmark/references/gates.md
@@ -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 2px · 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.
+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 2px · 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).
## 5. Judged clauses
@@ -205,17 +205,17 @@ 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 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, on a theme build the theme's picture (`references/themes/<slug>.jpg`, a page in the same theme that shipped), 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, on a theme build the theme's picture (`references/themes/<slug>.jpg`, a page in the same theme that shipped), the hero review's findings with how each was settled, 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.
>
> First line: one of `recapture` (a screenshot is missing, blank or shows the wrong thing; list what to recapture and stop), `rebuild` (the first viewport fails the contract or the theme wholesale), `fix` (material findings follow), `ship` (nothing owed).
>
-> Then: findings ranked by cost to the page, each one line with the gate or the plain defect, where it is, what you would do. At most eight. A direction you would not have chosen is not a finding. The theme's picture, if given, is the bar for finish and never a model: is this page as finished as that one, in its own composition? Then one answer to the question no gate can: does the stamp's contract or theme describe the page in front of you? Name the largest gap or say there is none. Close with one line naming what must not be diluted while fixing. Do not fix anything.
+> Then: findings ranked by cost to the page, each one line with the gate or the plain defect, where it is, what you would do. At most eight. A direction you would not have chosen is not a finding, nor is what the theme file refuses (a glow on a theme with none), nor an element the hero review settled unless you name a new reason. The theme's picture, if given, is the bar for finish and never a model: is this page as finished as that one, in its own composition? Then one answer to the question no gate can: does the stamp's contract or theme describe the page in front of you? Name the largest gap or say there is none. Close with one line naming what must not be diluted while fixing. Do not fix anything.
**The hero review** runs the same way, once, at Step 6, before any section below the fold exists. Give the reviewer the four `hero-*` screenshots that `sloplint --render --stage hero` wrote, the stamp's first two lines, the Picks block's Material and Signature rows, and on a theme build the theme's picture. Its brief:
-> 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 (on 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. Do not fix anything.
+> 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 (on 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 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.
diff --git a/skills/hallmark/references/macrostructures/04-stat-led.md b/skills/hallmark/references/macrostructures/04-stat-led.md
index 06086eb..c1c7b36 100644
--- a/skills/hallmark/references/macrostructures/04-stat-led.md
+++ b/skills/hallmark/references/macrostructures/04-stat-led.md
@@ -2,7 +2,7 @@
The hero is a figure the user gave, with the line that says what it means. Everything that follows supports or qualifies it. Data is the narrative.
-- **Heading:** a large numeric display (8 to 12rem, tabular figures) paired with a worded headline. The figure is the biggest element and never the hero's only words: say what it means beside or beneath it as a real headline, not a small label. Read them together: *"Four seconds. From the alert link to the slow span."*
+- **Heading:** a large numeric display at graphic scale (`craft.md` § 7, tabular figures) paired with a worded headline. The figure is the biggest element and never the hero's only words: say what it means beside or beneath it as a real headline, not a small label. Read them together: *"Four seconds. From the alert link to the slow span."*
- **Body:** sections each anchored by a supporting figure or chart.
- **Divider:** hairline rules between figure blocks; `tabular-nums` everywhere.
- **Button:** an outlined chip beneath the qualifier, labelled with a verb ("Read the report").
diff --git a/skills/hallmark/references/macrostructures/13-index-first.md b/skills/hallmark/references/macrostructures/13-index-first.md
index c9f19fc..d360f7f 100644
--- a/skills/hallmark/references/macrostructures/13-index-first.md
+++ b/skills/hallmark/references/macrostructures/13-index-first.md
@@ -11,7 +11,7 @@ The page is a list of links. No hero image, no narrative flow. Navigation as des
Reach for it for documentation hubs, knowledge bases, archive front pages, design-system entries, link pages with substance.
-Avoid for marketing pages. Index-First serves a browsing audience; selling needs structure.
+Avoid for a hard sell (a launch, a checkout). Index-First serves a browsing audience; a personal site that offers its owner's time is fine.
Code: [`../components/ft3-index-style-category-list.md`](../components/ft3-index-style-category-list.md) is the same list at footer scale.
diff --git a/skills/hallmark/references/themes/grid.md b/skills/hallmark/references/themes/grid.md
index 281ee8f..eb0ee45 100644
--- a/skills/hallmark/references/themes/grid.md
+++ b/skills/hallmark/references/themes/grid.md
@@ -41,10 +41,10 @@ One dial, the signal ink, stated in the stamp (`grid: red`). `--color-focus` fol
## Faces
-- **Display:** Archivo 800, lowercase, `clamp(52px, 10.5vw, 136px)`, `--tracking-display`, line-height 0.9, slammed to the left margin and edge-aligned to the rails.
+- **Display:** Archivo 800, lowercase, `clamp(52px, 10.5vw, 136px)`, `--tracking-display`, line-height 0.92, slammed to the left margin and edge-aligned to the rails.
- **Body:** Archivo 400 at 16px, line-height 1.5. One family; discipline comes from weight, scale and tracking, never from a second face.
- **Labels, captions, table heads, meta, folios, units:** Archivo 500 at 13px, sentence case, `--color-muted`. Figures take `tabular-nums` in Archivo; mono appears only on figures that compare, if at all.
-- **The numeral voice:** Archivo 800 numerals at `clamp(120px, 22vw, 320px)` as objects, cropped by the band edge, at 6 to 10% ink, only when the numeral is a real figure (an issue, a year, a chapter) and a caption says which. One per section at most; art, not a heading.
+- **The numeral voice:** Archivo 800 numerals at `clamp(7.5rem, 22vw, 18rem)` as objects, cropped by the band edge, at 6 to 10% ink, only when the numeral is a real figure (an issue, a year, a chapter) and a caption says which. One per page; art, not a heading.
## Material
@@ -57,7 +57,7 @@ One dial, the signal ink, stated in the stamp (`grid: red`). `--color-focus` fol
## Motion
-Grid-snapped, 180 to 200ms ease, no scroll reveals, no parallax. Hover: a row shifts to `--color-paper-2` and its title slides 8px; a mark answers the pointer with a snapped transform (a quarter-disc rotates 90 degrees, a stepped bar extends one track).
+Grid-snapped, 180 to 200ms on `--ease-out`, no scroll reveals, no parallax. Hover: a row shifts to `--color-paper-2` and its title slides 8px; a mark answers the pointer with a snapped transform (a quarter-disc rotates 90 degrees, a stepped bar extends one track).
## Voice
@@ -78,10 +78,10 @@ Rational, institutional: name the system, the place, the year.
```css
.rails { position: absolute; inset: 0; z-index: 0; pointer-events: none; max-width: 1280px; margin-inline: auto;
background-image: repeating-linear-gradient(to right, var(--color-rule) 0 1px, transparent 1px calc(100% / 12)); }
-h1, h2 { font: var(--display-weight) clamp(52px, 10.5vw, 136px)/0.9 var(--font-display); letter-spacing: var(--tracking-display); text-transform: lowercase; }
+h1, h2 { font: var(--display-weight) clamp(52px, 10.5vw, 136px)/0.92 var(--font-display); letter-spacing: var(--tracking-display); text-transform: lowercase; }
.plate { background: var(--color-accent); color: var(--color-accent-ink); position: relative; overflow: clip; }
.plate::before { content: ""; position: absolute; inset: 0; pointer-events: none;
background-image: repeating-linear-gradient(to right, color-mix(in oklab, var(--color-paper) 15%, transparent) 0 1px, transparent 1px calc(100% / 12)); }
-.btn--secondary { border-radius: 0; border: 1px solid var(--color-ink); transition: border-color 180ms ease; } .btn--secondary:hover { border-color: var(--color-accent); }
+.btn--secondary { border-radius: 0; border: 1px solid var(--color-ink); transition: border-color 180ms var(--ease-out); } .btn--secondary:hover { border-color: var(--color-accent); }
::selection { background: var(--color-accent); color: var(--color-accent-ink); }
```
diff --git a/skills/hallmark/scripts/sloplint-render.mjs b/skills/hallmark/scripts/sloplint-render.mjs
index a50cd4f..a3fb6a6 100644
--- a/skills/hallmark/scripts/sloplint-render.mjs
+++ b/skills/hallmark/scripts/sloplint-render.mjs
@@ -20,6 +20,7 @@ async function shoot(page, file, tag, fullPage) {
}
export async function renderCheck(htmlFiles, metaIn) {
+ const failed = [];
const meta = { genre: null, postureByFile: {}, heroPostureByFile: {}, stage: 'page', ...(metaIn || {}) };
const heroOnly = meta.stage === 'hero';
let puppeteer = null;
@@ -89,6 +90,7 @@ export async function renderCheck(htmlFiles, metaIn) {
}
} catch (e) {
console.error(`render tier: failed on ${file}: ${e.message}`);
+ failed.push({ file, message: e.message });
} finally {
await page.close().catch(() => {});
}
@@ -99,12 +101,14 @@ export async function renderCheck(htmlFiles, metaIn) {
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) => {
+ const kept = findings.filter((f) => {
const k = f.gate + '|' + f.evidence.replace(/^\[\d+px\] /, '');
if (seen.has(k)) return false;
seen.add(k);
return true;
});
+ kept.failed = failed;
+ return kept;
}
function observe(checkFold, meta) {
@@ -408,7 +412,19 @@ function observeSpace(atLaptop, heroOnly, heroPosture) {
if (min < 100) push(59, 'REFLEX', `smallest gap between sections is ${min}px (gaps: ${real.join(', ')})`, '120px or more between sections, varied');
else if (real.length > 2 && new Set(real).size === 1) push(59, 'REFLEX', `every section gap is ${min}px`, 'Vary the rhythm: some 120, some 160, some 200');
}
- if (!heroOnly && secs.length > 9) push(59, 'WARN', `${secs.length} sections`, 'Five to eight sections a page; merge or cut');
+ if (!heroOnly && secs.length > 9) push(59, 'WARN', `${secs.length} sections`, 'Four to eight sections a page; merge or cut');
+ if (!heroOnly) {
+ 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();
+ if (t.length < 24) continue;
+ const cs = getComputedStyle(e);
+ const fs = parseFloat(cs.fontSize) || 16;
+ const lh = parseFloat(cs.lineHeight) || fs * 1.4;
+ const r = e.getBoundingClientRect();
+ if (r.width < fs * 8 && r.height / lh >= 3.6) { push('F17', 'WARN', `"${t.slice(0, 28)}" squeezed to ${Math.round(r.width)}px wide over ${Math.round(r.height / lh)} lines (${e.tagName.toLowerCase()}${e.classList[0] ? '.' + e.classList[0] : ''})`, 'A grid placement or a span ran wide; give the text its column back'); break; }
+ }
+ }
if (hero && !/^(poster|ledge)$/.test(heroPosture || '')) {
const hb = abs(hero);
diff --git a/skills/hallmark/scripts/sloplint.mjs b/skills/hallmark/scripts/sloplint.mjs
index dc89309..a667133 100644
--- a/skills/hallmark/scripts/sloplint.mjs
+++ b/skills/hallmark/scripts/sloplint.mjs
@@ -3880,6 +3880,7 @@ if (opts.render) {
DISMISSED = w ? (w.DISMISSED || new Set()) : new Set();
report(f.gate, f.grade === 'REFLEX' ? 'FAIL' : f.grade, f.file, f.line, f.evidence, f.fix);
}
+ for (const x of extra.failed || []) { WAIVED = new Set(); ANSWERED = new Set(); DISMISSED = new Set(); report('render', 'FAIL', x.file, 1, `the render tier crashed on this page (${trunc(x.message, 60)}); its gates did not run`, 'Fix the page error, or rerun; a crashed render is never a pass'); }
} catch (e) {
console.error(`render tier unavailable (${e.message}); static checks only`);
}
diff --git a/skills/hallmark/scripts/theme.mjs b/skills/hallmark/scripts/theme.mjs
index 65c4e2d..a74e7dc 100644
--- a/skills/hallmark/scripts/theme.mjs
+++ b/skills/hallmark/scripts/theme.mjs
@@ -1,5 +1,5 @@
#!/usr/bin/env node
-import { readFileSync, writeFileSync, readdirSync, existsSync, mkdirSync } from 'node:fs';
+import { readFileSync, writeFileSync, readdirSync, existsSync, mkdirSync, renameSync } from 'node:fs';
import { join, dirname, basename, resolve } from 'node:path';
import { fileURLToPath } from 'node:url';
import { createHash } from 'node:crypto';
@@ -19,6 +19,7 @@ function usage() {
node theme.mjs scaffold <slug> [--dealt "<n>/3, seed <seed>"] [--dir .] [--force]
node theme.mjs scaffold --custom [--dir .] [--force]
node theme.mjs check --axes "<paper>/<display>/<accent>" [--face "<display face>"] [--hue <accent hue>] [--log .hallmark/log.json]
+ node theme.mjs log --entry '<one JSON object>' [--log .hallmark/log.json]
node theme.mjs index
node theme.mjs list
node theme.mjs validate <files...>`);
@@ -66,6 +67,19 @@ function loadIndex() {
return JSON.parse(readFileSync(INDEX, 'utf8')).themes;
}
+function addLog() {
+ const file = resolve(flag('log', '.hallmark/log.json'));
+ let entry;
+ try { entry = JSON.parse(flag('entry', '')); } catch { entry = null; }
+ if (!entry || Array.isArray(entry) || typeof entry !== 'object') { console.error('--entry takes one JSON object, the build\'s log entry'); process.exit(2); }
+ const next = [entry, ...readLog(file)].slice(0, 20);
+ mkdirSync(dirname(file), { recursive: true });
+ const tmp = `${file}.${process.pid}.tmp`;
+ writeFileSync(tmp, JSON.stringify(next, null, 1) + '\n');
+ renameSync(tmp, file);
+ console.log(`logged ${entry.shape || '?'} in ${entry.theme || '?'} at the top of ${file} (${next.length} of 20)`);
+}
+
function readLog(p) {
if (!p || !existsSync(p)) return [];
try { const j = JSON.parse(readFileSync(p, 'utf8')); return Array.isArray(j) ? j : (j.runs || []); } catch { return []; }
@@ -313,6 +327,7 @@ try {
if (cmd === 'deal') deal();
else if (cmd === 'check') check();
else if (cmd === 'scaffold') scaffold();
+ else if (cmd === 'log') addLog();
else if (cmd === 'index') { const e = buildIndex(); console.log(`indexed ${e.length} themes into ${INDEX}`); }
else if (cmd === 'list') list();
else if (cmd === 'validate') {