1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | hallmark |
| 作者/维护者 | Nutlope(Hassan El Mghari),Together AI 出品 |
| 来源链接 | https://github.com/Nutlope/hallmark |
| 许可证 | MIT(GitHub API 获取) |
| GitHub Stars | 14,430(GitHub API 获取) |
| Forks | 716(GitHub API 获取) |
| 最新版本 | 1.1.0(SKILL.md 内声明) |
| 安装方式 | npx skills add nutlope/hallmark,或手动复制文件 |
官网 usehallmark.com 上称呼它为 “A design skill for Claude Code, Cursor, and Codex”;仓库内自述名称与正式名称一致,均为 hallmark。
2. 功能介绍与亮点
hallmark 是一个反“AI 生成感”的设计技能,专门解决编码 agent 生成界面时千篇一律、一眼看出模板痕迹的问题。它有四个动作:
- 默认(构建):为新页面挑选宏观结构、套用 20 个命名主题之一(或按品牌信号即时生成一套定制配色与字体),跑 57 项“AI 套路”检测门槛外加一次生成前自我批评,才把结果交出来
- audit(审计):只打分不改动,把现有页面对照反套路清单给出扣分清单
- redesign(改版):保留原有文案、信息架构与品牌,只重做视觉结构层
- study(提取设计基因):从一张截图或一个 URL 里提炼宏观结构、字体搭配、主色锚点等“设计 DNA”,可选择直接用它重建页面,或导出一份可移植的
design.md供其他工具复用
核心差异化在于强调“结构多样性”而非仅仅“视觉多样性”——两个不同任务生成的页面不应该只是换色的同一个模板,而应该像两个不同的网站。
3. 适用场景
所属分类:前端与设计
适合用编码 agent(Claude Code、Codex 等)从零生成落地页、产品官网或应用 UI,又不想让作品撞脸“千篇一律 AI 风格”的独立开发者、小团队与设计资源有限的产品经理;也适合已有页面想做视觉审计或改版的场景。
4. 跨 Agent 兼容性
- Claude Code:✅ 原生支持——README 提供专门安装路径
~/.claude/skills/hallmark/,也可用npx skills add一键安装 - Codex:✅ 原生支持——README 提供专门路径
~/.codex/skills/hallmark/(个人级)或.codex/skills/hallmark/(项目级) - OpenClaw:未验证——已抓取材料中未提及
- Hermes Agent:⚠️ 需适配——曾有社区开发者提交 PR,因 Hermes 不支持基于 artifact 的输出交接方式,尝试改写 SKILL.md 并新增 Hermes 专用版本,但该 PR 目前处于未合并状态,主线尚无原生 Hermes 支持
5. 推荐理由
它把“如何避免 AI 生成的界面看起来像 AI 生成的”这件事系统化成了一份可执行的规则集:57 项反套路检测、20 个主题、四个动作,覆盖从新建到审计到改版的全流程。对独立开发者而言,这相当于免费获得一位对“AI 感”高度敏感的设计评审。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9 | GitHub 14,430 stars、716 forks,作者为知名独立开发者,项目由 Together AI 背书 |
| 可用性 | 9 | 一条命令安装,主文件加二十余篇参考文档,近一个月内仍有更新,MIT 许可证无付费依赖 |
| 安全性 | 9 | 见下方安全检查清单 |
安全检查清单:
| 检查项 | 结果 |
|---|---|
| ① shell 命令及权限范围 | 无——技能全部由 Markdown 提示词与参考文档构成,不含可执行脚本 |
| ② 运行时联网外发 | 仅 study 动作在用户提供 URL 时读取该公开页面的 HTML/CSS 用于设计提取,不涉及用户数据外发;导出 design.md 前还要求用户确认来源是本人内容或公开参考 |
| ③ API key/凭据 | 不需要任何 API key 或凭据 |
| ④ 可疑指令 | 未发现;反而显式写有安全护栏——禁止删除生产文件、路由或组件目录,除非用户明确要求或批准了列出具体删除项的方案 |
| ⑤ 作者信誉 | Together AI 背书,维护者对 issue 响应及时 |
| ⑥ License | MIT,明确 |
| ⑦ 最近维护时间 | 最近一次提交 2026-06-26,一个月内 |
7. 跟同类 Skills 相比的优势
| Skill | 定位 | 与 hallmark 的差异 |
|---|---|---|
| stitch-skills(google-labs-code) | 桥接编码 agent 与 Google Stitch AI 设计工具的技能库,通过 Stitch MCP 服务器生成/同步设计稿 | 依赖外部 MCP 服务器与账号配置,走“云端设计工具”路线;hallmark 零依赖、零配置,纯本地提示词规则集 |
| open-design(nexu-io) | 开源本地优先设计引擎,专注让编码 agent 直接生成网页原型与幻灯片 | 定位是“从零生成”的设计引擎本身;hallmark 更像一层设计质量把关规则,额外提供 audit / redesign / study 三种非生成场景 |
| huashu-design(alchaincyf) | HTML 原生设计技能,覆盖高保真原型、幻灯片、动画并支持导出 MP4 | 附带视频渲染、音频处理等脚本能力,功能更重;hallmark 保持纯提示词形态,安装和使用更轻量 |
| material-3-skill(hamen) | 严格实现 Google Material Design 3 规范的组件与主题库 | 是单一设计体系的忠实实现;hallmark 不绑定某个设计体系,靠反套路规则驱动多样性 |
8. 用户评价
来源:GitHub 仓库 issues(均为公开可查证的具名用户反馈)
- 用户 timmeade 在 Issue #1 中报告,早期版本通过
npx skills add安装后出现“未找到有效 skill”报错;Mr-Gupta、MarcusElwin、deeddevs 等多位用户附议确认同一问题,随后由社区贡献者 JaySmith502 提交修复补丁,维护者 Nutlope 确认已修复。 - 用户 Tiktack 在 Issue #9 中反馈,安装后会连带装入仓库自带网站、文档等无关文件,维护者随后确认修复。
- 开发者 thanhtantran 在 Issue #36 中提交了将该技能适配到 Hermes Agent 的改动方案,该 PR 目前未被合并。
9. 其他补充
仓库的 site/ 目录同时是 usehallmark.com 官网源码,可在线浏览 20 个主题在不同任务下生成的示例页面;docs/recipes.md 与 docs/study-examples.md 提供了更多实操范例。
10. 安装使用方式
- Claude Code:
npx skills add nutlope/hallmark(可重复执行以更新),或手动将SKILL.md与references/复制到~/.claude/skills/hallmark/ - Cursor:将
SKILL.md正文(去掉 frontmatter)复制到.cursor/rules/hallmark.mdc - Codex:复制到
~/.codex/skills/hallmark/(个人级)或.codex/skills/hallmark/(项目级)
安装后无需额外配置或重启,直接在对话中提出设计/生成需求即可触发默认动作;如需审计、改版或提取设计基因,显式输入 hallmark audit、hallmark redesign、hallmark study 加目标即可。
11. 注意事项
- 早期版本曾有安装解析与文件冗余问题,均已修复,建议安装时拉取最新版本
- OpenClaw 兼容性未经验证;Hermes Agent 目前无官方支持,社区适配方案尚未合并进主线
- 输出仅为前端 HTML/CSS 层面的设计与结构,不涉及后端逻辑或状态管理,需要自行整合进项目工程
- study 动作读取 URL 时依赖目标页面可公开访问;遇到需要登录或纯 JS 渲染的页面会退回要求提供截图