Youssef
30c55128b2
Hallmark stops targeting open-weight models and goes deep on the three terminals where design work happens: Claude Code, Codex CLI, and OpenCode. Same core everywhere (SKILL.md standard), plus a per-harness adapter each harness loads before Step 0. - references/harnesses/codex.md: $hallmark invocation, workspace-write sandbox + network-off reality (picker server asks first, --static fallback), no hooks/subagents (sequential variants + progressive reveal), AGENTS.md as a Step 0 signal, batch-per-direction patches - references/harnesses/opencode.md: /hallmark + skill-tool invocation, allow/ask/deny permission model, parallel variants via its subagents, formatter/LSP interplay, compatibility-path discovery - references/models.md deleted; its harness-agnostic rules live on in both adapters. SKILL.md dispatch now routes by harness, not by model family - agents/openai.yaml: Codex interface + implicit-invocation policy - scripts/install.mjs: detects installed harnesses and installs a lean 1.5MB payload (SKILL.md, references, scripts, agents, LICENSE - never site/ or eval/) to ~/.claude/skills, ~/.agents/skills (+ refreshes the stale legacy ~/.codex/skills copy), and leaves OpenCode to its compatibility discovery; --dry-run / --remove / idempotent - README: 'Open models' section replaced by 'One skill, three harnesses' with the install matrix; ROADMAP and eval/README reframed (Tier B kept as archive only); version 1.4.0 Ran the installer live: all three locations now serve 1.4.0 with the adapters in place (the Codex location previously held a 27MB v1.0.0 copy).
10 KiB
Hallmark
A design skill for Claude Code, Cursor, and Codex that refuses to look AI-generated.
Live demo → · twenty-four themes · five verbs · press T to cycle.
Made by Together AI.
Hallmark picks a macrostructure for the brief, dresses it in one of twenty-four themes, runs fifty-eight slop-test gates plus a pre-emit self-critique, and refuses the on-distribution defaults every LLM was trained into. Two pages by Hallmark for two different briefs feel like different sites, not colour-swaps of the same template.
Five verbs
| Verb | What it does |
|---|---|
| (default) | Build new UI. Picks a macrostructure, applies the rule-set, runs the slop test before handing back. |
hallmark audit <target> |
Score existing code against the anti-patterns. Punch list, no edits. |
hallmark redesign <target> |
Throw out the structure, keep copy + IA + brand, rebuild with a different fingerprint. |
hallmark study <screenshot | URL> |
Extract the DNA from a design you admire: macrostructure, type-pairing, colour anchor. Refuses pixel-clones and paid templates. Optionally emits a portable design.md for handoff to other AI tools. |
hallmark variants <brief> |
Three structurally distinct directions for one brief, rendered live. Flip through them in a picker over your own localhost, pick one, keep building. |
Different briefs, different shapes
Each generated from a different brief. The skill picks the theme, structure, and craft to fit each one, not from a template.
 |
 |
 |
 |
| Bubble Sourdough app · Hum |
Distil Extraction API · Cobalt |
Cold Snap Record label · Carnival |
Cinder AI tool · Lumen |
 |
 |
 |
 |
| Ferns & Fathom Tea menu · Custom |
Hollowback Apiary Honey farm · Garden |
Off-Register Print fair · Riso |
Press Quaternary Type studio · Custom |
 |
 |
 |
 |
| Tally SaaS · modern-minimal |
Wayfare Travel · atmospheric |
NAJM Fashion brand |
Hyperlane Dev infrastructure |
Each page is self-contained HTML + CSS, stamped with its macrostructure in the CSS comment. Browse the full set at usehallmark.com or under site/_tests/.
Custom
When a brief carries creative intent that no catalog theme fits, Hallmark switches to Custom and designs the page from scratch: a made-to-measure palette, type, and layout. Same 58 slop-test gates, no template underneath.
In v1.2 the custom route runs a full art-direction ritual: it names and rejects the category's reflex aesthetics, writes a slate of seven grounded directions, and a deterministic draw (scripts/seed.mjs) picks which one gets built, sometimes dealing wildcards from a design-history atlas. A scene sentence sets the light, a colour posture (Restrained · Committed · Full palette · Drenched) sets how far the palette commits, and a five-block direction contract written into the artifact gets audited promise by promise before shipping.
 |
 |
| The Cascadia Nightjar Sleeper-train ticket · Custom |
The Mend Assembly Repair-café broadsheet · Custom |
It stays a quiet branch; vanilla briefs never see it. The protocol lives in custom-theme.md.
Variants NEW
hallmark variants <brief> runs the ceremony once, then builds three structurally distinct directions (different macrostructure, theme, nav, footer) and serves a local picker to flip between them and choose. v2 makes it fast and smooth: the picker opens immediately and fills progressively (you evaluate direction 1 while 2 and 3 finish), directions generate in parallel at sketch depth by default (only the winner completes to full), the grid shows screenshot thumbnails (so it survives dev servers that block iframes), and the verdict can be compositional ("direction 2, but the pricing from 3" grafts that section in). After the pick you can zoom to riff a single section, every round is logged to .hallmark/variants/<run>/decisions.md, and in a Vite/Astro/SvelteKit app a dev-only overlay previews each direction in place. No Node? A static compare page and a chat reply ("pick 2") always work.
One skill, three harnesses NEW
Hallmark is tuned for the three terminals where design work actually happens: Claude Code, Codex CLI, and OpenCode. One shared core (the same SKILL.md, references, gates, and scripts everywhere), plus a per-harness adapter each harness loads on its own: Claude Code runs the skill natively (hooks, subagents, preview pane); Codex reads harnesses/codex.md (sandbox and approval behaviour, sequential variants, $hallmark invocation); OpenCode reads harnesses/opencode.md (permission model, parallel variants via its subagents). The mechanically checkable gates live in a zero-dependency checker every harness can run:
node skills/hallmark/scripts/sloplint.mjs <file-or-dir> --genre <genre>
One command installs a lean copy (skill + references + scripts, ~1.5 MB, never the marketing site) everywhere it belongs:
node skills/hallmark/scripts/install.mjs
| Harness | Install location | Invoke |
|---|---|---|
| Claude Code | ~/.claude/skills/hallmark |
/hallmark <brief> or just describe the build |
| Codex CLI | ~/.agents/skills/hallmark (legacy ~/.codex/skills refreshed too) |
$hallmark <brief> or implicit |
| OpenCode | auto-discovers the copies above via its compatibility paths | /hallmark <brief> or implicit |
The installer detects which harnesses exist, replaces stale copies atomically, and --remove undoes everything.
Edit-time linting NEW
By default the slop test runs once, at the end. On Claude Code you can move it to the keystroke: a PostToolUse hook lints every .html/.css Hallmark artifact the moment it is written and feeds any failures back to the model advisorily, so slop gets fixed while the context is small instead of in a big end-of-run pass.
node skills/hallmark/scripts/install-hook.mjs
--global targets ~/.claude/settings.json (all projects); --print shows the settings block without writing; --remove undoes it. The hook is advisory only: it never blocks or reverts a write, no-ops silently on non-artifacts, and the Step 7 sweep still runs regardless. It is Claude-Code-only (Cursor/Codex have no hook surface and rely on Step 7).
Install
npx skills add nutlope/hallmark
Re-run any time to update. Or copy SKILL.md + references/ into:
- Claude Code:
~/.claude/skills/hallmark/ - Cursor:
.cursor/rules/hallmark.mdc(body ofSKILL.md, no frontmatter; this channel ships no scripts, sovariantspicks by chat reply and the slop test runs fully model-judged) - Codex:
~/.codex/skills/hallmark/(personal) or.codex/skills/hallmark/(project-scoped)
The rule-set lives in SKILL.md and references/. Worked examples in docs/recipes.md and docs/study-examples.md.
Licence
MIT. Use it, fork it, ship it.