hallmark 是一个专治“AI 味”设计的设计技能,装给 Claude Code、Codex、Cursor、OpenCode 用:让编程智能体做出来的网页、落地页像人设计的,不像机器套模板。MIT 许可证,GitHub 实时 58,074 星(本站核对:2026-11-20),本周 GitHub Trending 增速榜前五,技能版本 v2.0.0。本文安装步骤以官方 README 与技能文档为准;本站验证:星数、许可证、版本号已核对,克隆安装脚本已实跑通过(见下文),未在 Claude Code 内实机跑一整次建站(需要 Claude Code 环境),下文如实标注。

能干什么

  • 新建页面不落 AI 味:说一句“给我做个产品落地页”,它先从 50 套主题里发三套合适的,再按页面的正事(订位、卖货、订阅)定结构,标题、按钮、表单都落在该在的位置。
  • 真浏览器质检:出图后用 sloplint 在 8 个宽度下实测渲染,专查那些一眼机器味的毛病——每段标题上都顶个小眉标、全站大写字母标签、标题里单拎一个词变色、满页空框或只剩照片、首屏放不下主标题、每页结尾都塞订阅框、点了“提交”却什么都没发生的假表单。
  • 改旧页面不丢东西:/hallmark redesign <路径> 重做现有页面,内容与交互原样保留,只换设计系统与版式;/hallmark audit <路径> 只出报告不动手。
  • 三档质检门:Floor 是硬底线(对比度、焦点、动效、编造数字、手机版式坏了就绝不发版);Reflex 是模型最容易掉进去的默认套路,有理由可以破例但要留记录;Finish 是不挡发版的工艺细节。
  • 主题是素材,不是模板:每套主题只是一份材质文件(纸张、字体、配色、质感,附一张成品图),同一主题两次能做出两个完全不同的页面;还有 755 张开源协议照片,按题材配好、页上署名。
  • 全新上下文复审:每页做完先单独做首屏、冷看一遍,再由一个全新的复审智能体做最后一道关——自己做的自己审,最容易放过的就是自己的毛病。

优缺点

优点:MIT 许可证干净可商用,可改可分发;安装只有一条命令;50 套主题全部是独立小文件,一次只读一套,不吃上下文;质检是真在浏览器里渲染测出来的,不是凭感觉打分;改版有 sloplint --before 先存档、--kept 再核对,丢一个链接、丢一个字段都会被拦下来;不做无中生有的内容——没给照片、数字、文案,它会先问你要,不编。

缺点与边界:它只管“做得像人设计的”,不管你的产品本身好不好卖;浏览器质检要另装 puppeteer-core 与 Chrome,没有就只跑静态检查;主题与示例图加起来安装包不小(本站实装 6.9 MB,仓库 ZIP 约 61 MB,含网站源码与示例);它不会替你写文案、定价、做转化策略,页面骨架有了,卖点还得你自己给;只对新设计生效,旧设计不点名它不会动。

下载与安装(本站实测过的两条路)

  1. 官方推荐(一条命令):npx skills add nutlope/hallmark -g(-g 是装到用户目录全局可用,去掉则只装进当前项目)。需要 Node 18 以上。装完在 Claude Code 里用 /hallmark <需求>,Codex 里用 $hallmark <需求>,Cursor 与 OpenCode 会自动找到它。只装一个宿主可加 --agent claude-code(或 codex / opencode / cursor)。
  2. 本站实测:这条命令在本机沙箱没跑通:交互式安装能正常拉到技能信息并走到“选安装范围”,但随后 git 克隆步骤超时失败;加 --copy --yes 的非交互模式报 [SKILLS_NO_VALID_SKILLS] No valid skills found。原因在 skills CLI 的 git 拉取环节,不是 hallmark 本身的问题。国内用户如遇同样报错,直接走第 3 步的备用路。
  3. 备用路(本站已实跑通过):下载仓库 ZIP(https://codeload.github.com/Nutlope/hallmark/zip/refs/heads/main),解压后在仓库目录跑 node skills/hallmark/scripts/install.mjs --claude(Codex 用 --codex,OpenCode 用 --opencode)。安装脚本会先校验全部主题与引用文件,再复制到 ~/.claude/skills/hallmark;本站实装成功,装完 6.9 MB,含 SKILL.md、50 套主题引用与脚本。
  4. 浏览器质检是可选项:要让它在真浏览器里截图质检,另装 npm i -g puppeteer-core 并备好 Chrome;不装也能用,静态检查照常跑,只是不出渲染截图。
  5. 装完先验一次:跑 node ~/.claude/skills/hallmark/scripts/sloplint.mjs --help 能出用法说明即装好;再跑 node skills/hallmark/scripts/sloplint.mjs <你的一个旧页面> --render 看一次质检报告,先熟悉它报什么。
  6. 国内网络:npx 下载慢可换 npm 国内镜像(npm config set registry https://registry.npmmirror.com);ZIP 下载走 codeload 直连通常能下,慢就走镜像站。工具本身不解决网络问题,下载通道要自己准备。

调用与使用

  1. 新建页面:在 Claude Code 里说 /hallmark 给我的手工皂小店做个落地页,主推三款礼盒,能下单——它会先问你要照片、价格、真实文案(没有就不编),再发三套主题给你挑,挑完按“卖货”这个正事排版式。
  2. 只做质检不改版:/hallmark audit ./index.html,出一份只报问题不动手的报告,先看自己的旧页面到底有多少 AI 味。
  3. 改版旧页面:/hallmark redesign ./src/app——先跑 sloplint --before 把现有链接、字段、标题全存档,改完用 --kept 核对,丢一个就报错;想只换风格不动版式,说一句“保持版式”,想只修毛病,说“只打磨”。
  4. 自定义设计:说 custom,它会丢掉主题,只按底线与质检门、凭你一句话里的独特想法做一版——适合已有明确想法、不想被主题带偏的时候。
  5. 只查一个页面:命令行直接跑 node skills/hallmark/scripts/sloplint.mjs <文件或目录> --render,不用开智能体也能质检。
  6. 它不触发时直接点名:智能体没自动用上,就说一句“用 hallmark 做这个页面”——技能说明里写明了,点名即触发。

调教成自己的

  • 先锁一份 design.md:把品牌字体、配色、禁用元素写进项目里的 design.md,每次建站它都会先读这份文件——品牌越固定,出图越不跑偏。
  • 主题先挑三套备用:去 usehallmark.com 把 50 套主题翻一遍,给自己的店、课程、活动各定一套主力主题,以后新建页面直接点名主题,不用每次重选。
  • 把“真实素材”当第一步:照片、价格、用户原话、真实数字先备齐再开工;素材越真,页面越像人做的——这也是它“什么都不编造”这条规则能成立的前提。
  • 质检门按业务调:Floor 一条都不能动;Reflex 里和你业务冲突的可以破例,但要留记录——比如你的品牌字就是爱用大写标签,那就破例一次并记下来,下次不再返工。
  • 改版前必存档:sloplint --before 是改版的安全绳,养成习惯再动手,丢链接、丢字段当场就能发现。

玩法:创业者的产品落地页一天上线

模拟一位刚做出第一款产品的半小白创业者:产品有了,落地页迟迟没上线——找设计太贵,自己写总像机器生成的。他的打法:

  1. 上午备齐真实素材:三张产品实拍、价格表、两句用户原话——先有素材再开工。
  2. 在 Claude Code 里一句话开工:/hallmark 给我的产品做个落地页,主推一款,能留资,三套主题里挑一套顺眼的。
  3. 首屏单独审一遍:只看第一屏——主标题、产品图、留资按钮三样全不全;不全就让它只改首屏,不动后面的。
  4. 全页跑一遍 sloplint 渲染质检,8 个宽度都过一遍,手机版先看——创业者自己的客户大半在手机上。
  5. 下午上线,晚上看留资数:页面只是第一步,留资按钮的位置与文案才是第二步的优化对象。

玩法:自媒体创作者的课程页与活动页不求人

再模拟一位做付费专栏的自媒体创作者:每次上新课、办活动都要找人做页面,等排期比写课还久。他的打法:把课程大纲、价格、学员评价三样写进 design.md 锁好;新课上线直接 /hallmark 一句话出页面,主题固定用自己挑好的那一套;活动页用 custom 模式——只给一句活动核心理念,让它围绕这一个想法做一版;每次改版前先 --before 存档,报名链接、价格字段一个都不能丢。

避坑指南

  • npx 装不上别硬等:交互式安装走到选范围后卡住、或报 No valid skills found,多半是 git 拉取环节的问题,直接走 ZIP 下载+install.mjs 备用路,本站已实跑通过。
  • 两种装法别并存:市场插件与 npx skills 全局安装会同时生效,Claude Code 里出现两个 /hallmark;一台机器只留一种。
  • 没 Chrome 也能用:浏览器质检要 puppeteer-core 与 Chrome,没有就只跑静态检查,别为装 Chrome 卡住第一步。
  • 主题不是模板:同一主题两次出两个不同页面是正常的——别指望“选个主题就等于选了版式”,版式是按你的正事现排的。
  • 它不会替你编内容:没给照片、价格、真实数字,它会先问你要;催它“随便编一个”只会得到拒绝——这是设计,不是 bug。
  • 改版先存档再动手:sloplint --before 不跑就直接 redesign,丢了链接字段事后很难发现;存档是习惯,不是可选项。
  • 照片有署名要求:它用的 755 张照片来自 Wikimedia Commons,各自带协议(CC0、公共领域、CC BY、CC BY-SA),页上会自动署名;别手动把署名删掉。

横向对比:AI 做页面,几条路怎么选

直接让模型“随便做个页面”:最快,但最容易一股 AI 味——眉标、大写标签、单色词标题、空框首屏,十个页面九个像。通用设计技能(如 taste-skill、frontend-design):给模型一套审美规则与参考,适合有设计基础、想自己把控的人;hallmark 是同一条路的更进一步——50 套主题是现成的材质库,sloplint 是真浏览器质检,还有改版存档与核对的闭环,适合“要结果、不要再返工”的人。可视化建站工具(v0、Figma AI 这类):适合完全不想碰代码、要快速出可交互原型的人;代价是按量计费、样式可控性低。结论:会写提示词、想长期攒自己的页面资产,hallmark 这条本地技能路最划算;只做一次性的活动页,可视化工具更快。

档案

  • 仓库:github.com/Nutlope/hallmark;许可证 MIT(干净可商用,可二开、可改、可分发);官网 usehallmark.com;作者 Together AI 旗下 Nutlope。
  • 星数 58,074(2026-11-20 实时核对);本周 GitHub Trending 增速榜前五(7 日新增约 27,300 星);技能版本 v2.0.0(SKILL.md 标注);50 套主题、755 张开源协议照片。
  • 本站验证:星数、许可证、版本已核对;ZIP 下载+install.mjs --claude 已实跑,装到 ~/.claude/skills/hallmark(6.9 MB,含 50 套主题引用);sloplint --help 正常;主题目录 102 个文件与“五十主题”说法一致;npx skills add 在本机沙箱因 git 拉取超时未完成(见安装第 2 条)。未在 Claude Code 内实机跑一整次建站。

常见问题

它和 taste-skill 有什么区别?taste-skill 也是给编程智能体提审美的技能,hallmark 在它基础上加了三样:50 套现成主题、真浏览器渲染质检(sloplint)、改版存档与核对闭环;官方致谢里也列了 taste-skill 是灵感来源之一。

只支持 Claude Code 吗?不是。Claude Code、Codex、Cursor、OpenCode 都支持,安装方式按宿主分;ChatGPT 网页版不在支持列表里。

一定要装 Chrome 吗?不一定。静态检查不用浏览器;要 8 个宽度下的渲染截图质检才需要 puppeteer-core 与 Chrome。

会改我现有的页面吗?不会,除非你点名。只对新设计生效;旧设计要用 /hallmark redesign <路径> 明确点名,改之前还会先存档。

主题能自己加吗?能。每套主题只是一份 8 KB 以内的材质文件,放进 references/themes/ 即可;自定义整页走 custom 模式。

国内能用吗?技能本身是本地文件,不依赖海外服务;npx 下载慢换 npm 国内镜像,装不上走 ZIP 备用路。质检用的 Chrome 与 puppeteer-core 走本地安装。

搞不定配置怎么办?先跑 sloplint --help 确认装好了,再确认只留了一种装法;实在跑不通,可以看本站的部署与配置跑通服务,把跑通这一步交出去。

站内往下读:AI设计栏目、AI技能栏目、theme-factory:文档做得不差却总显廉价?一键套上专业主题。