brand-guidelines:让 AI Agent 自动套用 Anthropic 官方品牌规范

前言

用 AI 生成演示文稿、文档或网页时,配色和字体往往各写各的:标题一种蓝、正文一种灰,换个人改一版又换一套风格。团队越大,视觉不一致的问题越明显。设计规范文档通常躺在 PDF 或 Figma 里,Agent 不会自动去读,每次还得人工粘贴色值和字体名。

Anthropic 在官方 Skills 仓库里提供了一个叫 brand-guidelines 的示例 Skill:把品牌主色、强调色和字体规则写进 SKILL.md,Agent 加载后就能在生成各类产出物时按同一套标准排版。对企业团队来说,这也是自建「内部设计规范 Skill」的可直接参考模板。

这是什么

brand-guidelines 是 Anthropic 维护的 Agent Skill,源码位于 anthropics/skills 仓库的 skills/brand-guidelines/ 目录。Skill 采用通用的 SKILL.md 格式,可在 Cursor、Claude Code、Claude.ai 及 Claude API 等支持 Agent Skills 的工具中使用。

它的定位很清晰:将 Anthropic 官方品牌色与字体规范应用到「任何适合呈现 Anthropic 视觉风格」的产出物上——包括演示文稿、文档、HTML 页面等。官方 description 字段写明,当涉及品牌色、样式指南、视觉格式化或公司设计标准时,应启用此 Skill。

该 Skill 目录结构极简,仅包含两个文件:

  • SKILL.md:品牌规范正文与元数据
  • LICENSE.txt:Apache License 2.0 开源许可

没有附带 Python 脚本或资源文件夹;规范本身全部写在 Markdown 指令里,由 Agent 读取后执行。

核心功能与亮点

完整的品牌色板

Skill 中定义了两组颜色,均给出十六进制值,便于 Agent 精确引用:

主色(Main Colors):

名称 色值 用途
Dark #141413 主文本、深色背景
Light #faf9f5 浅色背景、深色背景上的文字
Mid Gray #b0aea5 次要元素
Light Gray #e8e6dc 弱对比背景

强调色(Accent Colors):

名称 色值 角色
Orange #d97757 主强调色
Blue #6a9bcc 次强调色
Green #788c5d 第三强调色

字体与层级规则

  • 标题:Poppins(不可用则回退 Arial)
  • 正文:Lora(不可用则回退 Georgia)
  • 24pt 及以上的标题使用 Poppins;正文统一 Lora
  • 官方建议预先安装 Poppins 和 Lora,以获得最佳渲染效果;未安装时自动降级到系统字体

智能样式应用

Skill 指令中描述了 Agent 应遵循的三类行为:

  1. 智能字体应用:按字号区分标题与正文,并在自定义字体缺失时自动回退。
  2. 文本样式:根据背景明暗选择合适的文字颜色,保留原有层级结构。
  3. 形状与强调色:非文本形状(如图表块、装饰图形)循环使用橙、蓝、绿三种强调色,在统一品牌感的同时避免页面过于单调。

与文档生成的衔接

Skill 的技术说明部分提到,颜色值通过 python-pptxRGBColor 类应用——这说明它主要面向 Agent 生成 PowerPoint 等 Office 文档的场景。Anthropic 仓库中同系列的 pptxdocx 等文档 Skill 可与 brand-guidelines 组合使用:前者负责文件结构与内容,后者负责视觉规范。

企业级工作流参考价值

brand-guidelines 本身不复杂,但模式很有代表性:把设计规范从「人读的文件」变成「Agent 读的指令」。团队可以照此结构,把自家 Logo 用法、色板、字体、间距规则写进 SKILL.md,让 AI 在写对外材料、内部报告、客户提案时自动对齐品牌,减少反复校对。

安装与启用

获取 Skill 文件

从官方仓库克隆或下载对应目录:

git clone https://github.com/anthropics/skills.git
cp -r skills/skills/brand-guidelines /path/to/your/skills/brand-guidelines

也可以只下载 skills/brand-guidelines/ 下的 SKILL.mdLICENSE.txt 两个文件,保持目录名 brand-guidelines 不变。

在 Cursor 中使用

Cursor 会在启动时扫描以下目录中的 Skill:

路径 作用域
.cursor/skills/ 项目级,可提交到 Git 与团队共享
~/.cursor/skills/ 用户级,所有项目可用
.agents/skills/ 项目级,跨工具兼容
.codex/skills/ Codex 兼容目录

brand-guidelines 文件夹放入上述任一目录即可,例如:

mkdir -p .cursor/skills
cp -r /path/to/brand-guidelines .cursor/skills/

重启 Cursor 或重新打开项目后,Agent 会根据任务描述自动匹配该 Skill;也可在对话中直接提及「使用 brand-guidelines」或 /brand-guidelines(若已注册为斜杠命令)显式调用。

在 Claude Code 中使用

Anthropic 官方 README 提供了 Plugin 安装方式。先注册 marketplace:

/plugin marketplace add anthropics/skills

然后安装示例 Skill 集合(brand-guidelines 属于 Enterprise & Communication 类示例):

/plugin install example-skills@anthropic-agent-skills

安装完成后,在对话中说明需要按 Anthropic 品牌规范排版即可触发。

在 Claude.ai 中使用

根据 anthropics/skills 仓库说明,该仓库中的示例 Skill 已对 Claude.ai 付费计划用户开放。也可按 Using skills in Claude 上传自定义 Skill 文件夹。

通过 Claude API 使用

API 用户可通过 Skills API 上传或引用预置 Skill。具体端点与权限以 Anthropic 官方文档为准。

SKILL.md 元数据格式

该 Skill 的 YAML frontmatter 如下(摘自官方源码):

---
name: brand-guidelines
description: Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.
license: Complete terms in LICENSE.txt
---

namedescription 是 Agent Skills 规范要求的必填字段;Agent 主要依据 description 判断何时加载此 Skill。

典型用法示例

官方 SKILL.md 未给出固定命令行,但结合其描述与 Anthropic 仓库 README 的用法模式,以下提示词可直接复现:

生成品牌一致的演示文稿:

请使用 brand-guidelines Skill,按 Anthropic 官方品牌色和字体,
帮我做一份 8 页的产品介绍 PPT 大纲,并输出每页的布局与配色说明。
标题用 Poppins,正文用 Lora,强调色优先使用 #d97757。

美化已有 HTML 页面:

加载 brand-guidelines,把下面这段 HTML 的配色和字体改成 Anthropic 品牌规范:
背景 #faf9f5,主文字 #141413,链接和按钮用 #d97757 / #6a9bcc / #788c5d 轮换。

与 pptx Skill 组合(Claude Code 场景):

先用 pptx Skill 生成一份季度汇报幻灯片,
再按 brand-guidelines 里的色板和字体规则统一调整样式。

团队自建规范的起点:

参考 anthropics/skills 的 brand-guidelines 结构,
帮我写一份 SKILL.md,把我们公司的主色 #1a365d、辅色 #ed8936
和标题字体「思源黑体」写进去,供 Agent 写对外文档时使用。

使用时尽量在提示词里点明「品牌色」「视觉规范」「Anthropic 风格」等关键词,便于 Agent 正确匹配 description 中的触发条件。

适用场景与注意事项

适合谁用

  • 需要频繁用 AI 生成 PPT、Word、HTML 等对外材料的团队
  • 希望 Agent 输出与 Anthropic 官方视觉一致的内容创作者或开发者
  • 正在规划「内部品牌 Skill」的企业设计或工程团队
  • 学习 Agent Skills 编写模式的初学者(结构简单、易于 fork 改造)

使用限制

  1. 规范范围有限:Skill 只覆盖 Anthropic 官方色板与字体,不包含 Logo 文件、图标库或完整 VI 手册;商用 Anthropic 商标仍需遵守其品牌政策。
  2. 字体依赖环境:Poppins 和 Lora 需用户环境预装;否则 Agent 会回退到 Arial / Georgia,视觉效果可能与官方略有差异。
  3. 演示性质:Anthropic 在仓库 Disclaimer 中说明,这些 Skill 主要用于演示与教育,生产环境的行为可能与示例不完全一致,关键交付物应人工抽检。
  4. 无自动化脚本:目录内没有预置 Python 脚本;Agent 需自行调用 python-pptx 等工具实现配色,具体效果取决于 Agent 能力与运行环境。
  5. 跨工具差异:Claude.ai 内置版、Claude Code Plugin 版与 Cursor 本地拷贝版,加载路径和触发方式不同,以各平台官方文档为准。

自建品牌 Skill 的实用建议

若参考 brand-guidelines 为团队编写内部规范,建议:

  • description 里写清触发场景(如「对外 PPT」「官网 Banner」「客户邮件模板」)
  • 色值统一用 HEX 或 RGB,避免只写颜色名称
  • 区分「必须使用」与「建议参考」的规则,减少 Agent 过度约束
  • 大段规范可拆到 references/ 子目录,在 SKILL.md 中引用,保持主文件精简

小结

brand-guidelines 把 Anthropic 官方品牌色(如主色 #141413 / #faf9f5、强调色 #d97757 等)和字体组合(Poppins + Lora)封装成 Agent 可执行的 Skill 指令,解决 AI 生成内容时视觉风格漂移的常见问题。它结构轻量、Apache 2.0 开源,既可直接用于 Anthropic 风格产出,也适合作为企业自建设计规范 Skill 的范本。

官方仓库地址:https://github.com/anthropics/skills/tree/main/skills/brand-guidelines

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜