mirror of
https://github.com/Nutlope/hallmark.git
synced 2026-08-14 12:35:33 +02:00
## What shipped (Tier 1 of the brainstorm) 1. **Visual-first README** — replaces the text-only top with a 4-up theme grid (Specimen / Studio / Brutal / Newsprint) and an 8-cell test-page mosaic (Tide → Cohort) using the existing thumbnails. First impression becomes *visual* rather than a wall of bullets. 2. **Try-it prompt at the top** — the Coffeebox brief is now the canonical first thing visitors paste to verify the skill is wired correctly. References the new `recipes.md` directly. 3. **Comparison table vs the field** — Hallmark vs Anthropic frontend-design, nexu-io Open Design, Dembrandt. Positions Hallmark's `study` as the differentiator (everyone else ships preset menus or scrapers). 4. **`study` repositioned as the headline verb** — bolded in the verbs table, has its own lead-paragraph in the hero, links to the new `study-examples.md` for worked DNA-extractions. 5. **Canonical 2026 vocabulary** in the README opening: "tactile rebellion" (Creative Bloq's SEO term), "anti-AI-slop" (925studios canon), "custom-craft" (the Lottie-as-last-resort stance). Cited. ## New reference files ### `skill/references/recipes.md` (~140 lines) Eight worked briefs + a canonical try-it prompt. Each shows: prompt verbatim, inferred trio (audience/use/tone), picked macrostructure + theme + enrichment, and a one-paragraph excerpt of the output. The first recipe (Coffeebox) is the canonical try-it prompt the README points users at. Recipes 01–08 are the existing eight test pages, normalised to the same four-line format. ### `skill/references/study-examples.md` (~210 lines) Three worked DNA-extractions of `study`: - **Example A** — Pentagram-style editorial portfolio: extracts Specimen macrostructure + italic-display + warm-orange accent + sparse density. Refuses font ID. Notes two anti-patterns to NOT carry over. - **Example B** — Klim-Type-Foundry-style specimen: Type Specimen + display- heavy + dark-paper + chromatic-other accent. Single-font specimen page. Suggests hybrid (Specimen homepage + Workbench for case studies). - **Example C** — Rauno-Freiberg-style personal site: refuse-or-proceed check fires (competitor portfolio). After user confirms public reference, extracts Long Document + centred demo + dark-cool paper + chromatic-other green accent. Notes one anti-pattern to fix (no reduced-motion fallback). Each example follows the same four-step protocol: refuse-or-proceed → diagnose → confirm → build. Demonstrates the skill's discipline that `study` extracts DNA, not pixels. ## SKILL.md updates - Adds `recipes.md` and `study-examples.md` to the references list with load-on-demand notes (when the user asks "what does Hallmark output look like?" → load recipes; when running `study` → load study-examples). - No version bump (no behavioural change yet). ## docs/ New `docs/img/` folder with four theme captures at 900px wide: - theme-specimen.png — warm cream + italic Fraunces + warm-orange - theme-studio.png — cool grey + italic Fraunces + forest-green - theme-brutal.png — stark white-and-black + Inter Tight 900 - theme-newsprint.png — warm cream + Playfair Display + deep red These sit in the README hero <table> for the 4-up grid. ## Skill files mirrored cp SKILL.md, recipes.md, study-examples.md to ~/.claude/skills/hallmark/. References dir now has 18 files (was 16). ## Plan file updated `/Users/youssef/.claude/plans/...` rewritten with concrete Tier 2 (DTCG tokens.json export · macrostructure rotation hints · ASCII preview block) and Tier 3 (theme knobs · pre-flight inference · Figma MCP recipe) implementation specs. Each item has scope, file budget, verification, and recommended order. Ready to execute when the user wants either tier. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>