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.3K ·GitHub
这是什么?Hallmark 是一个面向 AI 编程工具——Claude Code、Cursor 和 Codex——的设计技能,用来生成看不出是 AI 做的网页界面。它由 Together AI 出品。
所以它不是一个能直接运行的应用——它怎么接入我的编程工具?它以技能的形式提供:一份 SKILL.md 规则集,加上一个存放设计规则的 references/ 文件夹。你把它们复制到编程工具的配置目录里,之后工具每次生成界面时都会遵循这些规则。
怎么在 Claude Code、Cursor 或 Codex 上安装它?把 SKILL.md 和 references/ 复制到对应工具的目录:Claude Code 是 ~/.claude/skills/hallmark/,Cursor 是 .cursor/rules/hallmark.mdc,Codex 是 ~/.codex/skills/hallmark/。想更新就重新执行一次安装。
如果我对现有的页面运行检查,它会改动我的代码吗?不会——'hallmark audit' 只会给代码打分并返回一份待办清单,绝不会动手改代码。想真正修改,需要用默认的构建命令或 'hallmark redesign'。
如果目录里的 21 个主题都不符合我的需求,会怎样?Hallmark 会切换到 Custom 模式,从零开始设计页面——自己配色、选字体、定布局——同时照样跑完全部 57 项 AI 味检测关卡。它会保持为一个安静的分支,普通需求永远不会碰到它。
如果我让 hallmark study 分析一个我很喜欢的设计,它会照抄吗?不会——它提取的是设计基因(整体结构、字体搭配、色彩基调),并且拒绝像素级复刻和付费模板。它还能输出一份可移植的 design.md,方便你交给其他 AI 工具使用。
安装之前,在哪里能看到 Hallmark 生成过的真实页面?可以浏览 usehallmark.com 上的在线演示,或者看仓库里的 site/tests/ 文件夹,里面收录了各种不同需求生成的示例页面;更完整的实例在 docs/recipes.md 和 docs/study-examples.md 里。
Creator
Nutlope
Size
88.3 MB
Stars
30.3K
Updated
CommitAug 06
Age
5mo
Commits · 90 Days