Skip to content

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

CSS

The hero ships before the page, and the page is built from what is real

Youssef0253500f7b5d
diff --git a/skills/hallmark/SKILL.md b/skills/hallmark/SKILL.md
index 8b98ec7..54f4fea 100644
--- a/skills/hallmark/SKILL.md
+++ b/skills/hallmark/SKILL.md
@@ -56,9 +56,9 @@ Output one block with file:line citations, what Hallmark preserves and what it i
One message, even on a five-word brief:
-> *Before I build, four things: 1. **Audience**: who uses this and what do they care about? 2. **Use**: the one action the page should drive. 3. **Tone**: pick an extreme (editorial · brutalist · soft · utilitarian · luxury · playful · technical · austere); "clean and modern" is not a tone. 4. **Material**: screenshots, product photos or a logo to build around? Paste them, give paths, or say "leave slots". Plus the brand's vibe in 4 to 8 words and an anchor colour if you have one. Or say **go ahead** and I will infer and tell you what I picked.*
+> *Before I build, four things. 1. **Material**, the one that matters most: what can the page show? Screenshots or a screen recording, product photos, real numbers (customers, uptime, prices), a quote someone said with their name, logos you may use. Paste them, give paths, or say "leave slots"; I never invent any of it. 2. **Audience**: who uses this and what do they care about? 3. **Use**: the one action the page should drive. 4. **Tone**: pick an extreme (editorial · brutalist · soft · utilitarian · luxury · playful · technical · austere); "clean and modern" is not a tone. Plus the vibe in 4 to 8 words and an anchor colour if you have one. Or say **go ahead** and I will infer and tell you what I picked.*
-Skipped fields are opt-outs: infer them, state the inferences in one line at the top of the reply, stamp them. No follow-up ladders.
+Skipped fields are opt-outs: infer them, state the inferences in one line at the top of the reply, stamp them. No follow-up ladders. Material is never inferred: what was not given is a slot or is absent.
**Genre** is picked here, silently, from the brief: *AI tool, generative, music, video, voice, dark, atmospheric* → **atmospheric**; *SaaS, enterprise, API, platform, developer tool, infra, B2B* → **modern-minimal**; *fun, consumer, casual, family, community, onboarding* → **playful**; otherwise **editorial**. Two non-default signals: ask one either-or.
@@ -66,11 +66,13 @@ Skipped fields are opt-outs: infer them, state the inferences in one line at the
### 2. Shape
+**Material first.** Before the shape, write the inventory in one line: *real* (every concrete thing the brief and the project supply: the name, the claim, numbers, places, dates, inputs and outputs, images), *slots* (what the user will hand over later), *absent* (every proof the page will not have: logos, quotes, metrics nobody gave). The shape follows it: shapes built on screenshots (Bento, Workbench, Feature Stack) need two real visuals or the user's "leave slots"; with neither, choose a shape that carries type and facts (Long Document, Letter, Index-First, Manifesto, a spec sheet). Pages read as generated when they have nothing to show and pretend otherwise.
+
Decide the page's shape, how it opens, how sections separate, what the nav and footer do, how tall the hero stands and what carries it. You are designing, not filling a form. The catalogs exist for when you want a starting point: 21 page shapes in [`references/macrostructures.md`](references/macrostructures.md), navs, footers and section archetypes in [`references/component-cookbook.md`](references/component-cookbook.md), enrichment in [`references/hero-enrichment.md`](references/hero-enrichment.md). Take a named shape and load only that one file; never read a whole catalog.
**Rotation.** Read `.hallmark/log.json` (newest first). The page's shape must differ from the last three builds; the nav and footer must not repeat the last three shapes; the hero posture, enrichment and section opening must not repeat the previous run. The theme deal in Step 3 handles the theme axis for you. **The mirror test:** would this exact combination have come out for a neighbouring brief in the same category? If yes, change one decision and say which in the Picks block.
-**Signature.** Every page has one move a visitor would describe to a friend: an object, a composition, an interaction. Decide it here; it goes in the Picks block and the stamp, and the reviewer checks it is on the page. A page without one is a template with good tokens.
+**Signature.** Every page has one move a visitor would describe to a friend: an object, a composition, an interaction, built from the inventory's strongest real thing. Decide it here; it goes in the Picks block and the stamp, and the reviewer checks it is on the page. A page without one is a template with good tokens.
Decide all of this and hold it. It is said once, at Step 5.
@@ -94,7 +96,7 @@ A catalog theme is a material, not a plan: it says what the page is made of, nev
Exactly these, for a page build: [`references/craft.md`](references/craft.md) (type, colour, layout, motion, copy, section openings, demo slots, hero discipline, finish) · `references/genres/<genre>.md` · `references/themes/<slug>.md` (or `direction.md` on a custom run) · [`references/gates.md`](references/gates.md) § 1 to § 4.
-Only when the build needs them: one macrostructure file and the picked archetype files (Step 2) · [`references/hero-enrichment.md`](references/hero-enrichment.md) then one `enrichment/` file, only when the image-need check says yes · [`references/microinteractions.md`](references/microinteractions.md) when the page has stateful UI · [`references/interaction-and-states.md`](references/interaction-and-states.md) for forms · [`references/responsive.md`](references/responsive.md) when a layout is unusual · [`references/texture.md`](references/texture.md) when the theme earns texture · [`references/scroll-choreography.md`](references/scroll-choreography.md) for a scroll story · [`references/dark-mode.md`](references/dark-mode.md) when both modes are asked for · [`references/data-viz.md`](references/data-viz.md) for charts · [`references/fonts.md`](references/fonts.md) only on custom or studied runs (a theme already named its faces) · [`references/assets.md`](references/assets.md) and [`references/imagery-kit.md`](references/imagery-kit.md) only when an enrichment needs an external asset · [`references/comp.md`](references/comp.md) only on signal 9 · [`references/design-md.md`](references/design-md.md) only when asked to lock the system.
+Only when the build needs them, each in `references/`: one macrostructure file and the picked archetype files (Step 2) · `hero-enrichment.md` then one `enrichment/` file, when the image-need check says yes · `microinteractions.md` for stateful UI · `interaction-and-states.md` for forms · `responsive.md` for an unusual layout · `texture.md` when the theme earns texture · `scroll-choreography.md` for a scroll story · `dark-mode.md` when both modes are asked for · `data-viz.md` for charts · `fonts.md` on custom or studied runs · `assets.md` and `imagery-kit.md` when an enrichment needs an external asset · `comp.md` on signal 9 · `design-md.md` when asked to lock the system.
Over-eager loading is the largest avoidable cost of running this skill. `gates.md` § 5 and § 6 are read at Step 7, not before.
@@ -111,7 +113,7 @@ The run's only prose recital of its decisions, and the user's five-second redire
- **Hero** · Stage, visual beside the text (prev Settled) · enrichment: none
- **Signature** · the pricing table is the hero visual, live, in a slot
- **Sections** · Hero · Demo strip · Pricing · FAQ · Footer
-- **Slots** · hero, demo-2, demo-3 (leave slots)
+- **Material** · real: the 2-minute setup, the CSV import, Lisbon · slots: hero, demo-2, demo-3 · absent: logos, quotes, metrics
- **Slop test** · run after build
```
@@ -123,6 +125,8 @@ On signal 9, [`references/comp.md`](references/comp.md) runs here: two comps of
Emit code that satisfies the theme and the shape. Always:
+- **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.
+
- **Start from the scaffold.** `node <skill-dir>/scripts/theme.mjs scaffold <slug>` (`--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 (clipping, focus, reduced motion, browser surfaces, the slot contract) under a stamp skeleton. Paste them, fill the stamp, and write only the page.
- **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). Five to eight sections, footer included. 250 to 450 visible words on the page.
- **Show, do not describe.** At least two `data-slot` containers on a product page: the hero visual and a demo strip. 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.
@@ -158,10 +162,11 @@ Dark mode and `design.md` are opt-in: only an explicit ask loads their files.
### 7. Sweep
-1. `node <skill-dir>/scripts/sloplint.mjs <files> --genre <genre> --render` (add `--scope component` on a component). Fix every FAIL, re-run until clean. The render tier writes the screenshots you need next; do not run Chrome by hand.
+1. `node <skill-dir>/scripts/sloplint.mjs <files> --genre <genre> --render` (add `--scope component` on a component; in a framework project with a dev server running, add `--url http://localhost:<port>/<route>`). Fix every FAIL, re-run until clean. The render tier writes the screenshots you need next; do not run Chrome by hand.
2. Load [`references/gates.md`](references/gates.md) § 5 and walk the J and R/J gates. Confirm or dismiss every WARN. Fix every open Floor finding; fix or waive every Reflex one; answer every Finish one.
3. Review in fresh context per `gates.md` § 6: a subagent with the artifact, the screenshots, the stamp's theme or contract, and the gate table. Act on its first word (`recapture`, `rebuild`, `fix`, `ship`). Two rounds is the ceiling.
-4. Update the Picks block's last row with the real outcome (`Floor 0 FAIL · Reflex 2 (1 waived: 47b) · finish-review: subagent, 3 resolved`). A fabricated pass is itself slop.
+4. Close with the material ask: every slot, its size and what belongs there, then the one piece of material that would most improve the page ("two screenshots of the import screen would replace both demo placeholders").
+5. Update the Picks block's last row with the real outcome (`Floor 0 FAIL · Reflex 2 (1 waived: 47b) · finish-review: subagent, 3 resolved`). A fabricated pass is itself slop.
Verification is budgeted: one batched inspection, one fix batch, at most one confirming round, then stop polishing. Endless single-issue re-render loops are their own failure mode.
diff --git a/skills/hallmark/references/flow.md b/skills/hallmark/references/flow.md
index be2d874..292b0ff 100644
--- a/skills/hallmark/references/flow.md
+++ b/skills/hallmark/references/flow.md
@@ -88,6 +88,10 @@ Codex: batch a page's files into one patch so a dev server reloads once; never s
**Rules that survive every harness:** if you have restated the plan twice, stop narrating and build; never write a gate count you did not verify; if a referenced file fails to load, proceed on the Floor and say which file was unavailable; no parallel tool calls unless the harness reliably supports them; when a step names a tool the harness lacks, do the intent with what you have, the tool is optional and the check is not; long sessions compact, so the stamp and `.hallmark/log.json` are the durable memory, re-read them instead of re-deriving.
+## Framework projects
+
+A Next.js, Astro, SvelteKit or Vite project renders through its dev server, not from a file: start it, then point the render tier at the route, `sloplint <changed css and markup files> --render --url http://localhost:<port>/<route>` (and `--stage hero` for the hero review). The static tier reads the stylesheets and the component markup it is given; the render tier reads the page the browser builds. Without a running server, say so and run the static tier alone.
+
## Output contract
Tokens in one place (`:root` or `tokens.css`), named by role (`--color-ink`, never `--color-black`). Tailwind projects extend the theme rather than inlining arbitrary values. Framework projects follow the framework's file conventions. The stamp block sits at the top of the stylesheet; beyond it no comments are needed. Hallmark is a taste skill: it does not invent copy, pick a brand identity, enforce a style the user did not commit to, or build logic; asked to wire an auth flow, it does the work and applies Hallmark to the rendered surface.
diff --git a/skills/hallmark/references/gates.md b/skills/hallmark/references/gates.md
index 597b19c..4bcffab 100644
--- a/skills/hallmark/references/gates.md
+++ b/skills/hallmark/references/gates.md
@@ -11,7 +11,7 @@ Every gate carries a **tier**, which says whether you may disagree with it:
- **Finish.** Craft detail, invisible at arm's length. Reported, answered, never blocks a ship. These are the F-checks.
- **Ledger.** Bookkeeping about repetition (32). Reports at `NOTE`, never counts toward the verdict.
-**Class** says who can check it: **M** mechanical (sloplint), **M/R** static half plus the render tier (`--render`, on by default when Chrome exists), **R/J** render or judge, **J** judged at Step 7 by the model. When sloplint has run, walk only the J and R/J gates plus the judged halves of M/R gates; re-litigating what the script passed is wasted judgement.
+**Class** says who can check it: **M** mechanical (sloplint), **M/R** static half plus the render tier (`--render`, which SKILL.md runs at the hero stage and at Step 7; `--url` renders a running dev server), **R/J** render or judge, **J** judged at Step 7 by the model. When sloplint has run, walk only the J and R/J gates plus the judged halves of M/R gates; re-litigating what the script passed is wasted judgement.
**Grades:** `FAIL` (Floor, nothing ships) · `REFLEX` (unanswered Reflex, fix or waive) · `WAIVED` (guard satisfied, visible) · `WARN` (suspected, confirm or dismiss) · `ANSWERED` (Finish finding with a recorded reason) · `NOTE` (bookkeeping). `FAIL` and `REFLEX` report separately so "0 FAIL" stays a true statement about the Floor.
@@ -204,6 +204,12 @@ The thread that built the page is its weakest reviewer. Spawn a reviewer with no
>
> 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. 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, and the Picks block's Material and Signature rows. 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; does anything read as a template (a centred stack, a pill or label above the headline, a gradient blob, a drawn dashboard, two buttons where one would do); is the signature move on this screen; does the type carry the theme at this size. Do not fix anything.
+
+Fix, recapture with `--stage hero`, and build the sections once the answer is `ship`. Record `hero-review: ship after 1 fix` in the stamp's finish-review field.
+
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`.
**Nothing ships with an open `FAIL` or an open `REFLEX`.** A Floor finding is fixed; a Reflex finding is fixed or waived; a Finish finding is read and answered.
diff --git a/skills/hallmark/references/macrostructures.md b/skills/hallmark/references/macrostructures.md
index 37685f4..1950fb3 100644
--- a/skills/hallmark/references/macrostructures.md
+++ b/skills/hallmark/references/macrostructures.md
@@ -68,6 +68,7 @@ For non-SaaS work (Editorial, Manifesto, Letter, Long Document, Quote-Led) this
## How to pick
+0. **Read the material inventory** (SKILL.md Step 2). A shape built on screenshots or figures needs them, real or as slots the user asked for; with neither, pick a shape that carries type and facts.
1. **Read the brief.** Note any words that strongly signal one shape ("data heavy", "tell a story", "a list of links", "many small features", "personal note").
2. **Read `.hallmark/log.json`** (newest first) and the `shape:` field of any Hallmark stamp in the project; the last three shapes are excluded.
3. **Match the brief to a shape** using the "Reach for it" lines. Most briefs match two to four; pick the one most distant from the logged shapes, and check the mirror test in SKILL.md Step 2.
diff --git a/skills/hallmark/references/themes/aurora.md b/skills/hallmark/references/themes/aurora.md
deleted file mode 100644
index 7ff40fe..0000000
--- a/skills/hallmark/references/themes/aurora.md
+++ /dev/null
@@ -1,79 +0,0 @@
----
-name: Aurora
-slug: aurora
-genre: atmospheric
-paper: dark 11 200
-display: geometric-sans Sora
-accent: chromatic-teal 172
-posture: committed
-keywords: dev tool, ai tool, generative, model, playground, render, pipeline, observability, deploy, ship, dark mode, after-hours, late-night, nocturnal, moody, aurora, northern lights, blue-green, cold
-material: near-black cyan-tilted ground, two cold blooms, weighty Sora over a Sentient serif body, one teal-green signal
-signature: cyan and teal-green blooms overlapping across the ground like a curtain, a serif paragraph reading warm inside the cold
----
-
-# Aurora
-
-A near-black ground tilted to cyan under two fixed cold blooms, cyan top-right and teal-green bottom-left, Sora 600 heads over a Sentient body, one teal-green signal. The signature is the two blooms overlapping like a curtain with a serif paragraph inside the cold.
-
-## Tokens
-
-```css
-:root {
- --color-paper: oklch(11% 0.025 200); --color-paper-2: oklch(15% 0.028 200); --color-paper-3: oklch(18% 0.030 200);
- --color-ink: oklch(96% 0.010 200); --color-ink-2: oklch(82% 0.012 200); --color-muted: oklch(64% 0.015 200);
- --color-rule: oklch(28% 0.022 200);
- --color-accent: oklch(68% 0.145 172); --color-accent-2: oklch(72% 0.170 200);
- --color-accent-ink: oklch(11% 0.025 200); --color-focus: oklch(75% 0.150 172);
- --font-display: "Sora", system-ui, sans-serif; --font-body: "Sentient", Georgia, serif;
- --font-outlier: "Geist Mono", ui-monospace, monospace;
- --radius-card: 12px; --radius-pill: 999px; --rule-hair: 1px; --shadow-card: 0 8px 24px oklch(4% 0.02 200 / 0.5);
- --tracking-display: -0.035em; --display-weight: 600;
-}
-```
-
-## Faces
-
-- **Display:** Sora 600, `--tracking-display`, up to 5.75rem, roman. Heavy sans against the serif body.
-- **Body:** Sentient 400 and 500, lede and running text both; it warms the cold canvas and is the theme's instant tell. Roman only.
-- **Labels, captions, table heads, meta:** Sentient 500 one step smaller, sentence case, in `--color-muted`. Geist Mono appears only inside code and on figures that compare (a latency column, a token count); it never sets a label or a chip.
-
-## Material
-
-- Two cold blooms and no more, fixed and static: cyan (`--color-accent-2`) top-right, teal-green (`--color-accent`) bottom-left, each 25 to 30% of the viewport at low alpha, overlapping toward the centre so the ground curtains. The whole canvas treatment.
-- Elevated dark surfaces: `--color-paper-2` and `--color-paper-3` seamed by 1px `--color-rule`, depth from the lightness step and `--shadow-card` (offset and blur in the ground's own dark). The blooms are the only light.
-- Soft radii: pill controls, 12px surfaces. The control pair: a teal-green filled pill with `--color-accent-ink` text beside a hairline-outlined pill in ink. The signal stays under 5% of any viewport: that button, a link hover, one status chip.
-- The object family is the console panel: an elevated surface with a hairline head row, a status chip and a serif paragraph inside it. Generous void around every panel. No texture.
-
-## Motion
-
-One settle: the lead panel fades in once over 400ms ease-out. Hover grows a teal-green underline on a link, lifts a panel 2px with its shadow deepening. The blooms never animate; no slide, no bounce, no parallax.
-
-## Voice
-
-Cool, dev-fluent, warmed by the serif: name the command, the model, the number.
-
-## Do-nots
-
-- Never one azure bloom at hue 250; Aurora is two blooms and greener, 172 and 200.
-- Never a warm accent; the light here is cold.
-- Never an all-sans body; running text is the serif.
-- Never a thin display; Sora 600, never 300.
-- Never a rainbow curtain, and never a built apparatus as the focal object; the canvas is ambient.
-
-## Build hint
-
-```html
-<link href="https://fonts.googleapis.com/css2?family=Sora:wght@400;600;700&family=Geist+Mono:wght@400;500&display=swap" rel="stylesheet">
-<link href="https://api.fontshare.com/v2/css?f[]=sentient@400,500&display=swap" rel="stylesheet">
-```
-
-```css
-body { background: var(--color-paper); color: var(--color-ink-2); font-family: var(--font-body); }
-body::before { content: ""; position: fixed; inset: 0; z-index: -1; pointer-events: none;
- background: radial-gradient(38% 32% at 82% 12%, oklch(72% 0.17 200 / 0.20), transparent 70%),
- radial-gradient(40% 34% at 12% 92%, oklch(68% 0.145 172 / 0.16), transparent 72%); }
-.display { font: var(--display-weight) clamp(3rem, 6vw + 1rem, 5.75rem)/1.05 var(--font-display); letter-spacing: var(--tracking-display); color: var(--color-ink); }
-.panel { background: var(--color-paper-2); border: var(--rule-hair) solid var(--color-rule); border-radius: var(--radius-card); box-shadow: var(--shadow-card); }
-.btn--primary { background: var(--color-accent); color: var(--color-accent-ink); border-radius: var(--radius-pill); }
-::selection { background: oklch(68% 0.145 172 / 0.35); }
-```
diff --git a/skills/hallmark/references/themes/broadcast.md b/skills/hallmark/references/themes/broadcast.md
deleted file mode 100644
index fa35bdc..0000000
--- a/skills/hallmark/references/themes/broadcast.md
+++ /dev/null
@@ -1,84 +0,0 @@
----
-name: Broadcast
-slug: broadcast
-genre: editorial
-paper: mid 70 260
-display: display-heavy Dela Gothic One
-accent: warm 27
-posture: full-palette
-keywords: video, production, film crew, studio, live, streaming, podcast, tv, television, showreel, reel, post-production, event coverage, camera, cinematography, editing, media, news, channel, documentary
-material: standard-grey ground under faint scanlines, wide heavy capitals, a black slate bar with a timecode, colour bars and a pluge strip, safe-area corner marks, a red tally and green on-screen text
-signature: the black slate running the width of the page with a timecode, over a capture framed by four corner marks
----
-
-# Broadcast
-
-A standard-grey ground under faint scanlines, Dela Gothic One capitals, a black slate bar with a timecode in Azeret Mono, colour bars as a divider and a red tally that means recording. The signature is the slate with its timecode over a real capture framed by four corner marks.
-
-## Tokens
-
-```css
-:root {
- --color-paper: oklch(70% 0.005 260); --color-paper-2: oklch(64% 0.005 260); --color-paper-3: oklch(20% 0.006 260);
- --color-ink: oklch(14% 0.006 260); --color-ink-2: oklch(24% 0.006 260); --color-muted: oklch(26% 0.006 260);
- --color-rule: oklch(14% 0.006 260); --color-white: oklch(98% 0.005 260); --color-screen: oklch(6% 0.005 260);
- --color-accent: oklch(63% 0.25 27); --color-accent-2: oklch(86% 0.24 142); --color-accent-ink: oklch(14% 0.006 260); --color-focus: oklch(86% 0.24 142);
- --font-display: "Dela Gothic One", Impact, sans-serif; --font-body: "Sofia Sans", ui-sans-serif, sans-serif;
- --font-outlier: "Azeret Mono", ui-monospace, monospace;
- --radius-card: 0; --radius-pill: 4px; --rule-hair: 1px; --rule-bar: 2px; --shadow-card: none;
- --tracking-display: -0.005em; --scan: 0.18;
-}
-```
-
-Three levels, stated in the stamp (`broadcast: grey`). The tally red and the bars never change. Text on `--color-paper-3` and on a screen is `--color-white`.
-
-| Level | Ground, ink, on-screen text |
-| --- | --- |
-| **standard grey** (default) | the tokens above |
-| **black level** | ground `oklch(12% 0.006 260)`, ink `oklch(96% 0.005 260)`, muted `oklch(68% 0.008 260)`, rule `oklch(30% 0.008 260)`; scanlines at 0.22 |
-| **tungsten** | ground `oklch(90% 0.035 80)`, plate `oklch(25% 0.035 50)`, ink `oklch(20% 0.03 50)`, muted `oklch(42% 0.04 55)`, on-screen text amber `oklch(80% 0.16 75)`; scanlines at 0.12 |
-
-## Faces
-
-- **Display:** Dela Gothic One 400 uppercase, line-height 0.98, `--tracking-display`, roman. The outlined head (a 2px text stroke, no fill) is the second style, always a whole line, never one word.
-- **Body:** Sofia Sans 400 and 500 at 15.5px; subheads 500 at 19px.
-- **Labels, captions, table heads, meta:** Sofia Sans 500 one step smaller, sentence case. Azeret Mono is the readout: the timecode (tabular, `00:00:00:00`), the slate's fields, the on-screen tag, channel numbers and code.
-
-## Material
-
-- Scanlines once, fixed, over the page at `--scan`: a 1px dark line every 3px. No grille, no vignette, no bloom.
-- Rules are `--rule-bar` in ink; radius 0; no shadows; surfaces are flat panels of ground, plate or screen. A screen is `--color-screen` with nothing over its picture but the tag and the marks.
-- The slate: a 46px bar in ink with white readouts (a wordmark in the display face, then scene, take, timecode). Corner marks: four 22px L-shapes in `--rule-bar` strokes, 18px in from the edges of a real capture; one frame, real content inside, never around a drawn screen.
-- Colour bars: seven equal columns in the standard order at 75% with the pluge strip below, full width, once, as a divider or a placeholder's ground.
-- The control pair: an ink-filled primary with ground-coloured text beside a `--rule-bar` outlined ghost, both Sofia Sans 600 uppercase, untracked, following the display's capitals; the third control is the tally, an accent fill with a 10px dot that means recording.
-
-## Motion
-
-Cut, never dissolved. State changes swap in one frame; a timecode counts in frames while a screen plays; the tally blinks at 1s `steps(1)` only while live.
-
-## Voice
-
-Call-sheet plain: the day, the crew, the rate, the frame count. Verbs from the floor: roll, cut, book.
-
-## Do-nots
-
-- Never bars behind text or split up as card accents; they are one strip.
-- Never a soft shadow, a radius or a gradient on a panel; panels are cut.
-- Never the tally red as a heading or link colour; red means recording.
-
-## Build hint
-
-```html
-<link href="https://fonts.googleapis.com/css2?family=Dela+Gothic+One&family=Sofia+Sans:wght@400;500;600&family=Azeret+Mono:wght@400;500&display=swap" rel="stylesheet">
-```
-
-```css
-body::after { content: ""; position: fixed; inset: 0; z-index: 6; pointer-events: none; opacity: var(--scan); background: repeating-linear-gradient(0deg, oklch(6% 0.005 260 / 0.35) 0 1px, transparent 1px 3px); }
-.display { font-family: var(--font-display); text-transform: uppercase; line-height: 0.98; letter-spacing: var(--tracking-display); }
-.slate { display: grid; grid-template-columns: auto 1fr auto auto; height: 46px; background: var(--color-ink); color: var(--color-white); font-family: var(--font-outlier); font-size: 12.5px; font-variant-numeric: tabular-nums; }
-.bars { display: grid; grid-template-columns: repeat(7, 1fr); }
-.bars i:nth-child(1) { background: oklch(81% 0.005 260); } .bars i:nth-child(2) { background: oklch(78% 0.17 110); } .bars i:nth-child(3) { background: oklch(73% 0.125 195); } .bars i:nth-child(4) { background: oklch(70% 0.24 142); }
-.bars i:nth-child(5) { background: oklch(57% 0.26 328); } .bars i:nth-child(6) { background: oklch(51% 0.21 29); } .bars i:nth-child(7) { background: oklch(37% 0.25 264); }
-.btn { font-family: var(--font-body); font-weight: 600; font-size: 13px; text-transform: uppercase; padding: 14px 20px; background: var(--color-ink); color: var(--color-paper); border: var(--rule-bar) solid var(--color-ink); }
-::selection { background: oklch(63% 0.25 27 / 0.3); }
-```
diff --git a/skills/hallmark/references/themes/canvas.md b/skills/hallmark/references/themes/canvas.md
deleted file mode 100644
index 9710835..0000000
--- a/skills/hallmark/references/themes/canvas.md
+++ /dev/null
@@ -1,91 +0,0 @@
----
-name: Canvas
-slug: canvas
-genre: playful
-paper: light 99.5 90
-display: grotesk-sans Instrument Sans
-accent: chromatic-yellow 92
-posture: full-palette
-keywords: family, household, meal planning, planner, week, kids, home, shared, chores, recipes, shopping list, calendar, education, school, playful, fridge, pastel, sticker
-material: a white fridge door, three pastels (butter, sky, blush) each inside a 1.5px ink border, Instrument Sans 700, panes and stickers
-signature: a pane with a pastel head band, and a die-cut sticker with a white ring outside its ink border
----
-
-# Canvas
-
-A white fridge door, three pastels (butter, sky, blush) each inside a 1.5px ink border, Instrument Sans 700 heads, panes and stickers. The signature is a pane with a pastel head band beside a die-cut sticker with a white ring outside its ink border.
-
-## Tokens
-
-```css
-:root {
- --color-paper: oklch(99.5% 0.005 90); --color-paper-2: oklch(97.5% 0.005 90); --color-paper-3: oklch(94% 0.006 90);
- --color-ink: oklch(22% 0.006 260); --color-ink-2: oklch(34% 0.008 260); --color-muted: oklch(48% 0.008 260);
- --color-rule: oklch(90% 0.005 260);
- --color-accent: oklch(94% 0.10 92); --color-accent-ink: oklch(22% 0.006 260); --color-focus: oklch(60% 0.12 250);
- --color-sky: oklch(88% 0.07 250); --color-blush: oklch(88% 0.07 20);
- --color-person-1: oklch(70% 0.14 40); --color-person-2: oklch(60% 0.12 250); --color-person-3: oklch(65% 0.12 150);
- --font-display: "Instrument Sans", ui-sans-serif, system-ui, sans-serif; --font-body: var(--font-display);
- --font-outlier: "IBM Plex Mono", ui-monospace, monospace;
- --radius-card: 16px; --radius-pill: 999px; --rule-hair: 1px; --border-ink: 1.5px;
- --shadow-card: none;
- --tracking-display: -0.035em; --display-weight: 700;
-}
-```
-
-Three colourways, stated in the stamp (`canvas: white`); the pastel that becomes the ground goes near-white.
-
-| Colourway | Ground | Highlight |
-| --- | --- | --- |
-| `white` (default) | the block above | butter |
-| `sky` | `oklch(89% 0.065 250)`, ink `oklch(26% 0.06 260)`, rules `oklch(80% 0.07 250)` | butter; sky itself goes to `oklch(96% 0.02 250)` |
-| `butter` | `oklch(94% 0.10 92)`, ink `oklch(24% 0.02 80)`, rules `oklch(84% 0.10 90)` | sky; butter itself goes to `oklch(98% 0.02 92)` |
-
-## Faces
-
-- **Display:** Instrument Sans 700, `--tracking-display`, line-height 1.02, up to 4.25rem. Heads are plain ink, one weight and one colour; the butter goes on a pane's band and a sticker, never on a word in a head.
-- **Body:** Instrument Sans 400 at 15 to 16px, line-height 1.55, in `--color-muted`; chips, stickers and links at 600.
-- **Labels, captions, meta:** Instrument Sans 600 one step smaller, sentence case, untracked. Never mono, never uppercase.
-- **Outlier:** IBM Plex Mono only inside code and on figures that compare (list quantities, a timer's tabular digits).
-
-## Material
-
-- The ink border: 1.5px of `--color-ink` around every block, pane, chip, sticker, tile, button, checkbox and person dot. A pastel rectangle without it is a tint, not a thing.
-- The pane: a 16px rounded box with a pastel head band carrying a name on the left and a count or a time on the right, nothing else on the band. Days, steps, cupboard items and leftovers are panes. A labelled card, never a drawn window.
-- The sticker: a pill with a die-cut edge, a 3px white ring and a hairline ring outside the ink border, a small bordered pastel dot inside. Ingredients, tags and a sticker strip; the strip may tilt each sticker one to three degrees.
-- The meal chip: a 10px rounded pastel box with the cook's dot, draggable, and the only thing with a shadow, only while dragged.
-- People are three saturated dots with a white initial, the only saturated colours on the page. The control pair is an ink-filled primary beside an ink-bordered transparent secondary, both at 12px.
-- Radii: 10 chips, 12 buttons, 14 tiles, 16 panes, 999 stickers. No texture.
-
-## Motion
-
-Handled, not animated. Meals drag between days with native drag and drop and the target day goes butter with a dashed border; stickers pick on tap; a list ticks; a timer ring counts down a second at a time. No reveals, no parallax, no autoplay.
-
-## Voice
-
-The note on the fridge: who is cooking, what is left, what to buy. Short, domestic, a little dry.
-
-## Do-nots
-
-- Never a fourth pastel; butter, sky, blush, and a mint or a lilac makes it a nursery.
-- Never a saturated accent; the people's dots are the only saturated colours.
-- Never a borderless block, and never a shadow at rest.
-- Never a photograph of food; meals are words on chips and ingredients are stickers.
-
-## Build hint
-
-```html
-<link href="https://fonts.googleapis.com/css2?family=Instrument+Sans:wght@400;600;700&family=IBM+Plex+Mono:wght@400;500&display=swap" rel="stylesheet">
-```
-
-```css
-.display { font: 700 var(--text-display)/1.02 var(--font-display); letter-spacing: var(--tracking-display); }
-.pane { border: var(--border-ink) solid var(--color-ink); border-radius: var(--radius-card); background: var(--color-paper-2); overflow: hidden; }
-.pane .band { display: flex; justify-content: space-between; padding: 9px 14px; border-bottom: var(--border-ink) solid var(--color-ink); font-size: 12.5px; font-weight: 600; }
-.band--butter { background: var(--color-accent); } .band--sky { background: var(--color-sky); } .band--blush { background: var(--color-blush); }
-.sticker { display: inline-flex; align-items: center; gap: 8px; padding: 7px 12px 7px 9px; border-radius: var(--radius-pill); border: var(--border-ink) solid var(--color-ink);
- background: var(--color-paper-2); font-weight: 600; box-shadow: 0 0 0 3px var(--color-paper), 0 0 0 4.5px var(--color-rule); }
-.btn { border-radius: 12px; padding: 0.7rem 1.125rem; font-weight: 600; border: var(--border-ink) solid var(--color-ink); background: transparent; }
-.btn--primary { background: var(--color-ink); color: var(--color-paper); }
-::selection { background: var(--color-accent); color: var(--color-accent-ink); }
-```
diff --git a/skills/hallmark/references/themes/ember.md b/skills/hallmark/references/themes/ember.md
deleted file mode 100644
index d3a6c69..0000000
--- a/skills/hallmark/references/themes/ember.md
+++ /dev/null
@@ -1,89 +0,0 @@
----
-name: Ember
-slug: ember
-genre: atmospheric
-paper: dark 17 60
-display: slab-serif Bitter
-accent: warm 45
-posture: committed
-keywords: foundry, forge, furnace, metal, hardware, ceramics, kiln, glass, glassblowing, workshop, fabrication, casting, bakery, oven, heat, industrial, tools, knives, brass, bronze
-material: soot-dark ground, heavy slab heads with light-weight figures, one grained orb of heat, cast plates with inset seams, a heat bar and a tick ruler
-signature: a single molten orb beside the head, with every temperature read off a ruler in the light slab weight
----
-
-# Ember
-
-A soot ground with no wash, Bitter 800 heads with figures in Bitter 300, one grained orb of heat as the page's only light, cast plates with inset seams, a heat bar and a tick ruler. The signature is the molten orb beside the head with every temperature read off a ruler in the light weight.
-
-## Tokens
-
-```css
-:root {
- --color-paper: oklch(17% 0.006 60); --color-paper-2: oklch(21% 0.007 60); --color-paper-3: oklch(25% 0.008 60); --color-paper-0: oklch(13% 0.005 60);
- --color-ink: oklch(93% 0.01 70); --color-ink-2: oklch(85% 0.01 70); --color-muted: oklch(64% 0.012 65);
- --color-rule: oklch(30% 0.008 60);
- --color-accent: oklch(70% 0.19 45); --color-accent-2: oklch(84% 0.16 70); --color-accent-deep: oklch(40% 0.14 30); --color-accent-ink: oklch(15% 0.02 45);
- --color-focus: oklch(84% 0.16 70);
- --font-display: "Bitter", Georgia, serif; --font-body: "Instrument Sans", ui-sans-serif, sans-serif;
- --font-outlier: "IBM Plex Mono", ui-monospace, monospace;
- --radius-card: 2px; --radius-pill: 2px; --rule-hair: 1px;
- --shadow-card: inset 0 1px 0 oklch(97% 0.01 70 / 0.08), inset 0 -1px 0 oklch(8% 0.01 60 / 0.5), 0 1px 0 oklch(8% 0.01 60 / 0.4);
- --tracking-display: -0.02em;
-}
-```
-
-Three colourways, stated in the stamp (`ember: furnace`).
-
-| Colourway | Ground, ink, heat |
-| --- | --- |
-| **furnace** (default) | the tokens above |
-| **sand** | ground `oklch(94% 0.018 80)`, ink `oklch(20% 0.015 50)`, muted `oklch(47% 0.02 60)`, accent `oklch(60% 0.19 40)`, hot `oklch(50% 0.18 32)`, rule `oklch(80% 0.022 75)` |
-| **blue flame** | ground `oklch(21% 0.025 250)`, ink `oklch(95% 0.01 230)`, muted `oklch(66% 0.02 240)`, accent `oklch(74% 0.14 225)`, hot `oklch(90% 0.1 195)`, rule `oklch(33% 0.025 250)` |
-
-## Faces
-
-- **Display:** Bitter 800, `--tracking-display`, line-height 1.02, roman. Every figure that stands on its own is Bitter 300 in the hot ink: the light weight is the theme's second voice. A head is one weight throughout.
-- **Body:** Instrument Sans 400 and 500 at 16px.
-- **Labels, captions, table heads, meta:** Instrument Sans 500 one step smaller, sentence case. IBM Plex Mono sets the readouts pinned to a diagram (a temperature, a pour time, a batch code), the ruler's values and code.
-
-## Material
-
-- Two fixed blooms, declared here, and no other light: the orb (a radial gradient from a white-hot core through the accent to the ground, with a turbulence overlay at 0.6, texture.md § 1) and one wide radial in the ground behind it at about 25% alpha. Both static, both `aria-hidden`. Buttons, dots, plates and the heat bar carry no glow.
-- Cast plates: `--color-paper-3` surfaces with a 1px highlight seam on top and a 1px dark seam below (the shadow token), 2px radius. Depth is a lightness step, paper-0 under, paper-3 on top.
-- Rules 1px; under a figure that measures, the tick ruler: a 1px line with 1px ticks every 20px.
-- The control pair: an accent-filled primary with `--color-accent-ink` text beside a ghost with a 1px muted border; hover moves the primary to `--color-accent-2`, no shadow.
-- Objects: the orb, the heat bar (9px, a gradient from deep through accent to hot, width by `--t`), the readout (a mono figure on a ground-coloured patch pinned to a diagram). A stamp carries a fact, a date or a frame number, or does not appear.
-
-## Motion
-
-Slow and thermal: the heat bar may fill once on entry over 900ms ease-out; the primary shifts colour over 200ms; the orb never pulses, breathes or drifts.
-
-## Voice
-
-Foundry-plain, figures first: the pour, the alloy, the hour, the temperature. No fire metaphors in copy; the orb does that.
-
-## Do-nots
-
-- Never a glow shadow on a control, a dot, a plate or the bar; the light is the orb.
-- Never Bitter 800 on a figure or a paragraph; figures are 300, prose is the sans.
-- Never a flame, spark or fire illustration, and never a second orb.
-- Never a warm gradient wash across the ground or a spotlight behind the head.
-
-## Build hint
-
-```html
-<link href="https://fonts.googleapis.com/css2?family=Bitter:wght@300;800&family=Instrument+Sans:wght@400;500&family=IBM+Plex+Mono:wght@400;500&display=swap" rel="stylesheet">
-```
-
-```css
-.display { font-family: var(--font-display); font-weight: 800; letter-spacing: var(--tracking-display); line-height: 1.02; }
-.num { font-weight: 300; color: var(--color-accent-2); font-variant-numeric: tabular-nums; }
-.orb { position: relative; border-radius: 50%; aspect-ratio: 1;
- background: radial-gradient(circle at 45% 40%, oklch(97% 0.08 80) 0%, oklch(86% 0.17 65) 14%, var(--color-accent) 34%, oklch(42% 0.14 35) 58%, oklch(22% 0.05 40) 78%, var(--color-paper) 100%); }
-.orb-ground { background: radial-gradient(40% 50% at 70% 50%, oklch(70% 0.19 45 / 0.25), transparent 70%); }
-.plate { background: var(--color-paper-3); border-radius: var(--radius-card); box-shadow: var(--shadow-card); }
-.heat { display: block; height: 9px; width: calc(var(--t) * 100%); background: linear-gradient(90deg, var(--color-accent-deep), var(--color-accent) 65%, var(--color-accent-2)); }
-.btn { background: var(--color-accent); color: var(--color-accent-ink); padding: 14px 20px; border-radius: var(--radius-card); font-weight: 500; }
-.btn--ghost { background: transparent; color: var(--color-ink); border: 1px solid var(--color-muted); }
-::selection { background: oklch(70% 0.19 45 / 0.3); }
-```
diff --git a/skills/hallmark/references/themes/enamel.md b/skills/hallmark/references/themes/enamel.md
deleted file mode 100644
index 8afa273..0000000
--- a/skills/hallmark/references/themes/enamel.md
+++ /dev/null
@@ -1,90 +0,0 @@
----
-name: Enamel
-slug: enamel
-genre: playful
-paper: mid 33 262
-display: grotesk-sans Familjen Grotesk
-accent: neutral 85
-posture: drenched
-keywords: hardware, trade, shop, workshop, tools, ironmonger, brewery, distillery, railway, heritage, counter, ledger, drawers, parts, catalogue, sign, repair, industrial, stock
-material: fired blue enamel on steel, cream keylines twice over, rivets, drawers and number plates, Familjen Grotesk alone
-signature: a double-keylined plate with a rivet in each corner, and one drawer pulled out of the bank
----
-
-# Enamel
-
-Fired blue enamel on steel: a saturated blue ground, cream keylines twice over, a rivet in each corner, drawers with pulls, number plates, Familjen Grotesk alone. The signature is the double-keylined plate with a rivet in each corner and one drawer pulled out of the bank.
-
-## Tokens
-
-```css
-:root {
- --color-paper: oklch(33% 0.09 262); --color-paper-2: oklch(27% 0.08 262); --color-paper-3: oklch(38% 0.09 262);
- --color-ink: oklch(95% 0.012 85); --color-ink-2: oklch(84% 0.04 250); --color-muted: oklch(76% 0.05 250);
- --color-rule: oklch(44% 0.08 262);
- --color-accent: oklch(95% 0.012 85); --color-accent-ink: oklch(27% 0.08 262); --color-focus: oklch(76% 0.05 250);
- --color-damage: oklch(52% 0.15 40); --color-damage-2: oklch(38% 0.12 40);
- --font-display: "Familjen Grotesk", ui-sans-serif, system-ui, sans-serif; --font-body: var(--font-display);
- --font-outlier: "IBM Plex Mono", ui-monospace, monospace;
- --radius-card: 8px; --radius-pill: 3px; --rule-hair: 1px; --rule-bar: 2px;
- --shadow-card: none;
- --tracking-display: -0.02em;
-}
-```
-
-One dial, the colourway, stated in the stamp (`enamel: sign`).
-
-| Colourway | Ground | Key and ink | Note |
-| --- | --- | --- | --- |
-| `sign` (default) | oklch(33% 0.09 262) | cream oklch(95% 0.012 85) | the blue sign; muted oklch(76% 0.05 250) |
-| `bottle` | oklch(36% 0.07 165) | cream oklch(95% 0.02 90) | the green sign; muted oklch(78% 0.05 150) |
-| `cream-plate` | cream oklch(95% 0.012 85) | blue oklch(30% 0.09 262) | the sign reversed: plates, drawers and buttons invert; muted oklch(46% 0.06 262); paper band becomes light |
-
-## Faces
-
-- **Display:** Familjen Grotesk 700, line-height 1.02, `--tracking-display`, roman, sentence case, one weight and one colour per head. Only the wordmark is uppercase, tracked 0.04em.
-- **Body:** Familjen Grotesk 400 and 500, 15 to 17px, line-height 1.5, in `--color-ink-2`. One family; the character comes from the keylines, never a font swap.
-- **Plate text:** Familjen Grotesk 600 at 13 to 14px, sentence case, untracked, for drawer labels and plate titles; captions, table heads and meta are 500, one step smaller, sentence case, in `--color-muted`. Figures are 700 tabular at 16 to 40px for drawer numbers, counts and prices. Mono appears only inside code.
-
-## Material
-
-- The plate: a `--rule-bar` keyline in the key, radius 8, and a second keyline 4px inside it (two inset box-shadows, plate colour then key). Four 10px rivets, key with a plate-coloured centre, one per corner. Every container is a plate; there is no card.
-- The drawer: a plate at radius 6 with a pull, a 30 by 6px rounded bar top right. The one that is out inverts to key, shifts 6px down and left, and shows its hole as a hard offset in the plate colour. In a bank of drawers one is always out.
-- The chip: a rust blob with a darker centre and an irregular radius at the edge of a plate; at most one per plate. Rust is damage, not accent.
-- Rules: `--rule-bar` in key above a section or a list; `--rule-hair` in `--color-rule` between rows; a dashed `--rule-bar` key line for a chain. Flat throughout: no soft shadow, no gradient, no texture, no photograph. The drawer's hard offset is the only depth.
-- The control pair: a key-filled button at radius 3 in plate text beside a `--rule-bar` key outline; a third form is plate text on a `--rule-bar` key underline.
-
-## Motion
-
-A drawer slides out on click over 150ms ease-out and nothing else animates. Everything else is a state: a plate inverts, a search dims the drawers, a year lights. No scroll reveals, no swinging sign.
-
-## Voice
-
-A shopkeeper's: the drawer number, the count, the year, the price. Plain nouns, short lines, a ledger's honesty.
-
-## Do-nots
-
-- Never a second family; a serif on a plate is a pub sign and a mono label is a different shop.
-- Never rust as an accent; a rust button or heading is damage spread over the whole sign.
-- Never a single keyline; one line is a card, the second line 4px inside is the material.
-- Never a radius over 8: plates 8, drawers 6, buttons 3.
-
-## Build hint
-
-```html
-<link href="https://fonts.googleapis.com/css2?family=Familjen+Grotesk:wght@400;500;600;700&display=swap" rel="stylesheet">
-```
-
-```css
-.display { font: 700 var(--text-display)/1.02 var(--font-display); letter-spacing: var(--tracking-display); }
-.plate-text { font-weight: 600; font-size: 13.5px; }
-.plate { position: relative; background: var(--color-paper-2); border: var(--rule-bar) solid var(--color-ink); border-radius: var(--radius-card);
- box-shadow: inset 0 0 0 4px var(--color-paper-2), inset 0 0 0 5px var(--color-ink); }
-.drawer { position: relative; background: var(--color-paper-2); border: var(--rule-bar) solid var(--color-ink); border-radius: 6px; padding: 12px; transition: transform 150ms ease-out; }
-.drawer::after { content: ""; position: absolute; right: 12px; top: 12px; width: 30px; height: 6px; border-radius: 3px; background: var(--color-ink); }
-.drawer.out { background: var(--color-ink); color: var(--color-accent-ink); transform: translate(-6px, 6px);
- box-shadow: 8px -8px 0 var(--color-paper-2), 8px -8px 0 2px var(--color-ink); }
-.btn { background: var(--color-accent); color: var(--color-accent-ink); border-radius: var(--radius-pill); padding: 14px 28px; }
-.btn--secondary { background: transparent; color: var(--color-ink); border: var(--rule-bar) solid var(--color-ink); }
-::selection { background: oklch(76% 0.05 250 / 0.35); }
-```
diff --git a/skills/hallmark/references/themes/prism.md b/skills/hallmark/references/themes/prism.md
deleted file mode 100644
index 8e0ce10..0000000
--- a/skills/hallmark/references/themes/prism.md
+++ /dev/null
@@ -1,92 +0,0 @@
----
-name: Prism
-slug: prism
-genre: modern-minimal
-paper: light 99.6 260
-display: geometric-sans Sora
-accent: cool 268
-posture: committed
-keywords: shipping, logistics, parcel, delivery, api, infrastructure, developer, tracking, payments, fintech, platform, integration, dashboard, live, board, carriers, webhooks, sdk, enterprise
-material: white with every neutral tinted toward cobalt, Sora semi-bold, hairline tables, one tilted aurora panel in cobalt as the page's object
-signature: a rounded panel tilted five to eight degrees carrying three radial pools of cobalt, violet and cyan under grain, beside a flat cobalt button
----
-
-# Prism
-
-White paper with every neutral tinted toward cobalt, Sora 600 tracked tight, data in hairline tables, and one tilted panel where three radial pools of cobalt, violet and cyan sit under grain, beside a flat cobalt button. The panel is a thing on the page, never a wash behind it.
-
-## Tokens
-
-```css
-:root {
- --color-paper: oklch(99.6% 0.002 260); --color-paper-2: oklch(97% 0.008 260); --color-paper-3: oklch(94.5% 0.012 260);
- --color-ink: oklch(22% 0.045 265); --color-ink-2: oklch(32% 0.04 264); --color-muted: oklch(50% 0.030 262);
- --color-rule: oklch(90% 0.012 260);
- --color-accent: oklch(48% 0.20 268); --color-accent-ink: oklch(99.6% 0.002 260); --color-focus: oklch(55% 0.22 268);
- --color-deep: oklch(24% 0.06 265); --color-deep-ink: oklch(96% 0.01 260);
- --color-pool-1: oklch(55% 0.22 268); --color-pool-2: oklch(62% 0.20 320); --color-pool-3: oklch(80% 0.13 205);
- --color-ok: oklch(60% 0.14 160); --color-warn: oklch(66% 0.15 60);
- --font-display: "Sora", ui-sans-serif, system-ui, sans-serif; --font-body: "Geist", ui-sans-serif, system-ui, sans-serif;
- --font-outlier: "JetBrains Mono", ui-monospace, monospace;
- --radius-card: 14px; --radius-pill: 8px; --rule-hair: 1px;
- --shadow-card: 0 24px 60px oklch(22% 0.045 265 / 0.12);
- --tracking-display: -0.035em;
-}
-```
-
-One dial, the colourway, stated in the stamp (`prism: daylight`). The first pool is always the accent's own hue.
-
-| Colourway | Paper | Ink | Accent and pools |
-| --- | --- | --- | --- |
-| `daylight` (default) | the block above | | pools at 268, 320, 205 |
-| `harbour-night` | navy `oklch(19% 0.045 262)` | `oklch(95% 0.010 260)` | ice `oklch(82% 0.11 210)` with the navy as its text; pools at 270, 330, 200 |
-| `sand` | `oklch(96.5% 0.014 80)`, neutrals at hue 78 | `oklch(24% 0.035 50)` | rust `oklch(58% 0.16 42)`; pools at 40, 350, 85 |
-
-## Faces
-
-- **Display:** Sora 600, `--tracking-display`, line-height 1.02, roman; 700 for the wordmark only. One colour per head. Big figures are Sora 600 at 34 to 56px, tabular.
-- **Body:** Geist 400, 16px, line-height 1.55 to 1.6, measure 42 to 46ch, in `--color-muted`.
-- **Labels, captions, table heads, meta:** Geist 500 one step smaller, sentence case, in `--color-muted`. JetBrains Mono only inside code, the deep panel and what a machine produced (ids, figures, an ETA). A word a person wrote is never mono.
-
-## Material
-
-- The aurora panel: three radial pools over a linear base, a fractal-noise layer at 18% in soft-light, radius 18 to 26px, tilted 5 to 8 degrees, once per page. An object with edges: never the page's background, never behind text, never blurred, no glow.
-- Hairline tables: 1px `--color-rule` between rows, right-aligned tabular figures. Never a card per row.
-- The deep panel: code, JSON or an event stream sits on `--color-deep`, with the third pool's hue for keys and a gold for strings.
-- Radii: 8px on controls, 14px on cards, 18px on panels; nothing a pill. A screenshot bleeds off the edge of its slot or sits in a plain 18px plate, never inside a drawn phone bezel.
-- One shadow, under a card over the aurora.
-- The control pair: a flat accent fill with paper text beside a 1px `--color-rule` outline. A 7px status dot in ok, warn or accent states something checkable, never decoration.
-
-## Motion
-
-Operational. Parcels move along lanes at a few pixels a second; an event stream appends a line every 1.4s; a calculator recomputes on input. No reveals, no parallax, and the aurora never animates.
-
-## Voice
-
-Precise, declarative, dated: the id, the hub, the ETA, the rate, each with a date or a unit under it.
-
-## Do-nots
-
-- Never two auroras, and never the aurora as a wash or a hero backdrop.
-- Never a gradient button; the panel is the only place hues mix.
-- Never neutral grey; every neutral carries the hue.
-- Never a card grid of features; features are rows in a table.
-- Never fake data; every figure states its moment in time.
-
-## Build hint
-
-```html
-<link href="https://fonts.googleapis.com/css2?family=Sora:wght@400;500;600;700&family=Geist:wght@400;500;600&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
-```
-
-```css
-.display { font: 600 var(--text-display)/1.02 var(--font-display); letter-spacing: var(--tracking-display); }
-.aurora { position: relative; overflow: hidden; border-radius: 18px; rotate: -6deg; background:
- radial-gradient(60% 70% at 20% 20%, var(--color-pool-1), transparent 70%), radial-gradient(55% 65% at 80% 30%, var(--color-pool-2), transparent 70%),
- radial-gradient(70% 60% at 50% 95%, var(--color-pool-3), transparent 70%), linear-gradient(160deg, var(--color-pool-1), var(--color-pool-2)); }
-.aurora::after { content: ""; position: absolute; inset: 0; opacity: 0.18; mix-blend-mode: soft-light;
- background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='200' height='200'%3E%3Cfilter id='n'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='.9' numOctaves='2'/%3E%3C/filter%3E%3Crect width='200' height='200' filter='url(%23n)'/%3E%3C/svg%3E"); }
-.btn { border-radius: var(--radius-pill); padding: 11px 18px; font-weight: 500; border: 1px solid var(--color-rule); background: var(--color-paper); }
-.btn--primary { background: var(--color-accent); color: var(--color-accent-ink); border-color: var(--color-accent); }
-::selection { background: oklch(48% 0.20 268 / 0.2); }
-```
diff --git a/skills/hallmark/references/themes/stencil.md b/skills/hallmark/references/themes/stencil.md
deleted file mode 100644
index 227f951..0000000
--- a/skills/hallmark/references/themes/stencil.md
+++ /dev/null
@@ -1,91 +0,0 @@
----
-name: Stencil
-slug: stencil
-genre: playful
-paper: dark 15 90
-display: display-condensed Big Shoulders Stencil Display
-accent: chromatic-yellow 90
-posture: committed
-keywords: logistics, freight, shipping, pallet, warehouse, courier, delivery, fleet, cargo, depot, streetwear, merch, drop, workwear, hardware, industrial, utility, tracking, export, crate
-material: crate-black ground, stencilled condensed capitals, hazard yellow, a typed mono body, hazard stripes, a double-ringed stamp and a barcode
-signature: the stencilled head over a hazard stripe, with one stamp struck at a tilt and a barcode at the foot
----
-
-# Stencil
-
-Crate-black paint, Big Shoulders Stencil Display 900 caps with the bridges showing, hazard yellow for the stripe and the fill, an IBM Plex Mono body typed like a manifest, one stamp struck at a tilt and a barcode.
-
-## Tokens
-
-```css
-:root {
- --color-paper: oklch(15% 0.006 90); --color-paper-2: oklch(19% 0.007 90); --color-paper-3: oklch(95% 0.015 90);
- --color-ink: oklch(95% 0.015 90); --color-ink-2: oklch(86% 0.014 90); --color-muted: oklch(70% 0.02 90);
- --color-rule: oklch(30% 0.01 90);
- --color-accent: oklch(84% 0.17 90); --color-accent-ink: oklch(15% 0.006 90); --color-focus: oklch(84% 0.17 90);
- --font-display: "Big Shoulders Stencil Display", Impact, sans-serif; --font-body: "IBM Plex Mono", ui-monospace, monospace;
- --font-outlier: "Allerta Stencil", Impact, sans-serif;
- --radius-card: 0; --radius-pill: 0; --rule-hair: 1px; --rule-bar: 3px; --shadow-card: none;
- --tracking-display: 0.01em;
-}
-```
-
-Three crates, stated in the stamp (`stencil: manifest`). Yellow and black are constant; the paper label plate (`--color-paper-3`, black type on it) flips to black on the paper crate.
-
-| Crate | Ground, ink |
-| --- | --- |
-| **manifest** (default) | the tokens above |
-| **paper** | ground `oklch(95% 0.015 90)`, ink `oklch(15% 0.006 90)`, muted `oklch(45% 0.01 90)`, rule `oklch(80% 0.02 90)` |
-| **hi-vis** | ground `oklch(84% 0.17 90)`, ink `oklch(15% 0.006 90)`, muted `oklch(30% 0.04 90)`, rule `oklch(60% 0.12 90)`; the stripes go black on paper |
-
-## Faces
-
-- **Display:** Big Shoulders Stencil Display 900 uppercase, line-height 0.88, `--tracking-display`; 700 for a subhead. Controls are set in it at 22px.
-- **Stamp face:** Allerta Stencil 400 uppercase tracked 0.04em, only inside the stamp and on crate marks, never a head.
-- **Body and all small type:** IBM Plex Mono 400 at 16px, line-height 1.5; labels, table heads and meta in 500 at 12.5px, sentence case, untracked. Mono is the material here, a typed manifest, so there is no proportional body face (the gate 64 guard).
-
-## Material
-
-- Hazard stripes: a 14px band of `repeating-linear-gradient(-45deg, yellow 0 16px, black 16px 32px)` as the divider and the foot of a placeholder; an 8px variant under a head.
-- Rules `--rule-hair` in `--color-rule` in tables; borders `--rule-bar` ink on controls and the stamp; radius 0; no shadows; no texture, the crate is flat paint.
-- The stamp: a 3px border with an inset 3px gap and a second 5px ring, the stamp face, rotated -3°; one per page. A stamp carries a fact, a date or a frame number, or does not appear.
-- The control pair: a yellow-filled primary with black text beside a 3px-outlined ghost, both in the display face at 22px uppercase; a paper-filled third exists on the black crate only.
-- Objects: the barcode (a 56px row of 1px to 6px bars drawn with spans, encoding a real order number, or absent), the crossed-out figure (`line-through` at 0.14em for the old price), the tariff table, the tracking log, the paper label plate, and the placeholder: a dark radial wash with yellow in one corner, three ruled rows and a hazard foot.
-
-## Motion
-
-Mechanical: a stamp lands once on entry (scale 1.15 to 1 over 160ms ease-out); the tracking log adds a row in one frame; nothing else moves.
-
-## Voice
-
-Manifest voice: the pallet, the depot, the cut-off, the price per unit.
-
-## Do-nots
-
-- Never a stencil face on body copy; the bridges break at reading size.
-- Never yellow as running text on the black crate; yellow fills, stripes and stamps.
-- Never rust, scratches or spray drips; the crate is clean paint.
-- Never a rounded corner or a shadow on any surface.
-- Never yellow and paper as fills in one control row.
-
-## Build hint
-
-```html
-<link href="https://fonts.googleapis.com/css2?family=Big+Shoulders+Stencil+Display:wght@700;900&family=Allerta+Stencil&family=IBM+Plex+Mono:wght@400;500&display=swap" rel="stylesheet">
-```
-
-```css
-body { font-family: var(--font-body); font-size: 16px; }
-.display { font-family: var(--font-display); font-weight: 900; text-transform: uppercase; line-height: 0.88; letter-spacing: var(--tracking-display); }
-.label { font-weight: 500; font-size: 12.5px; color: var(--color-muted); }
-.hazard { height: 14px; background: repeating-linear-gradient(-45deg, var(--color-accent) 0 16px, var(--color-accent-ink) 16px 32px); }
-.stamp { display: inline-block; padding: 10px 16px 8px; border: var(--rule-bar) solid currentColor; box-shadow: inset 0 0 0 3px var(--color-paper), inset 0 0 0 5px currentColor;
- font-family: var(--font-outlier); font-size: 20px; letter-spacing: 0.04em; text-transform: uppercase; line-height: 1; transform: rotate(-3deg); white-space: nowrap; }
-.btn { font-family: var(--font-display); font-weight: 900; font-size: 22px; letter-spacing: 0.04em; text-transform: uppercase; padding: 12px 24px 10px; border: var(--rule-bar) solid var(--color-ink); color: var(--color-ink); background: transparent; line-height: 1; }
-.btn--primary { background: var(--color-accent); border-color: var(--color-accent); color: var(--color-accent-ink); }
-.barcode { display: flex; height: 56px; }
-.barcode i { display: block; height: 100%; background: currentColor; }
-.barcode i.g { background: transparent; }
-.was { text-decoration: line-through; text-decoration-thickness: 0.14em; }
-::selection { background: oklch(84% 0.17 90 / 0.4); color: var(--color-accent-ink); }
-```
diff --git a/skills/hallmark/scripts/sloplint-render.mjs b/skills/hallmark/scripts/sloplint-render.mjs
index 9206e9a..82c59f1 100644
--- a/skills/hallmark/scripts/sloplint-render.mjs
+++ b/skills/hallmark/scripts/sloplint-render.mjs
@@ -4,21 +4,24 @@ import { join, dirname, basename, resolve } from 'node:path';
import { fileURLToPath } from 'node:url';
const WIDTHS = [320, 375, 414, 768, 1280, 1920];
-const MAC_CHROME = '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome';
+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');
const SHOTS = [];
async function shoot(page, file, tag, fullPage) {
try {
- const dir = join(dirname(file), '.hallmark', 'shots');
+ const dir = isUrl(file) ? join(process.cwd(), '.hallmark', 'shots') : join(dirname(file), '.hallmark', 'shots');
mkdirSync(dir, { recursive: true });
- const out = join(dir, `${basename(file, '.html')}-${tag}.png`);
+ const out = join(dir, `${slugOf(file)}-${tag}.png`);
await page.screenshot({ path: out, fullPage });
SHOTS.push(out);
} catch {}
}
export async function renderCheck(htmlFiles, metaIn) {
- const meta = { genre: null, postureByFile: {}, ...(metaIn || {}) };
+ const meta = { genre: null, postureByFile: {}, stage: 'page', ...(metaIn || {}) };
+ const heroOnly = meta.stage === 'hero';
let puppeteer = null;
const { createRequire } = await import('node:module');
const { pathToFileURL } = await import('node:url');
@@ -48,10 +51,12 @@ export async function renderCheck(htmlFiles, metaIn) {
console.error('render tier unavailable (no puppeteer-core found locally, globally, or via HALLMARK_PUPPETEER); static checks only');
return [];
}
- const chrome = existsSync(MAC_CHROME) ? MAC_CHROME
- : (process.env.CHROME_PATH && existsSync(process.env.CHROME_PATH) ? process.env.CHROME_PATH : null);
+ let chrome = [process.env.CHROME_PATH, ...CHROMES].find((p) => p && existsSync(p)) || null;
+ if (!chrome && typeof puppeteer.executablePath === 'function') {
+ try { const bundled = puppeteer.executablePath(); if (bundled && existsSync(bundled)) chrome = bundled; } catch {}
+ }
if (!chrome) {
- console.error('render tier unavailable (no Chrome executable found; set CHROME_PATH); static checks only');
+ console.error('render tier unavailable (no Chrome or Chromium found; set CHROME_PATH); static checks only');
return [];
}
const findings = [];
@@ -60,21 +65,23 @@ export async function renderCheck(htmlFiles, metaIn) {
for (const file of htmlFiles) {
const page = await browser.newPage();
try {
- await page.goto('file://' + file, { waitUntil: 'networkidle0', timeout: 20000 }).catch(() => {});
+ await page.goto(isUrl(file) ? file : 'file://' + file, { waitUntil: 'networkidle0', timeout: 30000 }).catch(() => {});
const pageMeta = { genre: meta.genre, posture: meta.postureByFile[file] || 'restrained' };
- for (const width of WIDTHS) {
- await page.setViewport({ width, height: 800 });
+ const prefix = heroOnly ? 'hero-' : '';
+ for (const width of heroOnly ? [375, 1280] : WIDTHS) {
+ await page.setViewport({ width, height: width === 375 && heroOnly ? 812 : 800 });
await new Promise((r) => setTimeout(r, 120));
- if (width === 1280 || width === 375) await shoot(page, file, `${width}${width === 375 ? '' : 'x800'}`, width === 375);
+ if (width === 1280) await shoot(page, file, `${prefix}1280x800`, false);
+ if (width === 375) await shoot(page, file, heroOnly ? 'hero-375x812' : '375', !heroOnly);
const res = await page.evaluate(observe, width === 1280, pageMeta);
for (const f of res) findings.push({ ...f, file, line: 1, evidence: `[${width}px] ${f.evidence}` });
}
for (const [w, h] of [[1440, 900], [1920, 1080]]) {
await page.setViewport({ width: w, height: h });
- await shoot(page, file, `${w}x${h}`, false);
+ await shoot(page, file, `${prefix}${w}x${h}`, false);
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);
+ const res = await page.evaluate(observeSpace, w === 1440, heroOnly);
for (const f of res) findings.push({ ...f, file, line: 1, evidence: `[${w}px] ${f.evidence}` });
}
} catch (e) {
@@ -86,7 +93,7 @@ export async function renderCheck(htmlFiles, metaIn) {
} finally {
await browser.close().catch(() => {});
}
- if (SHOTS.length) console.error(`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; 375 full page)`);
const seen = new Set();
return findings.filter((f) => {
@@ -307,7 +314,7 @@ function observe(checkFold, meta) {
return out;
}
-function observeSpace(atLaptop) {
+function observeSpace(atLaptop, heroOnly) {
const out = [];
const push = (gate, grade, evidence, fix) => out.push({ gate: String(gate), grade, evidence, fix });
const vw = window.innerWidth, vh = window.innerHeight;
@@ -359,14 +366,14 @@ function observeSpace(atLaptop) {
const content = (s) => { let top = Infinity, bottom = -Infinity; for (const c of s.querySelectorAll('*')) { if (!vis(c)) continue; if (!(c.innerText || '').trim() && !/^(SVG|IMG|CANVAS|VIDEO)$/.test(c.tagName) && getComputedStyle(c).backgroundColor === 'rgba(0, 0, 0, 0)') continue; if (c.children.length && !/^(SVG)$/.test(c.tagName) && getComputedStyle(c).backgroundColor === 'rgba(0, 0, 0, 0)') continue; const b = abs(c); top = Math.min(top, b.top); bottom = Math.max(bottom, b.bottom); } if (top === Infinity) { const b = abs(s); return b; } return { top, bottom }; };
const gaps = [];
- for (let i = 0; i < secs.length - 1; i++) gaps.push(Math.round(content(secs[i + 1]).top - content(secs[i]).bottom));
+ for (let i = 0; !heroOnly && i < secs.length - 1; i++) gaps.push(Math.round(content(secs[i + 1]).top - content(secs[i]).bottom));
const real = gaps.filter((g) => g > -50);
if (real.length) {
const min = Math.min(...real);
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 (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`, 'Five to eight sections a page; merge or cut');
if (heroEnd != null) {
if (heroEnd > vh + 8) push('44c', 'REFLEX', `hero runs past the 1440x900 fold (hero ends at ${Math.round(heroEnd)}px)`, 'Size the display and the visual so the hero is one screen');
@@ -390,7 +397,7 @@ function observeSpace(atLaptop) {
if (import.meta.url === `file://${process.argv[1]}`) {
const htmls = process.argv.slice(2).filter((p) => p.endsWith('.html'));
- const res = await renderCheck(htmls.map((p) => resolve(process.cwd(), p)));
+ const res = await renderCheck(process.argv.slice(2).filter((p) => isUrl(p)).concat(htmls.map((p) => resolve(process.cwd(), p))));
console.log(JSON.stringify(res, null, 2));
process.exit(0);
}
diff --git a/skills/hallmark/scripts/sloplint.mjs b/skills/hallmark/scripts/sloplint.mjs
index a92c9b3..b915ca1 100644
--- a/skills/hallmark/scripts/sloplint.mjs
+++ b/skills/hallmark/scripts/sloplint.mjs
@@ -5,7 +5,7 @@ import { join, extname, dirname, basename, resolve } from 'node:path';
const GENRES = ['editorial', 'modern-minimal', 'atmospheric', 'playful'];
const args = process.argv.slice(2);
-const opts = { genre: null, scope: 'page', json: false, render: false, tier: null, paths: [] };
+const opts = { genre: null, scope: 'page', json: false, render: false, tier: null, stage: 'page', urls: [], paths: [] };
for (let i = 0; i < args.length; i++) {
const a = args[i];
if (a === '--genre') { opts.genre = args[++i]; }
@@ -13,14 +13,18 @@ for (let i = 0; i < args.length; i++) {
else if (a === '--json') { opts.json = true; }
else if (a === '--render') { opts.render = true; }
else if (a === '--tier') { opts.tier = args[++i]; }
+ else if (a === '--stage') { opts.stage = args[++i]; }
+ else if (a === '--url') { opts.urls.push(args[++i]); opts.render = true; }
else if (a === '--help' || a === '-h') { usage(); process.exit(0); }
else if (a.startsWith('--')) { console.error(`unknown flag ${a}`); usage(); process.exit(2); }
else opts.paths.push(a);
}
function usage() {
- console.error('usage: node sloplint.mjs <file-or-dir ...> [--genre editorial|modern-minimal|atmospheric|playful] [--scope page|component] [--json] [--render] [--tier floor]');
+ console.error('usage: node sloplint.mjs <file-or-dir ...> [--genre editorial|modern-minimal|atmospheric|playful] [--scope page|component] [--stage hero|page] [--json] [--render] [--url http://localhost:3000] [--tier floor]');
}
-if (!opts.paths.length) { usage(); process.exit(2); }
+if (!opts.paths.length && !opts.urls.length) { usage(); process.exit(2); }
+if (!['hero', 'page'].includes(opts.stage)) { console.error('--stage must be hero or page'); process.exit(2); }
+if (opts.urls.some((u) => !/^https?:\/\//.test(u || ''))) { console.error('--url takes an http or https address'); process.exit(2); }
if (opts.genre && !GENRES.includes(opts.genre)) {
console.error(`--genre must be one of: ${GENRES.join(', ')}`); process.exit(2);
}
@@ -428,6 +432,7 @@ const TIERS = new Map(Object.entries({
'55a': 'floor', '55b': 'reflex',
}));
+const HERO_SKIP = new Set(['8', '9', '32', '59', 'F8', 'F15']);
function baseGate(id) {
const s = String(id).trim();
if (/^F\d+$/i.test(s)) return s.toUpperCase();
@@ -497,6 +502,7 @@ const findings = [];
function report(gate, grade, file, line, evidence, fix) {
const g = String(gate);
if (opts.scope === 'component' && pageOnly(g)) return;
+ if (opts.stage === 'hero' && HERO_SKIP.has(String(g))) return;
const tier = tierOf(g);
const b = baseGate(g);
const waived = WAIVED.has(b) || WAIVED.has(gateNumber(b));
@@ -2641,8 +2647,8 @@ const CHECKS = [check1, check2, check3, check3Stripe, check4, check6a, check7, c
check19Tells, check58Static, check42TwoButton, check47Placeholders, check65Tailwind, check29Glow, check11Lift, check15Fade,
checkF1, checkF2, checkF3, checkF4, checkF5, checkF6, checkF7, checkF7Pills, checkF8, checkF9, checkF15, checkF16];
-const files = collectFiles(opts.paths);
-if (!files.length) { console.error('sloplint: no .html or .css files found'); process.exit(2); }
+const files = opts.paths.length ? collectFiles(opts.paths) : [];
+if (!files.length && !opts.urls.length) { console.error('sloplint: no .html or .css files found'); process.exit(2); }
const groups = new Map();
for (const f of files) {
@@ -2731,9 +2737,10 @@ if (opts.render) {
const htmlFiles = files.filter((f) => extname(f).toLowerCase() === '.html');
try {
const mod = await import(new URL('./sloplint-render.mjs', import.meta.url).href);
- const extra = await mod.renderCheck(htmlFiles, { genre: opts.genre, postureByFile });
+ const extra = await mod.renderCheck([...htmlFiles, ...opts.urls], { genre: opts.genre, postureByFile, stage: opts.stage });
+ const allWaivers = { WAIVED: new Set([...waiversByDir.values()].flatMap((x) => [...x.WAIVED])), ANSWERED: new Set([...waiversByDir.values()].flatMap((x) => [...x.ANSWERED])) };
for (const f of extra) {
- const w = waiversByDir.get(dirname(f.file));
+ const w = /^https?:/.test(f.file) ? allWaivers : waiversByDir.get(dirname(f.file));
WAIVED = w ? w.WAIVED : new Set();
ANSWERED = w ? w.ANSWERED : new Set();
report(f.gate, f.grade === 'REFLEX' ? 'FAIL' : f.grade, f.file, f.line, f.evidence, f.fix);
@@ -2786,7 +2793,7 @@ if (opts.json) {
}, null, 2));
} else {
if (!unique.length) {
- console.log(`sloplint: clean. 0 FAIL, 0 REFLEX, 0 WARN across ${files.length} file(s).`);
+ console.log(`sloplint: clean. 0 FAIL, 0 REFLEX, 0 WARN across ${files.length} file(s)${opts.urls.length ? ` and ${opts.urls.length} URL(s)` : ''}${opts.stage === 'hero' ? ' (hero stage)' : ''}.`);
} else {
const wGate = Math.max(4, ...unique.map((f) => String(f.gate).length));
const wGrade = Math.max(5, ...unique.map((f) => f.grade.length));
@@ -2798,7 +2805,7 @@ if (opts.json) {
console.log(`${''.padEnd(wGate)} ${''.padEnd(wGrade)} ${''.padEnd(wWhere)} fix: ${f.fix}`);
}
}
- console.log(`\n${tally.join(', ')} across ${files.length} file(s).`);
+ console.log(`\n${tally.join(', ')} across ${files.length} file(s)${opts.urls.length ? ` and ${opts.urls.length} URL(s)` : ''}${opts.stage === 'hero' ? ' (hero stage)' : ''}.`);
}
}
process.exit(fails > 0 || reflex > 0 ? 1 : 0);