让 Claude Code「写个落地页」,十有八九会交出同一套 AI 审美:六宫格圆角卡片、渐变主按钮、标题里单独上色一个词、底部再来一个邮箱订阅框。功能也许齐全,但一眼就像模板站。Hallmark(作者 @nutlope,usehallmark.com)是 2026 年 GitHub 上热度很高的 Agent Skill:专门教 Claude Code、Codex、Cursor 等客户端按设计规则写网页,并在真浏览器里用 sloplint 自检「AI slop」,直到问题清零。本文说明它能干什么、怎么一行命令装好就用,以及如何与你在 Zilmac 上跑的 Claude Code 工作流衔接;若你还在挑 Skills,可先看Claude Code Skills 2026 推荐清单。
sloplint --render 多宽度浏览器验收目标Hallmark 是什么?解决哪类问题?
Hallmark 不是又一个 UI 组件库,而是一份遵循 Agent Skills 标准的 SKILL.md 工作流:在 Agent 写 HTML/CSS 之前先选主题、定版式,在写完之后用 linter 抓典型「AI 味」——低对比度字叠在图上、并排两个实心主按钮、该放照片的位置却铺渐变、标题 tracked 大写标签等。官方站点对比过:同一 prompt 下,裸 Opus 页面常带二十多处问题,走 Hallmark 主题后可压到 0 issue(以 sloplint 计数为准)。
它和「多写几句 design system prompt」的差别在于:流程被写死进 Skill——问素材、发主题、生成 tokens.css、Hero 优先、再跑浏览器渲染检查。你不需要每次对话重复设计规范。
Hallmark 能干什么:三条主路径
从零写落地页
在 Claude Code 里输入 /hallmark 加产品描述即可。Skill 会先读项目(字体、色板、框架),只问一次真实素材:截图、用户数、定价、受众。然后从你 prompt 里 deal 出 3 套主题(48+ 主题库中匹配),你选定后再写页面。没有截图时它会明说不会编造数字,用占位图代替。
/hallmark 为 [产品名] 做落地页,访客唯一动作是 [预约演示 / 下载 App]。
用我提供的截图 URL,数字只使用我给出的。
只审计、不改文件
已有 AI 生成的 index.html 但不敢动?用 audit 只出报告:
/hallmark audit ./index.html
典型输出是 sloplint 的 FAIL/WARN 列表(社区实测单页可达 40+ FAIL),方便你决定是自己改还是走 redesign。
保留内容与逻辑,重做视觉
对「能跑但很丑」的站点最实用:保留文案、链接、表单字段与脚本挂载,重建视觉层:
/hallmark redesign ./src/app
或指向静态目录 / 单文件。Skill 不会在你没提 redesign / audit 时擅自改已有设计,因此装全局 Skill 也相对安全。
从一句话到可上线页面:Skill 内部流程
根据官方 Skill 与 usehallmark.com 说明,一次完整构建大致经历:
- Pre-flight:扫描仓库里的设计 token、
design.md、现有 CSS 变量。 - 素材询问:照片、App 截图、真实指标;缺则占位,禁止虚构 KPI。
- 主题 deal:输出 3 个候选(名称、字体、色板、是否适合你的产品调性);也可要求 custom 完全按 prompt 自由设计,仍受同一套 linter 约束。
- Scaffold:生成
tokens.css、base.css,颜色与间距进 token,避免 Agent 随手写 magic number。 - 构建:先 Hero,再按「落地页任务」排区块顺序——每页区块顺序可以不同,避免千篇一律六卡片。
- 验收:
sloplint --render在 Chrome 多宽度渲染;失败则 Agent 自行修到 0 FAIL,再做一轮「 fresh eyes」审查。
配图默认来自 Wikimedia Commons 等开放许可图库,页内会署名;也可选 API key 接其他图源,但不装 key 也能用。
安装后就能用:Node、Skill、浏览器检查
前置:Node.js ≥ 18(node -v)。安装 Skill(-g 表示所有项目可用):
npx skills add nutlope/hallmark -g
仅给某一客户端:
npx skills add nutlope/hallmark -g --agent claude-code
npx skills add nutlope/hallmark -g --agent codex
推荐再装浏览器自检依赖(本机需 Chrome / Chromium):
npm i -g puppeteer-core
不装 puppeteer 会怎样?
仍会做静态 sloplint 检查,但缺少多视口真实渲染,移动端对比度、焦点环、叠字问题可能漏检。写对外营销页时建议装全。
装完无需改后端:Skill 落在 ~/.claude/skills/hallmark(Claude Code)或 Codex 的 ~/.agents/skills/hallmark;Cursor 会读取已安装副本,会话里直接 /hallmark …。更新 Skill 时重新执行 npx skills add 即可。
Claude Code、Cursor、Codex 怎么唤起
| 客户端 | 典型安装位置 | 唤起方式 |
|---|---|---|
| Claude Code | ~/.claude/skills/hallmark | /hallmark <需求> |
| Codex CLI | ~/.agents/skills/hallmark | $hallmark <需求> |
| Cursor / OpenCode | 读取上述路径 | /hallmark <需求> |
若你同时在 Cursor 里写 Swift、在 Claude Code 里改静态站,可把 Hallmark 当作只负责 marketing HTML 的 Skill,与代码库 Skills(发版、测试)分开,避免 discovery 阶段 skill 过多——治理思路与Skills 推荐文一致。
不会乱改现有站:边界与素材规则
- 默认只作用于你指定的路径;普通对话不会重写整站 CSS。
- 不编造事实:没有的数据就占位,避免 AI 落地页常见的假「10 万用户」。
- 可跟现有 design system:Skill 会先读你的 token 与
design.md,再决定是 deal 主题还是 custom。 - App 截图:可给 URL 或本地工程,Skill 可启动应用自行截图(需你环境能跑起来)。
Mac / 云端开发机上的习惯
Hallmark 的浏览器验收依赖本机 Chrome 与 Node 全局包。在 Zilmac 一类持久 home 的云端 Mac上,建议:
- 把
~/.claude/skills放在持久卷,避免实例重建后 Skill 丢失。 - 在仓库内用
.claude/skills固定 Hallmark 版本,团队 PR 审核后再合并。 - CI 若只部署静态
frontend/,Hallmark 生成物仍走常规 git 流程;无需改后端 或 FossBilling。
常见问题
Hallmark 需要单独买 API Key 吗?
不需要。开放许可图库即可出图;可选配置图片 API。页面生成仍走你 Claude / Cursor 已有模型订阅。
和 Tailwind / shadcn 冲突吗?
Hallmark 常输出带 design token 的静态 HTML/CSS,也可读你现有 token。若项目是 React,redesign 时需明确「只改样式层、不动路由与数据流」。
audit 和 redesign 怎么选?
只想评估 AI 味、做 backlog → audit。页面结构 OK 但视觉丢人 → redesign。从零且愿意选主题 → 直接 /hallmark 新建。
装好后 Claude Code 没认出 /hallmark?
确认 npx skills add 成功、重启会话,并检查 ~/.claude/skills/hallmark/SKILL.md 是否存在;Cursor 需使用支持 Agent Skills 的版本。
小结:Hallmark 让 Claude Code 在写网页时带上「设计品味」和可验证的 sloplint 门槛——一行安装,/hallmark 新建、audit 体检、redesign 救场。把它和团队 Skills、MCP 分工清楚,比在 prompt 里重复「不要 AI 风格」更省事。