Hallmark 设计技能

# Hallmark 设计技能：安装说明

这个工具包里只有安装说明，由 Mindket 编写。Hallmark 技能和它的 Claude Code 插件要从 Nutlope 的仓库安装，地址是 https://github.com/Nutlope/hallmark

这些说明不是 Nutlope 或 Together AI 写的，也没有得到它们的认可。README 说 Hallmark 由 Together AI 制作。插件清单把 Nutlope 列为作者。

许可证：MIT。LICENSE 文件写的是“Copyright (c) 2026 Hallmark contributors”。来源见 https://github.com/Nutlope/hallmark/blob/main/LICENSE

README 说，Hallmark 图库里的照片各自保留原来的许可（CC0、公有领域、CC BY 或 CC BY-SA），Hallmark 用到哪一张，就在页面上注明哪一张的出处。

## 会安装什么

- hallmark 技能文件夹：SKILL.md、它的参考资料（主题和设计笔记），以及它的 Node 脚本。
- 按 README 的安装表，Claude Code 的副本放在 `~/.claude/skills/hallmark`，Codex CLI 的放在 `~/.agents/skills/hallmark`。Cursor 和 OpenCode 会找到这些副本。
- 除非你加上可选的编辑时钩子，否则每次编辑后不会运行任何东西。见 setup/claude-code.md。

## 事先需要准备

- README 要求 Node 18 或更高版本。
- README 用的安装器是 npm 上的 `skills` 包。它在注册表里的条目，engines 字段写的是 Node >=22.20.0，见 https://registry.npmjs.org/skills/latest
- 按 README 的说法，浏览器检查和截图需要 puppeteer-core 和 Chrome。没有它们，就只运行静态检查。puppeteer-core 在注册表里的条目写的是 Node >=22.12.0，见 https://registry.npmjs.org/puppeteer-core/latest

```
npm i -g puppeteer-core
```

## 主安装命令

```
npx skills add nutlope/hallmark -g
```

加上 `-g`，技能会为所有项目安装。去掉 `-g`，就只装进当前项目。

## 各智能体的说明

- setup/claude-code.md
- setup/codex.md
- setup/cursor.md
- setup/opencode.md
- setup/github-copilot.md

## 技能会在你的项目里写入什么

SKILL.md 说，构建时会保留一个 `.hallmark` 文件夹（`preflight.json`、`log.json`），并在你的样式表旁边写入 `tokens.css` 和 `base.css`。除非另行指定，截图脚本会把截图存到 `images/screens`。

## 更新或卸载

README 没有给出更新或卸载的步骤。主命令用 skills CLI 安装，这个 CLI 自己的 README https://github.com/vercel-labs/skills 给出了查看、检查、更新和移除已安装技能的命令。技能的名称是 hallmark。副本放在哪里，取决于你选了哪些智能体，以及有没有用 -g。CLI 的智能体对照表 https://github.com/vercel-labs/skills/blob/main/docs/agents.md 给出了每个智能体的文件夹。用了 -g 时，Cursor 的是 ~/.cursor/skills，OpenCode 的是 ~/.config/opencode/skills。不用 -g 时，副本会放进项目的 .claude/skills 或 .agents/skills 文件夹。install.mjs 的帮助文本说，从克隆仓库装上的副本，可以用它的 --remove 参数移除。

## 使用数据

skills CLI 的 README 说，这个 CLI 会收集匿名使用数据。它还说，设置 DISABLE_TELEMETRY=1 或 DO_NOT_TRACK=1，就会关闭遥测和安全审计请求。来源见 https://github.com/vercel-labs/skills

## 可选：生成图片

设置了 `TOGETHER_API_KEY` 变量时，这个技能可以通过 Together AI 的 API 生成图片。没有这个密钥，它就跳过这一步。设置密钥后，你的图片提示词会发送给 Together AI。来源见 https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/scripts/imagegen.mjs

## 来源

- README 的 Install 一节 https://github.com/Nutlope/hallmark/blob/main/README.md
- LICENSE https://github.com/Nutlope/hallmark/blob/main/LICENSE
- SKILL.md https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/SKILL.md
- capture.mjs https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/scripts/capture.mjs

README.md  4 KB
setup/claude-code.md  2 KB
setup/codex.md  998 B
setup/cursor.md  1 KB
setup/github-copilot.md  588 B
setup/opencode.md  1 KB