From 3ec017389672dcf96fc536a498aa990e0cfabdeb Mon Sep 17 00:00:00 2001 From: Youssef Date: Tue, 26 May 2026 12:07:51 +0100 Subject: [PATCH] =?UTF-8?q?Install=20=C2=B7=20scope=20the=20skill=20to=20s?= =?UTF-8?q?kills/hallmark/=20(fixes=20#9)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The skills CLI copies everything under the directory containing SKILL.md. With SKILL.md at the repo root, installs were pulling in docs/, site/, package.json, README, ROADMAP, vercel.json, LICENSE. Moving the skill into skills/hallmark/ scopes the install to just SKILL.md + references/. The CLI's priority search hits skills/ first, so `npx skills add nutlope/hallmark` is unchanged. Updated README install paths, package.json (entry/references/files), and the internal links that crossed the new boundary. --- README.md | 4 ++-- ROADMAP.md | 4 ++-- package.json | 7 +++---- site/_tests/custom/README.md | 4 ++-- site/_tests/verbs/audit/audit-report.md | 6 +++--- site/_tests/verbs/study/diagnosis.md | 10 +++++----- site/_tests/verbs/study/notes.md | 20 +++++++++---------- SKILL.md => skills/hallmark/SKILL.md | 6 +++--- .../hallmark/references}/anti-patterns.md | 0 .../hallmark/references}/assets.md | 0 .../hallmark/references}/color.md | 0 .../references}/component-cookbook.md | 0 .../components/c1-outlined-chip.md | 0 .../components/c2-inline-form-as-cta.md | 0 .../components/c3-typographic-link.md | 0 .../components/c4-sticky-bottom-bar.md | 0 .../references}/components/f1-bento-grid.md | 0 .../components/f2-sticky-scroll-stack.md | 0 .../components/f3-tabular-spec-sheet.md | 0 .../components/f4-step-sequence.md | 0 .../components/f5-annotated-screenshot.md | 0 .../components/f6-product-card-grid.md | 0 .../references}/components/ft1-mast-headed.md | 0 .../components/ft2-inline-rule-single-line.md | 0 .../ft3-index-style-category-list.md | 0 .../components/ft4-dense-typographic.md | 0 .../references}/components/ft5-statement.md | 0 .../components/ft6-letter-close.md | 0 .../components/ft7-newsletter-first.md | 0 .../components/ft8-marquee-scroll.md | 0 .../references}/components/h1-marquee.md | 0 .../components/h2-split-diptych.md | 0 .../references}/components/h3-quote-led.md | 0 .../references}/components/h4-stat-led.md | 0 .../references}/components/h5-letter-hero.md | 0 .../components/h6-photographic-fold.md | 0 .../h7-demo-video-clipped-by-viewport-edge.md | 0 .../h8-mockup-split-browser-framed.md | 0 .../h9-custom-illustration-centerpiece.md | 0 .../components/n1-wordmark-2-links.md | 0 .../n10-floating-on-scroll-morph.md | 0 .../components/n2-floating-chip.md | 0 .../references}/components/n3-side-rail.md | 0 .../components/n4-hidden-behind-k.md | 0 .../components/n5-floating-pill.md | 0 .../components/n6-newspaper-masthead.md | 0 .../references}/components/n7-brutal-slab.md | 0 .../components/n8-terminal-command.md | 0 .../components/n9-edge-aligned-minimal.md | 0 .../components/s1-left-margin-numbered.md | 0 .../references}/components/s2-hanging.md | 0 .../components/s3-sticky-pinned.md | 0 .../components/s4-inline-no-break.md | 0 .../components/s5-bottom-anchored.md | 0 .../t1-pull-quote-with-marginalia.md | 0 .../components/t2-logo-wall-hairline.md | 0 .../components/t3-single-huge-quote.md | 0 .../components/t4-numbered-stat-strip.md | 0 .../hallmark/references}/contract.md | 0 .../hallmark/references}/copy.md | 0 .../hallmark/references}/custom-craft.md | 0 .../hallmark/references}/custom-theme.md | 4 ++-- .../hallmark/references}/design-md.md | 0 .../hallmark/references}/export-formats.md | 0 .../hallmark/references}/floating-nav.md | 0 .../references}/genres/atmospheric.md | 0 .../hallmark/references}/genres/editorial.md | 0 .../references}/genres/modern-minimal.md | 0 .../hallmark/references}/genres/playful.md | 0 .../hallmark/references}/hero-enrichment.md | 4 ++-- .../hallmark/references}/imagery-kit.md | 0 .../references}/interaction-and-states.md | 0 .../hallmark/references}/layout-and-space.md | 0 .../hallmark/references}/macrostructures.md | 0 .../macrostructures/01-bento-grid.md | 0 .../macrostructures/02-long-document.md | 0 .../macrostructures/03-marquee-hero.md | 0 .../macrostructures/04-stat-led.md | 0 .../macrostructures/05-workbench.md | 0 .../macrostructures/06-conversational-faq.md | 0 .../macrostructures/07-manifesto.md | 0 .../macrostructures/08-photographic.md | 0 .../macrostructures/09-quote-led.md | 0 .../macrostructures/10-specimen.md | 0 .../macrostructures/11-catalogue.md | 0 .../references}/macrostructures/12-letter.md | 0 .../macrostructures/13-index-first.md | 0 .../macrostructures/14-narrative-workflow.md | 0 .../macrostructures/15-split-studio.md | 0 .../macrostructures/16-feature-stack.md | 0 .../macrostructures/17-type-specimen.md | 0 .../macrostructures/18-portfolio-grid.md | 0 .../macrostructures/19-map-diagram.md | 0 .../macrostructures/20-ecosystem-index.md | 0 .../21-component-playground.md | 0 .../hallmark/references}/microinteractions.md | 0 .../hallmark/references}/motion.md | 0 .../hallmark/references}/preview-examples.md | 0 .../hallmark/references}/responsive.md | 0 .../hallmark/references}/slop-test.md | 0 .../hallmark/references}/structure.md | 0 .../hallmark/references}/study.md | 0 .../hallmark/references}/typography.md | 0 .../hallmark/references}/verbs/audit.md | 0 .../hallmark/references}/verbs/redesign.md | 0 105 files changed, 34 insertions(+), 35 deletions(-) rename SKILL.md => skills/hallmark/SKILL.md (99%) rename {references => skills/hallmark/references}/anti-patterns.md (100%) rename {references => skills/hallmark/references}/assets.md (100%) rename {references => skills/hallmark/references}/color.md (100%) rename {references => skills/hallmark/references}/component-cookbook.md (100%) rename {references => skills/hallmark/references}/components/c1-outlined-chip.md (100%) rename {references => skills/hallmark/references}/components/c2-inline-form-as-cta.md (100%) rename {references => skills/hallmark/references}/components/c3-typographic-link.md (100%) rename {references => skills/hallmark/references}/components/c4-sticky-bottom-bar.md (100%) rename {references => skills/hallmark/references}/components/f1-bento-grid.md (100%) rename {references => skills/hallmark/references}/components/f2-sticky-scroll-stack.md (100%) rename {references => skills/hallmark/references}/components/f3-tabular-spec-sheet.md (100%) rename {references => skills/hallmark/references}/components/f4-step-sequence.md (100%) rename {references => skills/hallmark/references}/components/f5-annotated-screenshot.md (100%) rename {references => skills/hallmark/references}/components/f6-product-card-grid.md (100%) rename {references => skills/hallmark/references}/components/ft1-mast-headed.md (100%) rename {references => skills/hallmark/references}/components/ft2-inline-rule-single-line.md (100%) rename {references => skills/hallmark/references}/components/ft3-index-style-category-list.md (100%) rename {references => skills/hallmark/references}/components/ft4-dense-typographic.md (100%) rename {references => skills/hallmark/references}/components/ft5-statement.md (100%) rename {references => skills/hallmark/references}/components/ft6-letter-close.md (100%) rename {references => skills/hallmark/references}/components/ft7-newsletter-first.md (100%) rename {references => skills/hallmark/references}/components/ft8-marquee-scroll.md (100%) rename {references => skills/hallmark/references}/components/h1-marquee.md (100%) rename {references => skills/hallmark/references}/components/h2-split-diptych.md (100%) rename {references => skills/hallmark/references}/components/h3-quote-led.md (100%) rename {references => skills/hallmark/references}/components/h4-stat-led.md (100%) rename {references => skills/hallmark/references}/components/h5-letter-hero.md (100%) rename {references => skills/hallmark/references}/components/h6-photographic-fold.md (100%) rename {references => skills/hallmark/references}/components/h7-demo-video-clipped-by-viewport-edge.md (100%) rename {references => skills/hallmark/references}/components/h8-mockup-split-browser-framed.md (100%) rename {references => skills/hallmark/references}/components/h9-custom-illustration-centerpiece.md (100%) rename {references => skills/hallmark/references}/components/n1-wordmark-2-links.md (100%) rename {references => skills/hallmark/references}/components/n10-floating-on-scroll-morph.md (100%) rename {references => skills/hallmark/references}/components/n2-floating-chip.md (100%) rename {references => skills/hallmark/references}/components/n3-side-rail.md (100%) rename {references => skills/hallmark/references}/components/n4-hidden-behind-k.md (100%) rename {references => skills/hallmark/references}/components/n5-floating-pill.md (100%) rename {references => skills/hallmark/references}/components/n6-newspaper-masthead.md (100%) rename {references => skills/hallmark/references}/components/n7-brutal-slab.md (100%) rename {references => skills/hallmark/references}/components/n8-terminal-command.md (100%) rename {references => skills/hallmark/references}/components/n9-edge-aligned-minimal.md (100%) rename {references => skills/hallmark/references}/components/s1-left-margin-numbered.md (100%) rename {references => skills/hallmark/references}/components/s2-hanging.md (100%) rename {references => skills/hallmark/references}/components/s3-sticky-pinned.md (100%) rename {references => skills/hallmark/references}/components/s4-inline-no-break.md (100%) rename {references => skills/hallmark/references}/components/s5-bottom-anchored.md (100%) rename {references => skills/hallmark/references}/components/t1-pull-quote-with-marginalia.md (100%) rename {references => skills/hallmark/references}/components/t2-logo-wall-hairline.md (100%) rename {references => skills/hallmark/references}/components/t3-single-huge-quote.md (100%) rename {references => skills/hallmark/references}/components/t4-numbered-stat-strip.md (100%) rename {references => skills/hallmark/references}/contract.md (100%) rename {references => skills/hallmark/references}/copy.md (100%) rename {references => skills/hallmark/references}/custom-craft.md (100%) rename {references => skills/hallmark/references}/custom-theme.md (98%) rename {references => skills/hallmark/references}/design-md.md (100%) rename {references => skills/hallmark/references}/export-formats.md (100%) rename {references => skills/hallmark/references}/floating-nav.md (100%) rename {references => skills/hallmark/references}/genres/atmospheric.md (100%) rename {references => skills/hallmark/references}/genres/editorial.md (100%) rename {references => skills/hallmark/references}/genres/modern-minimal.md (100%) rename {references => skills/hallmark/references}/genres/playful.md (100%) rename {references => skills/hallmark/references}/hero-enrichment.md (97%) rename {references => skills/hallmark/references}/imagery-kit.md (100%) rename {references => skills/hallmark/references}/interaction-and-states.md (100%) rename {references => skills/hallmark/references}/layout-and-space.md (100%) rename {references => skills/hallmark/references}/macrostructures.md (100%) rename {references => skills/hallmark/references}/macrostructures/01-bento-grid.md (100%) rename {references => skills/hallmark/references}/macrostructures/02-long-document.md (100%) rename {references => skills/hallmark/references}/macrostructures/03-marquee-hero.md (100%) rename {references => skills/hallmark/references}/macrostructures/04-stat-led.md (100%) rename {references => skills/hallmark/references}/macrostructures/05-workbench.md (100%) rename {references => skills/hallmark/references}/macrostructures/06-conversational-faq.md (100%) rename {references => skills/hallmark/references}/macrostructures/07-manifesto.md (100%) rename {references => skills/hallmark/references}/macrostructures/08-photographic.md (100%) rename {references => skills/hallmark/references}/macrostructures/09-quote-led.md (100%) rename {references => skills/hallmark/references}/macrostructures/10-specimen.md (100%) rename {references => skills/hallmark/references}/macrostructures/11-catalogue.md (100%) rename {references => skills/hallmark/references}/macrostructures/12-letter.md (100%) rename {references => skills/hallmark/references}/macrostructures/13-index-first.md (100%) rename {references => skills/hallmark/references}/macrostructures/14-narrative-workflow.md (100%) rename {references => skills/hallmark/references}/macrostructures/15-split-studio.md (100%) rename {references => skills/hallmark/references}/macrostructures/16-feature-stack.md (100%) rename {references => skills/hallmark/references}/macrostructures/17-type-specimen.md (100%) rename {references => skills/hallmark/references}/macrostructures/18-portfolio-grid.md (100%) rename {references => skills/hallmark/references}/macrostructures/19-map-diagram.md (100%) rename {references => skills/hallmark/references}/macrostructures/20-ecosystem-index.md (100%) rename {references => skills/hallmark/references}/macrostructures/21-component-playground.md (100%) rename {references => skills/hallmark/references}/microinteractions.md (100%) rename {references => skills/hallmark/references}/motion.md (100%) rename {references => skills/hallmark/references}/preview-examples.md (100%) rename {references => skills/hallmark/references}/responsive.md (100%) rename {references => skills/hallmark/references}/slop-test.md (100%) rename {references => skills/hallmark/references}/structure.md (100%) rename {references => skills/hallmark/references}/study.md (100%) rename {references => skills/hallmark/references}/typography.md (100%) rename {references => skills/hallmark/references}/verbs/audit.md (100%) rename {references => skills/hallmark/references}/verbs/redesign.md (100%) 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: . Theme: . Differs from the last on: ." 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: ` 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: ` 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
@@ -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