Skip to content

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

CSS

Install · scope the skill to skills/hallmark/ (fixes #9)

Youssef3ec017389672
diff --git a/README.md b/README.md
index 902f93f..59baea1 100644
--- a/README.md
+++ b/README.md
@@ -66,13 +66,13 @@ Each page is self-contained HTML + CSS, stamped with its macrostructure in the C
npx skills add nutlope/hallmark
```
-Re-run any time to update. Or copy [`SKILL.md`](SKILL.md) + [`references/`](references/) into:
+Re-run any time to update. Or copy [`SKILL.md`](skills/hallmark/SKILL.md) + [`references/`](skills/hallmark/references/) into:
- **Claude Code** — `~/.claude/skills/hallmark/`
- **Cursor** — `.cursor/rules/hallmark.mdc` (body of `SKILL.md`, no frontmatter)
- **Codex** — `~/.codex/skills/hallmark/` (personal) or `.codex/skills/hallmark/` (project-scoped)
-The rule-set lives in [`SKILL.md`](SKILL.md) and [`references/`](references/). Worked examples in [`docs/recipes.md`](docs/recipes.md) and [`docs/study-examples.md`](docs/study-examples.md).
+The rule-set lives in [`SKILL.md`](skills/hallmark/SKILL.md) and [`references/`](skills/hallmark/references/). Worked examples in [`docs/recipes.md`](docs/recipes.md) and [`docs/study-examples.md`](docs/study-examples.md).
---
diff --git a/ROADMAP.md b/ROADMAP.md
index ce21be0..bdc9a87 100644
--- a/ROADMAP.md
+++ b/ROADMAP.md
@@ -16,11 +16,11 @@ What's next.
**Brand-first flow.** From a short product description, Hallmark generates a complete brand — palette, type system, voice, custom imagery via Nanobanana — and locks it into a `design.md`. The user then runs Hallmark normally and the whole site builds against that generated brand, page after page. Closes the gap for users who have a product idea but no brand yet.
-**Theme-aware motion tokens.** Per-theme `--dur-micro` / `--dur-short` / `--dur-long`, scaled by the table already in [`microinteractions.md`](references/microinteractions.md). Atelier should feel slower than Brutal; today they share durations. One pass through the tokens file.
+**Theme-aware motion tokens.** Per-theme `--dur-micro` / `--dur-short` / `--dur-long`, scaled by the table already in [`microinteractions.md`](skills/hallmark/references/microinteractions.md). Atelier should feel slower than Brutal; today they share durations. One pass through the tokens file.
**`hallmark variant`** — produce three structurally distinct versions of the same brief side-by-side; the user picks one or asks for a fourth. The biggest cause of "AI feel" is users accepting the first output because they didn't know it could be different.
-**Structural cookbook.** [`structure.md`](references/structure.md) catalogues the *axes* of variety but doesn't show what a left-margin-headed, hairline-divided, no-image page actually looks like assembled. Twelve to twenty worked fingerprints with short HTML/CSS sketches — patterns are easier to reach for than principles.
+**Structural cookbook.** [`structure.md`](skills/hallmark/references/structure.md) catalogues the *axes* of variety but doesn't show what a left-margin-headed, hairline-divided, no-image page actually looks like assembled. Twelve to twenty worked fingerprints with short HTML/CSS sketches — patterns are easier to reach for than principles.
**Tactile-rebellion reference.** Controlled imperfection — handmade textures, hand-drawn SVG paths, controlled-jitter typography (a 0.5° tilt on one mark is taste; on every word it's chaos). Where the field is going.
diff --git a/package.json b/package.json
index 95c5cde..f0123d3 100644
--- a/package.json
+++ b/package.json
@@ -18,12 +18,11 @@
"license": "MIT",
"type": "module",
"files": [
- "SKILL.md",
- "references"
+ "skills"
],
"skill": {
- "entry": "SKILL.md",
- "references": "references",
+ "entry": "skills/hallmark/SKILL.md",
+ "references": "skills/hallmark/references",
"harnesses": [
"claude-code",
"cursor",
diff --git a/site/_tests/custom/README.md b/site/_tests/custom/README.md
index 2724a24..0cd5e4a 100644
--- a/site/_tests/custom/README.md
+++ b/site/_tests/custom/README.md
@@ -2,7 +2,7 @@
Three landing pages produced by the **custom** theme route — the new opt-in branch added to Hallmark in v0.6.x. Custom is the route for one-off custom palettes + font pairings tuned to a single brand. **Catalog** (the 16 named themes) is the default; custom fires only when the brief signals creative or unique intent.
-These three pages are the worked examples written into [`references/custom-theme.md`](../../../references/custom-theme.md) § G — rendered as actual HTML so the palette + pairing can be inspected visually.
+These three pages are the worked examples written into [`references/custom-theme.md`](../../../skills/hallmark/references/custom-theme.md) § G — rendered as actual HTML so the palette + pairing can be inspected visually.
| # | Brand | Vibe | Anchor | Macrostructure | Axes |
| --- | --- | --- | --- | --- | --- |
@@ -27,4 +27,4 @@ The 16 named themes can't carry every brand. Coffeebox is closest to **Atelier**
4. **The Step 5 preview surfaces the palette + pairing.** Before any code is emitted, the user sees the OKLCH values and the chosen fonts in plain text. They can redirect early.
5. **Diversification is theme-route-blind.** Each custom run records its three axis values (paper-band / display-style / accent-hue) in `.hallmark/log.json`. The next run rotates against them the same way it does against catalog themes.
-See [`references/custom-theme.md`](../../../references/custom-theme.md) for the full protocol.
+See [`references/custom-theme.md`](../../../skills/hallmark/references/custom-theme.md) for the full protocol.
diff --git a/site/_tests/verbs/audit/audit-report.md b/site/_tests/verbs/audit/audit-report.md
index e85d5de..b021dce 100644
--- a/site/_tests/verbs/audit/audit-report.md
+++ b/site/_tests/verbs/audit/audit-report.md
@@ -4,9 +4,9 @@
## Verbs loaded
-- [`anti-patterns.md`](../../../references/anti-patterns.md) — the named-tells library to score against
-- [`structure.md`](../../../references/structure.md) — for the structural-fingerprint check (gate 9)
-- [`microinteractions.md`](../../../references/microinteractions.md) — the timing/easing canon
+- [`anti-patterns.md`](../../../skills/hallmark/references/anti-patterns.md) — the named-tells library to score against
+- [`structure.md`](../../../skills/hallmark/references/structure.md) — for the structural-fingerprint check (gate 9)
+- [`microinteractions.md`](../../../skills/hallmark/references/microinteractions.md) — the timing/easing canon
(No write paths. `audit` does not edit.)
diff --git a/site/_tests/verbs/study/diagnosis.md b/site/_tests/verbs/study/diagnosis.md
index 543af5b..5768736 100644
--- a/site/_tests/verbs/study/diagnosis.md
+++ b/site/_tests/verbs/study/diagnosis.md
@@ -4,10 +4,10 @@
## References loaded
-- [`study.md`](../../../references/study.md) — the vision-extraction protocol + structured-fields schema + refusal heuristics
-- [`study-examples.md`](../../../references/study-examples.md) — three worked examples (Pentagram-style portfolio, Klim-specimen, Rauno-personal)
-- [`macrostructures.md`](../../../references/macrostructures.md) — to name the page-shape
-- [`component-cookbook.md`](../../../references/component-cookbook.md) — to name the hero / pitch / footer archetypes
+- [`study.md`](../../../skills/hallmark/references/study.md) — the vision-extraction protocol + structured-fields schema + refusal heuristics
+- [`study-examples.md`](../../../skills/hallmark/references/study-examples.md) — three worked examples (Pentagram-style portfolio, Klim-specimen, Rauno-personal)
+- [`macrostructures.md`](../../../skills/hallmark/references/macrostructures.md) — to name the page-shape
+- [`component-cookbook.md`](../../../skills/hallmark/references/component-cookbook.md) — to name the hero / pitch / footer archetypes
## Diagnosis (10 structured fields)
@@ -33,7 +33,7 @@
## Anti-patterns the screenshot has — do NOT carry over
-> 1. The hover-state on the number-label uses a slow ease-in-out 800 ms colour fade. Per [`microinteractions.md`](../../../references/microinteractions.md) § The timing canon, hover state should be 150–200 ms. **Carry the *idea* (colour-shift on hover); shorten the *duration*.**
+> 1. The hover-state on the number-label uses a slow ease-in-out 800 ms colour fade. Per [`microinteractions.md`](../../../skills/hallmark/references/microinteractions.md) § The timing canon, hover state should be 150–200 ms. **Carry the *idea* (colour-shift on hover); shorten the *duration*.**
>
> 2. The footer text is set at 11 px with 0.06 em tracking — under the 14 px floor for body copy. **Bump to 12–13 px on rebuild, keep the tracking.**
diff --git a/site/_tests/verbs/study/notes.md b/site/_tests/verbs/study/notes.md
index af13c4f..cc95350 100644
--- a/site/_tests/verbs/study/notes.md
+++ b/site/_tests/verbs/study/notes.md
@@ -8,23 +8,23 @@ A described screenshot (`input-description.md`) of a Pentagram-style design stud
> *"Extract the DNA — macrostructure, archetypes, type-pairing role, colour anchor, rhythm — and produce a diagnosis report, then optionally rebuild the user's content using the extracted DNA. Never copies pixels. Never claims to identify exact fonts. Refuses obvious template-marketplace screenshots."*
-Five-step pipeline (per [`SKILL.md`](../../../SKILL.md) § `hallmark study`):
+Five-step pipeline (per [`SKILL.md`](../../../skills/hallmark/SKILL.md) § `hallmark study`):
1. **Refuse-or-proceed check** — public reference, not a paid template → proceed.
-2. **Vision pass** — read the image into the structured-fields schema in [`study.md`](../../../references/study.md). Output ten fields.
+2. **Vision pass** — read the image into the structured-fields schema in [`study.md`](../../../skills/hallmark/references/study.md). Output ten fields.
3. **Diagnosis report** — return the named macrostructure + archetypes + anti-patterns to NOT carry over. See [`diagnosis.md`](diagnosis.md).
4. **Confirmation question** — ask before building.
5. **Build** — produce `output.html` + `output.css` with the user's actual six projects, stamped `studied: yes`.
## What loaded
-- [`references/study.md`](../../../references/study.md) — the protocol, schema, and refusal heuristics.
-- [`references/study-examples.md`](../../../references/study-examples.md) — the three worked examples (Pentagram-style portfolio, Klim-specimen, Rauno-personal). The Pentagram example matched our screenshot most closely; the skill imitated the diagnosis structure.
-- [`references/macrostructures.md`](../../../references/macrostructures.md) — to name the page-shape (Specimen).
-- [`references/component-cookbook.md`](../../../references/component-cookbook.md) — for archetype names (H4 Margin-Number Display, Ft1 Single-Line Colophon).
-- [`references/typography.md`](../../../references/typography.md) — for the type-role vocabulary (italic-display + sans-body) and free / paid candidate pairings.
-- [`references/color.md`](../../../references/color.md) — for the warm-orange-at-low-chroma colour-anchor.
-- [`references/microinteractions.md`](../../../references/microinteractions.md) — for the hover-duration anti-pattern callout (the screenshot's 800 ms is too slow; should be 150–200 ms).
+- [`references/study.md`](../../../skills/hallmark/references/study.md) — the protocol, schema, and refusal heuristics.
+- [`references/study-examples.md`](../../../skills/hallmark/references/study-examples.md) — the three worked examples (Pentagram-style portfolio, Klim-specimen, Rauno-personal). The Pentagram example matched our screenshot most closely; the skill imitated the diagnosis structure.
+- [`references/macrostructures.md`](../../../skills/hallmark/references/macrostructures.md) — to name the page-shape (Specimen).
+- [`references/component-cookbook.md`](../../../skills/hallmark/references/component-cookbook.md) — for archetype names (H4 Margin-Number Display, Ft1 Single-Line Colophon).
+- [`references/typography.md`](../../../skills/hallmark/references/typography.md) — for the type-role vocabulary (italic-display + sans-body) and free / paid candidate pairings.
+- [`references/color.md`](../../../skills/hallmark/references/color.md) — for the warm-orange-at-low-chroma colour-anchor.
+- [`references/microinteractions.md`](../../../skills/hallmark/references/microinteractions.md) — for the hover-duration anti-pattern callout (the screenshot's 800 ms is too slow; should be 150–200 ms).
## What `study` did *not* do
@@ -58,4 +58,4 @@ The screenshot maps neatly to study-examples.md Example A (Pentagram-style edito
- The confirmation question.
- The `studied: yes` stamp.
-If the input had been a paid Squarespace-template marketplace screenshot, the verb would have refused. If the input had been ambiguous (an unknown agency page or a personal portfolio with no clear ownership), the verb would have asked before extracting. Both branches are documented in [`study.md`](../../../references/study.md); this test exercises the proceed-with-public-reference branch.
+If the input had been a paid Squarespace-template marketplace screenshot, the verb would have refused. If the input had been ambiguous (an unknown agency page or a personal portfolio with no clear ownership), the verb would have asked before extracting. Both branches are documented in [`study.md`](../../../skills/hallmark/references/study.md); this test exercises the proceed-with-public-reference branch.
diff --git a/SKILL.md b/skills/hallmark/SKILL.md
similarity index 99%
rename from SKILL.md
rename to skills/hallmark/SKILL.md
index 3af4881..a238269 100644
--- a/SKILL.md
+++ b/skills/hallmark/SKILL.md
@@ -275,7 +275,7 @@ Before loading any visual ruleset, **read the slim index at [`references/macrost
If the previous output was Specimen (light · italic-serif · warm), the next can be Studio (light · italic-serif · chromatic-green) — the *accent hue* differs. But the next can't be Salon (light · roman-serif · warm) which only differs on display style and shares both paper band and accent — pick a more distant theme.
-The per-theme axis values live as comments at the top of each theme's tokens block in [`site/css/tokens.css`](../site/css/tokens.css). When in doubt, name your candidate theme out loud and identify its three axis values; if two of three match the previous output, redirect.
+The per-theme axis values live as comments at the top of each theme's tokens block in [`site/css/tokens.css`](../../site/css/tokens.css). When in doubt, name your candidate theme out loud and identify its three axis values; if two of three match the previous output, redirect.
**State your pick.** Before writing any code, say "Macrostructure: <name>. Theme: <name>. Differs from the last on: <axes>." in plain text. This is a deliberate accountability step — picking on the page (not in your head) prevents the default-attractor sameness that kept the skill emitting Specimen output.
@@ -382,8 +382,8 @@ The non-negotiables live in [`references/`](references/). **Be precise about wha
- [`study.md`](references/study.md) — load only when `hallmark study` runs.
**Human-only (do NOT auto-load):**
-- [`../docs/recipes.md`](../docs/recipes.md) — eight worked briefs for human readers.
-- [`../docs/study-examples.md`](../docs/study-examples.md) — three worked DNA-extractions for human readers.
+- [`../../docs/recipes.md`](../../docs/recipes.md) — eight worked briefs for human readers.
+- [`../../docs/study-examples.md`](../../docs/study-examples.md) — three worked DNA-extractions for human readers.
### 4. Decide on hero enrichment
diff --git a/references/anti-patterns.md b/skills/hallmark/references/anti-patterns.md
similarity index 100%
rename from references/anti-patterns.md
rename to skills/hallmark/references/anti-patterns.md
diff --git a/references/assets.md b/skills/hallmark/references/assets.md
similarity index 100%
rename from references/assets.md
rename to skills/hallmark/references/assets.md
diff --git a/references/color.md b/skills/hallmark/references/color.md
similarity index 100%
rename from references/color.md
rename to skills/hallmark/references/color.md
diff --git a/references/component-cookbook.md b/skills/hallmark/references/component-cookbook.md
similarity index 100%
rename from references/component-cookbook.md
rename to skills/hallmark/references/component-cookbook.md
diff --git a/references/components/c1-outlined-chip.md b/skills/hallmark/references/components/c1-outlined-chip.md
similarity index 100%
rename from references/components/c1-outlined-chip.md
rename to skills/hallmark/references/components/c1-outlined-chip.md
diff --git a/references/components/c2-inline-form-as-cta.md b/skills/hallmark/references/components/c2-inline-form-as-cta.md
similarity index 100%
rename from references/components/c2-inline-form-as-cta.md
rename to skills/hallmark/references/components/c2-inline-form-as-cta.md
diff --git a/references/components/c3-typographic-link.md b/skills/hallmark/references/components/c3-typographic-link.md
similarity index 100%
rename from references/components/c3-typographic-link.md
rename to skills/hallmark/references/components/c3-typographic-link.md
diff --git a/references/components/c4-sticky-bottom-bar.md b/skills/hallmark/references/components/c4-sticky-bottom-bar.md
similarity index 100%
rename from references/components/c4-sticky-bottom-bar.md
rename to skills/hallmark/references/components/c4-sticky-bottom-bar.md
diff --git a/references/components/f1-bento-grid.md b/skills/hallmark/references/components/f1-bento-grid.md
similarity index 100%
rename from references/components/f1-bento-grid.md
rename to skills/hallmark/references/components/f1-bento-grid.md
diff --git a/references/components/f2-sticky-scroll-stack.md b/skills/hallmark/references/components/f2-sticky-scroll-stack.md
similarity index 100%
rename from references/components/f2-sticky-scroll-stack.md
rename to skills/hallmark/references/components/f2-sticky-scroll-stack.md
diff --git a/references/components/f3-tabular-spec-sheet.md b/skills/hallmark/references/components/f3-tabular-spec-sheet.md
similarity index 100%
rename from references/components/f3-tabular-spec-sheet.md
rename to skills/hallmark/references/components/f3-tabular-spec-sheet.md
diff --git a/references/components/f4-step-sequence.md b/skills/hallmark/references/components/f4-step-sequence.md
similarity index 100%
rename from references/components/f4-step-sequence.md
rename to skills/hallmark/references/components/f4-step-sequence.md
diff --git a/references/components/f5-annotated-screenshot.md b/skills/hallmark/references/components/f5-annotated-screenshot.md
similarity index 100%
rename from references/components/f5-annotated-screenshot.md
rename to skills/hallmark/references/components/f5-annotated-screenshot.md
diff --git a/references/components/f6-product-card-grid.md b/skills/hallmark/references/components/f6-product-card-grid.md
similarity index 100%
rename from references/components/f6-product-card-grid.md
rename to skills/hallmark/references/components/f6-product-card-grid.md
diff --git a/references/components/ft1-mast-headed.md b/skills/hallmark/references/components/ft1-mast-headed.md
similarity index 100%
rename from references/components/ft1-mast-headed.md
rename to skills/hallmark/references/components/ft1-mast-headed.md
diff --git a/references/components/ft2-inline-rule-single-line.md b/skills/hallmark/references/components/ft2-inline-rule-single-line.md
similarity index 100%
rename from references/components/ft2-inline-rule-single-line.md
rename to skills/hallmark/references/components/ft2-inline-rule-single-line.md
diff --git a/references/components/ft3-index-style-category-list.md b/skills/hallmark/references/components/ft3-index-style-category-list.md
similarity index 100%
rename from references/components/ft3-index-style-category-list.md
rename to skills/hallmark/references/components/ft3-index-style-category-list.md
diff --git a/references/components/ft4-dense-typographic.md b/skills/hallmark/references/components/ft4-dense-typographic.md
similarity index 100%
rename from references/components/ft4-dense-typographic.md
rename to skills/hallmark/references/components/ft4-dense-typographic.md
diff --git a/references/components/ft5-statement.md b/skills/hallmark/references/components/ft5-statement.md
similarity index 100%
rename from references/components/ft5-statement.md
rename to skills/hallmark/references/components/ft5-statement.md
diff --git a/references/components/ft6-letter-close.md b/skills/hallmark/references/components/ft6-letter-close.md
similarity index 100%
rename from references/components/ft6-letter-close.md
rename to skills/hallmark/references/components/ft6-letter-close.md
diff --git a/references/components/ft7-newsletter-first.md b/skills/hallmark/references/components/ft7-newsletter-first.md
similarity index 100%
rename from references/components/ft7-newsletter-first.md
rename to skills/hallmark/references/components/ft7-newsletter-first.md
diff --git a/references/components/ft8-marquee-scroll.md b/skills/hallmark/references/components/ft8-marquee-scroll.md
similarity index 100%
rename from references/components/ft8-marquee-scroll.md
rename to skills/hallmark/references/components/ft8-marquee-scroll.md
diff --git a/references/components/h1-marquee.md b/skills/hallmark/references/components/h1-marquee.md
similarity index 100%
rename from references/components/h1-marquee.md
rename to skills/hallmark/references/components/h1-marquee.md
diff --git a/references/components/h2-split-diptych.md b/skills/hallmark/references/components/h2-split-diptych.md
similarity index 100%
rename from references/components/h2-split-diptych.md
rename to skills/hallmark/references/components/h2-split-diptych.md
diff --git a/references/components/h3-quote-led.md b/skills/hallmark/references/components/h3-quote-led.md
similarity index 100%
rename from references/components/h3-quote-led.md
rename to skills/hallmark/references/components/h3-quote-led.md
diff --git a/references/components/h4-stat-led.md b/skills/hallmark/references/components/h4-stat-led.md
similarity index 100%
rename from references/components/h4-stat-led.md
rename to skills/hallmark/references/components/h4-stat-led.md
diff --git a/references/components/h5-letter-hero.md b/skills/hallmark/references/components/h5-letter-hero.md
similarity index 100%
rename from references/components/h5-letter-hero.md
rename to skills/hallmark/references/components/h5-letter-hero.md
diff --git a/references/components/h6-photographic-fold.md b/skills/hallmark/references/components/h6-photographic-fold.md
similarity index 100%
rename from references/components/h6-photographic-fold.md
rename to skills/hallmark/references/components/h6-photographic-fold.md
diff --git a/references/components/h7-demo-video-clipped-by-viewport-edge.md b/skills/hallmark/references/components/h7-demo-video-clipped-by-viewport-edge.md
similarity index 100%
rename from references/components/h7-demo-video-clipped-by-viewport-edge.md
rename to skills/hallmark/references/components/h7-demo-video-clipped-by-viewport-edge.md
diff --git a/references/components/h8-mockup-split-browser-framed.md b/skills/hallmark/references/components/h8-mockup-split-browser-framed.md
similarity index 100%
rename from references/components/h8-mockup-split-browser-framed.md
rename to skills/hallmark/references/components/h8-mockup-split-browser-framed.md
diff --git a/references/components/h9-custom-illustration-centerpiece.md b/skills/hallmark/references/components/h9-custom-illustration-centerpiece.md
similarity index 100%
rename from references/components/h9-custom-illustration-centerpiece.md
rename to skills/hallmark/references/components/h9-custom-illustration-centerpiece.md
diff --git a/references/components/n1-wordmark-2-links.md b/skills/hallmark/references/components/n1-wordmark-2-links.md
similarity index 100%
rename from references/components/n1-wordmark-2-links.md
rename to skills/hallmark/references/components/n1-wordmark-2-links.md
diff --git a/references/components/n10-floating-on-scroll-morph.md b/skills/hallmark/references/components/n10-floating-on-scroll-morph.md
similarity index 100%
rename from references/components/n10-floating-on-scroll-morph.md
rename to skills/hallmark/references/components/n10-floating-on-scroll-morph.md
diff --git a/references/components/n2-floating-chip.md b/skills/hallmark/references/components/n2-floating-chip.md
similarity index 100%
rename from references/components/n2-floating-chip.md
rename to skills/hallmark/references/components/n2-floating-chip.md
diff --git a/references/components/n3-side-rail.md b/skills/hallmark/references/components/n3-side-rail.md
similarity index 100%
rename from references/components/n3-side-rail.md
rename to skills/hallmark/references/components/n3-side-rail.md
diff --git a/references/components/n4-hidden-behind-k.md b/skills/hallmark/references/components/n4-hidden-behind-k.md
similarity index 100%
rename from references/components/n4-hidden-behind-k.md
rename to skills/hallmark/references/components/n4-hidden-behind-k.md
diff --git a/references/components/n5-floating-pill.md b/skills/hallmark/references/components/n5-floating-pill.md
similarity index 100%
rename from references/components/n5-floating-pill.md
rename to skills/hallmark/references/components/n5-floating-pill.md
diff --git a/references/components/n6-newspaper-masthead.md b/skills/hallmark/references/components/n6-newspaper-masthead.md
similarity index 100%
rename from references/components/n6-newspaper-masthead.md
rename to skills/hallmark/references/components/n6-newspaper-masthead.md
diff --git a/references/components/n7-brutal-slab.md b/skills/hallmark/references/components/n7-brutal-slab.md
similarity index 100%
rename from references/components/n7-brutal-slab.md
rename to skills/hallmark/references/components/n7-brutal-slab.md
diff --git a/references/components/n8-terminal-command.md b/skills/hallmark/references/components/n8-terminal-command.md
similarity index 100%
rename from references/components/n8-terminal-command.md
rename to skills/hallmark/references/components/n8-terminal-command.md
diff --git a/references/components/n9-edge-aligned-minimal.md b/skills/hallmark/references/components/n9-edge-aligned-minimal.md
similarity index 100%
rename from references/components/n9-edge-aligned-minimal.md
rename to skills/hallmark/references/components/n9-edge-aligned-minimal.md
diff --git a/references/components/s1-left-margin-numbered.md b/skills/hallmark/references/components/s1-left-margin-numbered.md
similarity index 100%
rename from references/components/s1-left-margin-numbered.md
rename to skills/hallmark/references/components/s1-left-margin-numbered.md
diff --git a/references/components/s2-hanging.md b/skills/hallmark/references/components/s2-hanging.md
similarity index 100%
rename from references/components/s2-hanging.md
rename to skills/hallmark/references/components/s2-hanging.md
diff --git a/references/components/s3-sticky-pinned.md b/skills/hallmark/references/components/s3-sticky-pinned.md
similarity index 100%
rename from references/components/s3-sticky-pinned.md
rename to skills/hallmark/references/components/s3-sticky-pinned.md
diff --git a/references/components/s4-inline-no-break.md b/skills/hallmark/references/components/s4-inline-no-break.md
similarity index 100%
rename from references/components/s4-inline-no-break.md
rename to skills/hallmark/references/components/s4-inline-no-break.md
diff --git a/references/components/s5-bottom-anchored.md b/skills/hallmark/references/components/s5-bottom-anchored.md
similarity index 100%
rename from references/components/s5-bottom-anchored.md
rename to skills/hallmark/references/components/s5-bottom-anchored.md
diff --git a/references/components/t1-pull-quote-with-marginalia.md b/skills/hallmark/references/components/t1-pull-quote-with-marginalia.md
similarity index 100%
rename from references/components/t1-pull-quote-with-marginalia.md
rename to skills/hallmark/references/components/t1-pull-quote-with-marginalia.md
diff --git a/references/components/t2-logo-wall-hairline.md b/skills/hallmark/references/components/t2-logo-wall-hairline.md
similarity index 100%
rename from references/components/t2-logo-wall-hairline.md
rename to skills/hallmark/references/components/t2-logo-wall-hairline.md
diff --git a/references/components/t3-single-huge-quote.md b/skills/hallmark/references/components/t3-single-huge-quote.md
similarity index 100%
rename from references/components/t3-single-huge-quote.md
rename to skills/hallmark/references/components/t3-single-huge-quote.md
diff --git a/references/components/t4-numbered-stat-strip.md b/skills/hallmark/references/components/t4-numbered-stat-strip.md
similarity index 100%
rename from references/components/t4-numbered-stat-strip.md
rename to skills/hallmark/references/components/t4-numbered-stat-strip.md
diff --git a/references/contract.md b/skills/hallmark/references/contract.md
similarity index 100%
rename from references/contract.md
rename to skills/hallmark/references/contract.md
diff --git a/references/copy.md b/skills/hallmark/references/copy.md
similarity index 100%
rename from references/copy.md
rename to skills/hallmark/references/copy.md
diff --git a/references/custom-craft.md b/skills/hallmark/references/custom-craft.md
similarity index 100%
rename from references/custom-craft.md
rename to skills/hallmark/references/custom-craft.md
diff --git a/references/custom-theme.md b/skills/hallmark/references/custom-theme.md
similarity index 98%
rename from references/custom-theme.md
rename to skills/hallmark/references/custom-theme.md
index 2f15e71..fa70873 100644
--- a/references/custom-theme.md
+++ b/skills/hallmark/references/custom-theme.md
@@ -213,7 +213,7 @@ Custom runs extend the existing schema with a `theme_axes` field and an optional
"brief": "Coffeebox · subscription" }
```
-Catalog entries continue to record `theme: <name>` and skip `theme_axes` (the catalog's axes are looked up from [`tokens.css`](../../site/css/tokens.css)). Step 2.5 logic uses the same diversification check on both — for catalog entries it reads the axes from tokens.css; for custom entries it reads them from the entry.
+Catalog entries continue to record `theme: <name>` and skip `theme_axes` (the catalog's axes are looked up from [`tokens.css`](../../../site/css/tokens.css)). Step 2.5 logic uses the same diversification check on both — for catalog entries it reads the axes from tokens.css; for custom entries it reads them from the entry.
When rotating, **a custom run that follows another custom run must differ on at least one axis from the previous custom** — same rule as catalog-vs-catalog. A custom run that follows a catalog run must differ on at least one axis from the catalog's axes. The diversification rule is theme-route-blind.
@@ -321,7 +321,7 @@ The vibe names two hues: *moss* (greenish, ~140°) and *soft pink* (warm, ~350°
## What custom does **not** do (worth restating)
1. **Does not invent themes that ignore the rules.** Every paper L band, accent chroma cap, neutral-tinting requirement, font ban, and slop-test gate carries forward. The freedom is the *combination* — not the rules.
-2. **Does not save themes for reuse.** A custom run is per-output. The skill does not write back to [`tokens.css`](../../site/css/tokens.css). If the user wants a permanent theme, they paste the custom palette into tokens.css themselves and name it.
+2. **Does not save themes for reuse.** A custom run is per-output. The skill does not write back to [`tokens.css`](../../../site/css/tokens.css). If the user wants a permanent theme, they paste the custom palette into tokens.css themselves and name it.
3. **Does not ask multiple follow-up questions.** One vibe answer (+ optional anchor) is enough. The audience/use/tone from Step 1 plus the brief plus the macrostructure pick already give the model 80 % of the signal.
4. **Does not relax the diversification rule.** Custom entries declare their three axes the same way catalog entries do; the rotation rule fires on both, theme-route-blind.
5. **Does not bypass the Step 5 preview.** The custom palette + pairing surface in plain text *before* any code is emitted, so the user can redirect early.
diff --git a/references/design-md.md b/skills/hallmark/references/design-md.md
similarity index 100%
rename from references/design-md.md
rename to skills/hallmark/references/design-md.md
diff --git a/references/export-formats.md b/skills/hallmark/references/export-formats.md
similarity index 100%
rename from references/export-formats.md
rename to skills/hallmark/references/export-formats.md
diff --git a/references/floating-nav.md b/skills/hallmark/references/floating-nav.md
similarity index 100%
rename from references/floating-nav.md
rename to skills/hallmark/references/floating-nav.md
diff --git a/references/genres/atmospheric.md b/skills/hallmark/references/genres/atmospheric.md
similarity index 100%
rename from references/genres/atmospheric.md
rename to skills/hallmark/references/genres/atmospheric.md
diff --git a/references/genres/editorial.md b/skills/hallmark/references/genres/editorial.md
similarity index 100%
rename from references/genres/editorial.md
rename to skills/hallmark/references/genres/editorial.md
diff --git a/references/genres/modern-minimal.md b/skills/hallmark/references/genres/modern-minimal.md
similarity index 100%
rename from references/genres/modern-minimal.md
rename to skills/hallmark/references/genres/modern-minimal.md
diff --git a/references/genres/playful.md b/skills/hallmark/references/genres/playful.md
similarity index 100%
rename from references/genres/playful.md
rename to skills/hallmark/references/genres/playful.md
diff --git a/references/hero-enrichment.md b/skills/hallmark/references/hero-enrichment.md
similarity index 97%
rename from references/hero-enrichment.md
rename to skills/hallmark/references/hero-enrichment.md
index 56ed12f..6130349 100644
--- a/references/hero-enrichment.md
+++ b/skills/hallmark/references/hero-enrichment.md
@@ -99,7 +99,7 @@ A display headline left, a demo video right, and the rightmost ~10–20 % of the
- Aspect ratio (16/10 · 16/9 · 4/3)
- Frame treatment (hairline 1 px frame · browser chrome · none)
-**Example.** Tracejam (SaaS observability — see [`site/_tests/05-tracejam-saas/`](../../site/_tests/05-tracejam-saas/)). Display headline left ("Distributed tracing that explains itself."); hand-built CSS-art trace waterfall right, tilted -0.4°, extending 12 vw past the viewport's right edge. Aspect 16/10. Hairline frame. **Not a real video** — the mockup is custom-built CSS at Tier A (rectangles on a percentage grid simulating a flame chart). Mobile (< 60 rem): drop the clip, stack vertically.
+**Example.** Tracejam (SaaS observability — see [`site/_tests/05-tracejam-saas/`](../../../site/_tests/05-tracejam-saas/)). Display headline left ("Distributed tracing that explains itself."); hand-built CSS-art trace waterfall right, tilted -0.4°, extending 12 vw past the viewport's right edge. Aspect 16/10. Hairline frame. **Not a real video** — the mockup is custom-built CSS at Tier A (rectangles on a percentage grid simulating a flame chart). Mobile (< 60 rem): drop the clip, stack vertically.
```html
<section class="hero hero--clipped">
@@ -204,7 +204,7 @@ A hand-built SVG (the default, Tier B) or a generated raster (Tier C, when chara
- Animation (none · loop · scroll-linked)
- Scale (small accent · dominant)
-**Example.** Maple Street Bread (bakery — see [`site/_tests/03-maple-bakery/`](../../site/_tests/03-maple-bakery/)). Letter-style hero copy left ("Saturday, 6:14 a.m. The dough went in at midnight."), 60-line hand-built SVG loaf right, 3 paths (body, shade, score-marks). Animated with `@property --rise` for a subtle 4 px breathing-loop over 6 s, alternating; the score-marks draw themselves on first paint via `stroke-dasharray`. Tier B, dominant scale, animation: loop. Reduced-motion fallback is a static keyframe.
+**Example.** Maple Street Bread (bakery — see [`site/_tests/03-maple-bakery/`](../../../site/_tests/03-maple-bakery/)). Letter-style hero copy left ("Saturday, 6:14 a.m. The dough went in at midnight."), 60-line hand-built SVG loaf right, 3 paths (body, shade, score-marks). Animated with `@property --rise` for a subtle 4 px breathing-loop over 6 s, alternating; the score-marks draw themselves on first paint via `stroke-dasharray`. Tier B, dominant scale, animation: loop. Reduced-motion fallback is a static keyframe.
For *how* to build a hand-drawn loaf in 60 lines of SVG and animate its breath with `@property`, see [`custom-craft.md`](custom-craft.md) — there's a full bakery worked example, plus four more recipes (workflow diagram, mascot, architectural diagram, botanical accent).
diff --git a/references/imagery-kit.md b/skills/hallmark/references/imagery-kit.md
similarity index 100%
rename from references/imagery-kit.md
rename to skills/hallmark/references/imagery-kit.md
diff --git a/references/interaction-and-states.md b/skills/hallmark/references/interaction-and-states.md
similarity index 100%
rename from references/interaction-and-states.md
rename to skills/hallmark/references/interaction-and-states.md
diff --git a/references/layout-and-space.md b/skills/hallmark/references/layout-and-space.md
similarity index 100%
rename from references/layout-and-space.md
rename to skills/hallmark/references/layout-and-space.md
diff --git a/references/macrostructures.md b/skills/hallmark/references/macrostructures.md
similarity index 100%
rename from references/macrostructures.md
rename to skills/hallmark/references/macrostructures.md
diff --git a/references/macrostructures/01-bento-grid.md b/skills/hallmark/references/macrostructures/01-bento-grid.md
similarity index 100%
rename from references/macrostructures/01-bento-grid.md
rename to skills/hallmark/references/macrostructures/01-bento-grid.md
diff --git a/references/macrostructures/02-long-document.md b/skills/hallmark/references/macrostructures/02-long-document.md
similarity index 100%
rename from references/macrostructures/02-long-document.md
rename to skills/hallmark/references/macrostructures/02-long-document.md
diff --git a/references/macrostructures/03-marquee-hero.md b/skills/hallmark/references/macrostructures/03-marquee-hero.md
similarity index 100%
rename from references/macrostructures/03-marquee-hero.md
rename to skills/hallmark/references/macrostructures/03-marquee-hero.md
diff --git a/references/macrostructures/04-stat-led.md b/skills/hallmark/references/macrostructures/04-stat-led.md
similarity index 100%
rename from references/macrostructures/04-stat-led.md
rename to skills/hallmark/references/macrostructures/04-stat-led.md
diff --git a/references/macrostructures/05-workbench.md b/skills/hallmark/references/macrostructures/05-workbench.md
similarity index 100%
rename from references/macrostructures/05-workbench.md
rename to skills/hallmark/references/macrostructures/05-workbench.md
diff --git a/references/macrostructures/06-conversational-faq.md b/skills/hallmark/references/macrostructures/06-conversational-faq.md
similarity index 100%
rename from references/macrostructures/06-conversational-faq.md
rename to skills/hallmark/references/macrostructures/06-conversational-faq.md
diff --git a/references/macrostructures/07-manifesto.md b/skills/hallmark/references/macrostructures/07-manifesto.md
similarity index 100%
rename from references/macrostructures/07-manifesto.md
rename to skills/hallmark/references/macrostructures/07-manifesto.md
diff --git a/references/macrostructures/08-photographic.md b/skills/hallmark/references/macrostructures/08-photographic.md
similarity index 100%
rename from references/macrostructures/08-photographic.md
rename to skills/hallmark/references/macrostructures/08-photographic.md
diff --git a/references/macrostructures/09-quote-led.md b/skills/hallmark/references/macrostructures/09-quote-led.md
similarity index 100%
rename from references/macrostructures/09-quote-led.md
rename to skills/hallmark/references/macrostructures/09-quote-led.md
diff --git a/references/macrostructures/10-specimen.md b/skills/hallmark/references/macrostructures/10-specimen.md
similarity index 100%
rename from references/macrostructures/10-specimen.md
rename to skills/hallmark/references/macrostructures/10-specimen.md
diff --git a/references/macrostructures/11-catalogue.md b/skills/hallmark/references/macrostructures/11-catalogue.md
similarity index 100%
rename from references/macrostructures/11-catalogue.md
rename to skills/hallmark/references/macrostructures/11-catalogue.md
diff --git a/references/macrostructures/12-letter.md b/skills/hallmark/references/macrostructures/12-letter.md
similarity index 100%
rename from references/macrostructures/12-letter.md
rename to skills/hallmark/references/macrostructures/12-letter.md
diff --git a/references/macrostructures/13-index-first.md b/skills/hallmark/references/macrostructures/13-index-first.md
similarity index 100%
rename from references/macrostructures/13-index-first.md
rename to skills/hallmark/references/macrostructures/13-index-first.md
diff --git a/references/macrostructures/14-narrative-workflow.md b/skills/hallmark/references/macrostructures/14-narrative-workflow.md
similarity index 100%
rename from references/macrostructures/14-narrative-workflow.md
rename to skills/hallmark/references/macrostructures/14-narrative-workflow.md
diff --git a/references/macrostructures/15-split-studio.md b/skills/hallmark/references/macrostructures/15-split-studio.md
similarity index 100%
rename from references/macrostructures/15-split-studio.md
rename to skills/hallmark/references/macrostructures/15-split-studio.md
diff --git a/references/macrostructures/16-feature-stack.md b/skills/hallmark/references/macrostructures/16-feature-stack.md
similarity index 100%
rename from references/macrostructures/16-feature-stack.md
rename to skills/hallmark/references/macrostructures/16-feature-stack.md
diff --git a/references/macrostructures/17-type-specimen.md b/skills/hallmark/references/macrostructures/17-type-specimen.md
similarity index 100%
rename from references/macrostructures/17-type-specimen.md
rename to skills/hallmark/references/macrostructures/17-type-specimen.md
diff --git a/references/macrostructures/18-portfolio-grid.md b/skills/hallmark/references/macrostructures/18-portfolio-grid.md
similarity index 100%
rename from references/macrostructures/18-portfolio-grid.md
rename to skills/hallmark/references/macrostructures/18-portfolio-grid.md
diff --git a/references/macrostructures/19-map-diagram.md b/skills/hallmark/references/macrostructures/19-map-diagram.md
similarity index 100%
rename from references/macrostructures/19-map-diagram.md
rename to skills/hallmark/references/macrostructures/19-map-diagram.md
diff --git a/references/macrostructures/20-ecosystem-index.md b/skills/hallmark/references/macrostructures/20-ecosystem-index.md
similarity index 100%
rename from references/macrostructures/20-ecosystem-index.md
rename to skills/hallmark/references/macrostructures/20-ecosystem-index.md
diff --git a/references/macrostructures/21-component-playground.md b/skills/hallmark/references/macrostructures/21-component-playground.md
similarity index 100%
rename from references/macrostructures/21-component-playground.md
rename to skills/hallmark/references/macrostructures/21-component-playground.md
diff --git a/references/microinteractions.md b/skills/hallmark/references/microinteractions.md
similarity index 100%
rename from references/microinteractions.md
rename to skills/hallmark/references/microinteractions.md
diff --git a/references/motion.md b/skills/hallmark/references/motion.md
similarity index 100%
rename from references/motion.md
rename to skills/hallmark/references/motion.md
diff --git a/references/preview-examples.md b/skills/hallmark/references/preview-examples.md
similarity index 100%
rename from references/preview-examples.md
rename to skills/hallmark/references/preview-examples.md
diff --git a/references/responsive.md b/skills/hallmark/references/responsive.md
similarity index 100%
rename from references/responsive.md
rename to skills/hallmark/references/responsive.md
diff --git a/references/slop-test.md b/skills/hallmark/references/slop-test.md
similarity index 100%
rename from references/slop-test.md
rename to skills/hallmark/references/slop-test.md
diff --git a/references/structure.md b/skills/hallmark/references/structure.md
similarity index 100%
rename from references/structure.md
rename to skills/hallmark/references/structure.md
diff --git a/references/study.md b/skills/hallmark/references/study.md
similarity index 100%
rename from references/study.md
rename to skills/hallmark/references/study.md
diff --git a/references/typography.md b/skills/hallmark/references/typography.md
similarity index 100%
rename from references/typography.md
rename to skills/hallmark/references/typography.md
diff --git a/references/verbs/audit.md b/skills/hallmark/references/verbs/audit.md
similarity index 100%
rename from references/verbs/audit.md
rename to skills/hallmark/references/verbs/audit.md
diff --git a/references/verbs/redesign.md b/skills/hallmark/references/verbs/redesign.md
similarity index 100%
rename from references/verbs/redesign.md
rename to skills/hallmark/references/verbs/redesign.md