Nutlope / hallmark

Nutlope/hallmark

open_in_new前往仓库

为Claude Code、Cursor和Codex设计的反AI劣质设计技能。

项目概览

项目概述

Hallmark 是一个面向 Claude Code、Cursor 和 Codex 的“设计技能”（design skill），目标是让 AI 生成的界面不再带有明显的 AI 痕迹（anti-AI-slop）。它由 Together AI 团队开源，仓库语言标记为 CSS，采用 MIT 许可证。

Hallmark 会根据任务为页面选择“宏观结构”（macrostructure），套用 21 种主题之一，并通过 57 道“AI 痕迹检测门”（slop-test gates）和输出前的自我批评来避免模型默认风格。不同需求生成的页面在结构上会有明显差异，而不是同一模板换色。

核心功能

  • 默认行为：根据 brief 构建新 UI，选择宏观结构、应用规则集、运行 slop 测试后返回结果。
  • hallmark audit <target>：对已有代码按反模式打分，给出整改清单，但不直接修改代码。
  • hallmark redesign <target>：保留文案、信息架构和品牌，推翻原有结构并用不同的设计指纹重建。
  • hallmark study <screenshot | URL>：从用户欣赏的设计中提取“DNA”（宏观结构、字体搭配、色彩锚点等），拒绝像素级克隆和付费模板；可选输出可移植的 design.md。
  • 内置 21 种主题、57 道 slop-test 门禁、输出前自批评机制，以及 .hallmark/log.json 项目记忆以避免连续生成雷同设计。
  • 当 brief 包含现有主题无法覆盖的创意意图时，可进入 Custom 模式从零设计页面。
  • 仓库提供多个已生成示例页面，全部为自包含 HTML + CSS。

适用与不适用场景

适用场景：

  • 在 Claude Code、Cursor、Codex 等 AI 编程工具中需要生成新 UI 时。
  • 希望页面不是千篇一律的 SaaS 模板风格，而是有结构差异的定制设计。
  • 希望对已有界面进行“AI 痕迹”审计或在不改变文案/品牌的前提下重新设计。
  • 希望通过截图学习某个设计的结构 DNA，而非复制像素。

不适用场景：

  • 想要 1:1 像素级复制某个网站或设计稿。
  • 想要复制付费模板或受版权保护的页面（技能会拒绝此类请求）。
  • 需要的是后端、数据或非 UI 类功能，而非前端界面设计。
  • 没有 AI 编程助手环境，或期望它作为独立网页应用运行。

技术架构与依赖

  • 这不是一个独立应用或框架，而是以“技能包”形式分发的规则集。
  • 核心文件为 SKILL.md 及 references/ 目录中的参考文档，包括 custom-theme、study、排版、微交互等主题的规则。
  • 产出物为自包含 HTML + CSS 页面。
  • 安装依赖 npx skills add nutlope/hallmark 或手动复制技能文件；具体运行时依赖清单仓库资料未提供。
  • 仓库同时包含 docs/recipes.md、docs/study-examples.md、docs/talk-slides.md 和 site/ 下的示例页面。

安装与快速开始

安装命令（来自 README）：

npx skills add nutlope/hallmark

重新运行同一命令即可更新。也可手动复制 SKILL.md 和 references/ 到对应目录：

  • Claude Code：~/.claude/skills/hallmark/
  • Cursor：.cursor/rules/hallmark.mdc（仅使用 SKILL.md 正文，不含 frontmatter）
  • Codex：~/.codex/skills/hallmark/（个人）或 .codex/skills/hallmark/（项目级）

快速开始示例（来自 recipes.md 的 canonical try-it prompt）：

“Build me a landing page for Coffeebox — a small-batch coffee subscription. Roast on Sunday, ship on Monday, drink Tuesday. Audience: people who already buy good coffee and want fewer trips to the shop. Tone: warm, hand-set, editorial — like a small café's chalkboard.”

如果安装正确，Hallmark 应生成与该 brief 相符的、非模板化的页面。

典型使用方法

  • 新建 UI：直接描述受众、用途、语气和内容，让 Hallmark 选择宏观结构、主题和视觉细节。
  • 审计现有界面：运行 hallmark audit <target>，得到反模式清单和整改建议，不改动代码。
  • 重新设计：运行 hallmark redesign <target>，保留原有文案和品牌，换一套结构指纹重建。
  • 学习参考设计：运行 hallmark study <screenshot | URL>，先返回诊断报告（宏观结构、字体角色、色彩锚点、密度等），确认后再重建；它不会复制像素，也不会直接给出付费字体 ID，而是建议免费替代字体。
  • 项目记忆：.hallmark/log.json 会记录历史选择，避免同一项目重复生成同样结构或主题。

更完整的可直接粘贴的 prompt 示例见 docs/recipes.md。

配置与部署要点

  • 按安装目录放置技能文件；Cursor 的 .mdc 文件需要去掉 frontmatter。
  • 技能规则集位于 SKILL.md 和 references/；Custom 模式协议位于 references/custom-theme.md。
  • 若需要跨工具/项目传递设计 DNA，可让 hallmark study 输出可移植的 design.md。
  • Hallmark 会拒绝部分来源（付费模板市场、带版权保护的页面、像素级克隆请求），并会在使用付费字体替代方案时明确说明。
  • 该技能面向本地 AI 编程助手，不涉及服务器部署；若要在团队内分发，可直接复制技能目录或通过 npx skills add 安装。

限制、风险与许可证

  • 许可证：MIT，可自由使用、fork 和发布。
  • 限制：它主要处理设计/前端 UI 生成与重构，不提供完整应用后端能力。
  • 限制：视觉字体识别不可靠，因此技能通常描述“字体角色”并建议免费替代方案，而不是直接指定付费字体 ID。
  • 风险：文档说明项目记忆机制用于降低连续生成雷同设计的概率，但并未承诺每次输出绝对唯一。
  • 风险：输出质量与所运行模型及执行环境有关；仓库资料未提供最低模型版本要求。
  • 未提供的部署、维护或商业支持信息：仓库资料未提供。

官方链接

信息来源和分析时间

  • 信息来源：GitHub 仓库元数据（owner、name、language、license）、README.md、docs/recipes.md、docs/study-examples.md、docs/talk-slides.md。
  • 分析时间：仓库资料未提供具体快照日期；本次分析基于所提供的仓库快照内容整理。