Commit Graph
2 Commits
Author SHA1 Message Date
YoussefandClaude Opus 4.7 99e7a065af v0.8 — genres, design.md, lazier loading, two new themes, site rework
Skill:
- Genres (editorial · modern-minimal · atmospheric · playful) as a top-level rule overlay; signal-based detection in Step 1, theme rotation now scoped to the genre's cluster
- `redesign` on a directory or whole project now produces design.md first and locks every page to that system; diversification rule inverts on system-managed projects
- SKILL.md slimmed 532 → ~440 lines: slop-test gates extracted to references/slop-test.md, per-verb sections to references/verbs/, output contract to references/contract.md, with explicit eager / per-build / conditional / end / verb-specific load buckets
- Worked examples (recipes.md, study-examples.md) moved out of skill/references/ into docs/ — no longer auto-loaded
- audit.md gained design.md drift checks (theme drift · macrostructure-family violation · stamp lies · missing system reference)

Site:
- Quiet theme refreshed to ElevenLabs-style polished minimal (Geist, pure white, pill CTAs, two-column hero)
- New Bloom theme — Suno-style atmospheric dark with twin warm radial blooms, Geist display, single warm accent
- Banner additions: sticky Install link, live stamp callout (hover-expands the CSS comment), genre label after the theme name
- T-key onboarding tooltip after 5s idle (localStorage-flagged so it never returns)
- Decision-trail popover on each example tile (600ms hover delay, pure CSS)
- Foundations cut from 8 cards to 5 (Type · Colour · Space · Motion · Voice)
- FAQ section added: 5 typographic Q/A pairs, editorial format, tightened spacing
- Without/With grew from 1 pair to 4 — writing app · dashboard · pricing card · personal site — with a CSS-only tab toggle
- Scroll-jump fix on the W/W tabs: radio inputs no longer position-absolute, so clicking a tab no longer yanks the page back to top
- How-it-works section folded out, content absorbed by FAQ + Install
- 17 themes (was 16); README and skill references updated everywhere

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-01 21:08:42 +01:00
YoussefandClaude Opus 4.7 6b2e701dc6 Tier 1 — visual-first README · recipes.md · study-examples.md · study-led positioning
## 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>
2026-04-30 19:26:38 +01:00