YoussefandClaude Opus 4.7 dcd45e21d7 Smart placeholders + mobile-responsiveness gates (skill v1.x)
Two enhancements that surfaced from real use of v1.0:

PLACEHOLDERS — imagery decisions are now explicit, not fuzzy.

· hero-enrichment.md gains an "Image-need detection" table at the
  top. Brief signals map to image strategy: e-commerce / photography
  / food / team / travel / news → photographic placeholders;
  SaaS / manifesto / agency / editorial → kit-led imagery; API /
  docs / dev-tool / editorial-essay → no imagery; default →
  typography-only. Rules call out: never overwrite user-supplied
  assets; ask one short question on ambiguity; never invent stock
  photos as if they were the final design.

· assets.md gains a "Placeholder strategy" section listing the
  source canon in order: Hallmark imagery kit > hand-built SVG >
  Picsum (deterministic seed) > Unsplash (keyword-anchored) >
  local public/placeholder fallback. Swappability rules are
  non-negotiable: TODO comments, single --placeholder-base
  constant, alt text describing intended subject not the
  placeholder.

· imagery-kit.md is new. The skill ships a manifest pointing at
  curated abstract assets hosted on the marketing site
  (hallmark-murex.vercel.app/imagery/<category>/<file>) — six
  categories: watercolor washes, transparent abstract objects,
  editorial ornaments, texture/grain overlays, generic product
  silhouettes, pattern fields. The skill stays binary-free; the
  output references images by absolute URL with graceful fallback
  to hand-built SVG when the asset 404s. Includes CSS recipes for
  layered hero composition (transparent PNG, large, off-centre,
  z-index 0 behind text), section background wash, decoration,
  texture overlay, empty state. Anti-patterns: don't use kit as
  literal subject, don't layer 3+ pieces, don't apply same wash
  to multiple sections, don't use kit imagery in modern-minimal
  genre.

· SKILL.md Step 4 wires the heuristic — "First, does the brief
  need imagery at all?" runs before tier selection, defaults to
  typography-only.

MOBILE — the responsiveness pass is now codified as gates.

· slop-test.md adds gates 61–65 covering the patterns the
  marketing-site responsiveness fix uncovered: image-bearing grid
  tracks must use minmax(0, 1fr) (61), root must have overflow-x:
  clip on html and body (62), display headers wrap inside long
  words via overflow-wrap: anywhere (63), per-theme section-head
  overrides include mobile collapse (64), CSS-only radio tab
  patterns must not scroll-jump (65). New stamp line: mobile:
  pass (36, 59, 61–65).

· responsive.md grows a "Mobile — non-negotiable" section at the
  top that consolidates all seven mobile gates as a hard floor.
  Test at 320 / 375 / 414 / 768 px before marking complete.

· SKILL.md Discipline 5 expanded — was just "clickable text never
  wraps" (gate 59), now broader "mobile responsiveness — every
  emit verified at 320/375/414/768" naming all seven gates.

Skill total grew from 6633 → 6890 lines (+257, ~4%). The new
imagery-kit.md is 170 lines, larger than the original ~55-line
plan because it ships the actual CSS recipes for layered hero
composition, section wash, texture overlay, and empty state — the
implementation-grade detail required to hit the "professional
frontend engineer" bar set in the plan.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-06 11:38:06 +01:00
2026-04-27 21:46:57 +01:00

Hallmark

A design skill for Claude Code, Cursor, and Codex that refuses to look AI-generated.

Live demo →  ·  twenty-three themes  ·  five verbs  ·  press T to cycle.

Powered by Together AI.

Static Hour — atmospheric podcast platform on dark canvas, italic editorial serif NAJM — Moroccan fashion brand, oversized condensed sans with bright accent
Tally — modern-minimal billing platform, live invoice card and chart Nexus — developer tool, split hero with italic-emphasis sans

Hallmark encodes the anti-AI-slop consensus — typography, colour, layout, motion, microinteractions, structural variety — into one opinionated rule-set. It picks a macrostructure for the brief, dresses it in one of twenty-three themes, runs sixty slop-test gates plus a pre-emit self-critique before handing back, and refuses the on-distribution defaults every LLM was trained into.

v1.0.0 — pre-emit critique on six axes, honest-copy enforcement, locked-token discipline, re-drawn-chrome ban, and a no-wrap rule for clickable text. Five new slop-test gates (5660). The full rule-set lives in skill/SKILL.md and skill/references/.


Try it

Paste this into Claude Code, Cursor, or Codex with the Hallmark skill installed:

"Build me a landing page for Coffeebox — a small-batch coffee subscription. Roast on Sunday, ship on Monday, drink Tuesday. Audience: people who already buy good coffee. Tone: warm, hand-set, editorial."

If Hallmark is wired correctly, you'll see Long Document · Linen (warm-paper roman-serif) · Tier-B hand-built SVG. Eight more worked briefs are documented in docs/recipes.md — copy/paste them to discover the skill before reading anything else.


What's distinct — quick map vs the field

Hallmark frontend-design (Anthropic) Open Design Dembrandt
Source of taste extracts DNA from a screenshot you admire (study verb) art-director brief + ban list menu of 72 brand presets (Linear, Stripe, Vercel, Notion…) scrapes a live URL, emits computed tokens
Output unit macrostructure + theme + custom-craft bans + brief framing preset application DTCG tokens.json
Refuses font ID yes — names role, never guesses n/a n/a n/a (computes from CSS)
Refuses pixel-clone yes — DNA only, never pixels n/a n/a n/a (full token export)
Tactile-rebellion alignment warm-paper, custom-craft, slopless canon strong medium none — token-only
Pages by archetype 21 named macrostructures, picked per brief by brief 5 deterministic directions n/a
Verbs 5 (default · audit · refine · redesign · study) 1 31 1 (CLI)

Hallmark's edge is study — every other tool ships a preset menu or a scraper. Hallmark is the only one that takes a screenshot of a design you admire, names what it sees, refuses paid-template-marketplace listings, and rebuilds your content with the extracted DNA. Three worked study examples in docs/study-examples.md.


Five verbs

Verb What it does
(default) Build new UI. Asks for audience + use + tone (skippable — the skill states what it inferred). Picks a macrostructure, applies the rule-set, runs the slop test before handing back.
hallmark audit <target> Score existing code against the named anti-patterns + structural sameness. Punch list, no edits.
hallmark refine <target> Polish in place. Smallest possible diff. Preserves structure.
hallmark redesign <target> [--mood <name>] Throw out the structure, keep copy + IA + brand, rebuild with a deliberately different fingerprint.
hallmark study <screenshot> The differentiator. Extract the DNA from a design the user admires — macrostructure, archetypes, type-pairing role, colour anchor — and produce a diagnosis report. Optionally rebuild the user's content using the extracted DNA. Refuses paid templates and competitor pages. Names font roles, never font IDs. Never copies pixels.

Eight pages, eight different shapes

Generated by exercising the skill across contrasting briefs. No two share a macrostructure or theme.

Tide — Quote-Led + Atelier Streampipe — Workbench + Terminal Maple Street Bread — Long Document + Linen Meridian — Manifesto + Manifesto
Tide
Quote-Led · Atelier · indie podcast
Streampipe
Workbench · Terminal · CSS-art mockup
Maple Street Bread
Long Doc · Linen · hand-built SVG loaf
Meridian
Manifesto · 11-section practice
Tracejam — Bento Grid + Pastel Anya — Long Document + Studio Foundry — Stat-Led + Plain (pure white) Cohort — Marquee Hero + Salon
Tracejam
Bento · Pastel · clipped-edge mockup
Anya
Long Doc · Studio · personal one-pager
Foundry
Stat-Led · Plain (#fff) · animated counter
Cohort
Marquee Hero · Salon · continuous scroll

Each page is its own self-contained HTML + CSS — no shared theme, no shared layout. Every one carries a /* Hallmark · macrostructure: … */ stamp at the top of its CSS. See the full set under site/_tests/ or live at hallmark-murex.vercel.app.


What's inside

  • SKILL.md — the routing file. Six-step design flow (including Step 2.5 · Check project memory reading .hallmark/log.json), 55-gate slop test, output contract, always-on tokens.css export.
  • references/ — short, opinionated rule files: typography, colour, layout, motion, microinteractions, interaction-and-states (with the input-state checklist), responsive, copy, anti-patterns, the 21 named macrostructures, the 40 component archetypes with variation knobs (9 hero · 6 feature · 4 CTA · 4 testimonial · 8 footer · 9 nav), the 4 hero polish patterns (in hero-enrichment.md), the 6 primitive structure axes, the vision-extraction protocol for study, hero enrichment, custom-craft (CSS art over Lottie), assets, the slop-test gates, four genre rule-overlays (each with nav + footer voice routing), per-verb dispatchers, and the export-formats reference (Tailwind / DTCG / shadcn / tokens.css).
  • docs/ — human-reading content: recipes.md (8 worked briefs + a canonical try-it prompt) and study-examples.md (3 worked DNA-extractions). Not auto-loaded by the skill.
  • site/ — a self-demonstrating landing page. Hand-written HTML + CSS + ES module, no framework, no build step. Twenty-two themes clustered into four genres: editorial (Specimen, Atelier, Newsprint, Salon, Linen, Almanac, Garden, Studio, Sport, Riso, Brutal, Manifesto), modern-minimal (Quiet, Coral, Violet), atmospheric (Midnight, Terminal, Bloom, Aurora, Halo), playful (Pastel, Plume). Switching themes literally rebuilds the page — different hero archetype, different footer archetype, different nav archetype.

What's distinct (the long list)

  • One skill, five verbs. Not eighteen commands.
  • Genres broaden the range. Hallmark routes a brief through one of four genres before picking a theme: editorial (default · the canonical anti-slop voice), modern-minimal (Stripe / Linear / ElevenLabs school), atmospheric (Suno / Runway / dark-AI-tool school), playful (post-Linear soft school). Each genre is its own rule overlay — atmospheric allows radial blooms; modern-minimal allows pure white and pill CTAs; editorial bans both. Detection is signal-based, silent default to editorial.
  • Tone is a first-class decision. "Clean and modern" is rejected. Pick an extreme — editorial · brutalist · soft · technical · luxury · playful · austere.
  • Macrostructures over axes. Pick one of 21 named whole-page shapes wholesale; the macrostructure stamp lives in the CSS comment, so the next Hallmark run picks something different.
  • Within-archetype variation. Two Bento Grids should not be twins; each archetype has 23 picked-per-output knobs.
  • Microinteractions as discipline. Silent success over celebratory toasts. Optimistic update + Undo over confirm dialogs. Hover delay 800 ms, focus delay 0 ms.
  • A 55-gate slop test runs before every output. One yes fails the build. Recent additions: typography discipline gates (3940: max three font families per page, outlier face used in ≤ 2 slots), input-state gates (4145: no border-width layout shift, focus ring via outline not border, input height matches button height, helper-text slot reserves height, disabled state needs three independent signals), contrast gates (4650: APCA / WCAG thresholds, accent-ink token requirement, dark-section ink-on-ink check), and nav · footer · hero structural gates (5155: AI nav fingerprint, AI footer fingerprint, hero centred-everything, hero padding asymmetry, decorative-without-purpose).
  • Project memory. A per-project .hallmark/log.json records each run's macrostructure + theme + enrichment + brief summary. The skill reads the last 35 entries before picking and writes a new entry after each build, so consecutive Hallmark outputs in the same project don't repeat shapes or themes.
  • Theme-diversification rule. Two consecutive themes must differ on at least one of three axes: paper band (dark / mid / light), display style (italic-serif / roman-serif / geometric-sans / mono / display-heavy / system-native), accent hue (warm / cool / neutral / chromatic-other).
  • Voice fixtures over LLM defaults. Each of the 21 macrostructures ships with 23 example opening lines tuned to its tone. "Built for the modern team" is in the banned-phrases list.
  • Hero enrichment is opt-in. A typographic-only hero is always acceptable. When enrichment is right, the skill picks from a six-tier hierarchy: typography only → custom-built CSS art → hand-built SVG → generated illustration (Nanobanana / Recraft) → library → Lottie (last resort).
  • Microinteractions default-on for SaaS-shaped archetypes. Bento Grid, Stat-Led, Workbench, Marquee Hero pages ship with 23 purposeful microinteractions (number reveal, pricing lift, marquee, stagger) without the user having to ask. Editorial / Manifesto / Letter / Quote-Led pages stay still.
  • SaaS page sequence. Hero → social proof → features → testimonials → pricing → FAQ → CTA → footer. Real prices, not "contact sales for pricing." Specific testimonials with role + company.
  • Wordmark may use a different display face. A Geist-bodied SaaS page can set its wordmark in Fraunces. Same-family collapse on Bento / Stat-Led / Workbench / Marquee Hero is the new "un-branded" tell.
  • study extracts DNA, not pixels. Refusal heuristics, type-role vocabulary (no font ID guessing), confirmation step before any code. Three worked examples in docs/study-examples.md.

Install

npx skills add hallmark

Or copy skill/ into ~/.claude/skills/hallmark/ (Claude Code) or .cursor/rules/hallmark.mdc (Cursor — body of SKILL.md, no frontmatter).

To preview the landing page locally:

cd site && python3 -m http.server 4173    # → http://localhost:4173

Press T to cycle themes, the shuffle button (or R) to randomise, ?theme=studio for a shareable link.

Or visit the live deploy at hallmark-murex.vercel.app.


Licence

MIT. Use it, fork it, ship it.

S
Description
No description provided
Readme MIT
97 MiB
Languages
CSS 58.4%
HTML 35.1%
JavaScript 6.5%