hallmark README

The project's README from github.com/Nutlope/hallmark. As one markdown file: README.md.

Hallmark

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

Live demo →  ·  twenty-one themes  ·  four verbs  ·  press T to cycle.

Made by Together AI.

Hallmark, a design skill that refuses to look AI-generated

Hallmark picks a macrostructure for the brief, dresses it in one of twenty-one themes, runs fifty-seven 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.

Four 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.

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 guided sourdough app hero Distil content-extraction API hero Cold Snap record-label EP hero Cinder AI reasoning tool hero
Bubble
Sourdough app · Hum		 Distil
Extraction API · Cobalt		 Cold Snap
Record label · Carnival		 Cinder
AI tool · Lumen
Ferns and Fathom tea menu hero Hollowback Apiary honey farm hero Off-Register risograph print fair hero Press Quaternary type studio hero
Ferns & Fathom
Tea menu · Custom		 Hollowback Apiary
Honey farm · Garden		 Off-Register
Print fair · Riso		 Press Quaternary
Type studio · Custom
Tally SaaS product page hero Wayfare travel booking hero NAJM Moroccan fashion brand hero Hyperlane developer infrastructure hero
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 NEW

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 57 slop-test gates, no template underneath.

The Cascadia Nightjar sleeper-train ticket hero The Mend Assembly repair-café broadsheet hero
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.

Install

npx skills add nutlope/hallmark

Re-run any time to update. Or copy SKILL.md + references/ into:

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.

hallmark (Nutlope/hallmark)

Searching Database…

30.2K ·GitHub
Hallmark
What is this?Hallmark is a design skill for AI coding agents — Claude Code, Cursor, and Codex — that generates web UI built to not look AI-generated. It is made by Together AI.
So it's not an app I run — how does it plug into my coding agent?It ships as a skill: a SKILL.md rule-set plus a references/ folder of design rules that you copy into your agent's config directory, and the agent then follows them whenever it builds UI.
How do I install it for Claude Code, Cursor, or Codex?Copy SKILL.md + references/ into the agent's folder: ~/.claude/skills/hallmark/ (Claude Code), .cursor/rules/hallmark.mdc (Cursor), or ~/.codex/skills/hallmark/ (Codex). Re-run the install to update.
If I run an audit on my existing page, will it rewrite my code?No — 'hallmark audit' only scores the code and returns a punch list, it never edits. For actual changes you would use the default build verb or 'hallmark redesign'.
What happens when none of the 21 catalog themes fit my brief?Hallmark switches to Custom and designs the page from scratch — its own palette, type, and layout — while still running all 57 slop-test gates. It stays a quiet branch that plain briefs never see.
If I point hallmark study at a design I admire, will it copy it?No — it extracts the design DNA (macrostructure, type-pairing, colour anchor) and refuses pixel-clones and paid templates. It can also emit a portable design.md you can hand off to other AI tools.
Where can I see real pages Hallmark has generated before installing?Browse the live demo at usehallmark.com or the site/tests/ folder in the repo, which holds sample pages from many different briefs; worked examples also live in docs/recipes.md and docs/study-examples.md.
What are similar projects?taste-skill, oil-ui, awesome-claude-design, transitions.dev, evondevKit, impeccable, anti-slop, refactoring-ui-skill
Which topics is it in?web-design, ui-design, design-system, ai-coding, theme, claude-skills, design, skill, cursor, css, html, coding-agent
Creator
Nutlope
Size
88.3 MB
Stars
30.2K
Updated
CommitAug 06
Age
5mo
Commits · 90 Days