Zilmac 博客
← 返回技术实践

Hallmark 能干什么?让 Claude Code 自动优化 AI 生成的网页,安装后就能直接用

API 与 Agent ·约 10 分钟阅读

Mac 上 Claude Code 终端运行 Hallmark Skill 优化 AI 生成落地页设计

让 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 推荐清单。

48+
内置主题(v2 先推 3 套供你选)
3
核心用法:新建 · audit · redesign
0 FAIL
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 也相对安全。

Claude Code 终端中 Hallmark Skill 执行 sloplint 浏览器检查与落地页主题选择示意
v2 强调「先设计再编码」:主题 tokens、版式与 sloplint 浏览器验收是同一套闭环,而不是事后补 CSS。

从一句话到可上线页面:Skill 内部流程

根据官方 Skill 与 usehallmark.com 说明,一次完整构建大致经历:

  1. Pre-flight:扫描仓库里的设计 token、design.md、现有 CSS 变量。
  2. 素材询问:照片、App 截图、真实指标;缺则占位,禁止虚构 KPI。
  3. 主题 deal:输出 3 个候选(名称、字体、色板、是否适合你的产品调性);也可要求 custom 完全按 prompt 自由设计,仍受同一套 linter 约束。
  4. Scaffold:生成 tokens.css、base.css,颜色与间距进 token,避免 Agent 随手写 magic number。
  5. 构建:先 Hero,再按「落地页任务」排区块顺序——每页区块顺序可以不同,避免千篇一律六卡片。
  6. 验收: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上,建议:

  1. 把 ~/.claude/skills 放在持久卷,避免实例重建后 Skill 丢失。
  2. 在仓库内用 .claude/skills 固定 Hallmark 版本,团队 PR 审核后再合并。
  3. 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 风格」更省事。

限时优惠

Zilmac

云端 Mac、远程开发与 Mac VPS,为 iOS 与跨平台团队补齐 Apple 工具链。

返回首页
限时优惠 点击查看套餐