Communitygithub.com

BeautifulEngine/brand-snapshot

读取任意品牌的实时网站,返回一份两页的品牌快照 PDF,以及设计令牌(JSON 和 CSS)——包含带十六进制码、RGB 值和对比度检查的调色板、字体及免费替代方案、用文字描述的 Logo 及官方文件链接、UI 模式(如圆角和按钮)、品牌语调、图像风格,以及官方指南的存放位置。

brand-snapshot 是什么?

Brand Snapshot 是一款 AI 代理技能,能够快速从品牌的实时网站提取视觉和语言基础信息,生成两页的 PDF 快照以及设计令牌。它适用于 Claude Code、Cursor 以及支持 AI 代理的技能框架。该技能通过浏览器或抓取方式获取网站内容,提取计算样式、加载字体、颜色、CSS 自定义属性、渐变、按钮和卡片样式等关键设计信息,并查找官方媒体资料包或品牌门户进行对比验证。输出包括调色板(含对比度检查)、字体及其免费替代方案、Logo 描述、UI 模式、语调示例和图像风格,并以 tokens.json 和 tokens.css 文件形式提供设计令牌,方便开发者快速获取品牌参考,避免从零开始查找。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BeautifulEngine/brand-snapshot/tree/HEAD/brand-snapshot

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

品牌快照

在几分钟内获取品牌的视觉和语言基础信息,浓缩到两页纸上:你可以放心使用的颜色、字体及其免费替代方案、Logo 和 UI 的行为方式、品牌语调,以及官方文件的链接。这是 Company Brief 技能中品牌部分的精简版。

用法

/brand-snapshot <网址或品牌名> [仅令牌]

直接请求也同样有效:

  • "Brand snapshot for linear.app."
  • "Patagonia 使用什么颜色和字体?"
  • "从 stripe.com 提取设计令牌,用于提案原型。"
  • "Oatly 和 Liquid Death 的快照,并排显示。"(每项生成一份快照)

"仅令牌"会跳过 PDF,返回 tokens.json 和 tokens.css。

文件。 <skill-dir> 表示此技能所在的文件夹,即存放此 SKILL.md 的文件夹。模板位于 assets/,脚本位于 scripts/,共享的 PDF 步骤(字体、颜色、渲染、检查)位于 references/rendering.md。

硬性规则

  • 实时网站优先。 颜色和字体来自网站的计算样式(references/brand-extraction.md),标记为 已验证 并注明日期。如果官方指南或媒体资料包与网站不一致,优先采用官方版本;需注明两者。第三方来源(如 Brandfetch)标记为 已报告。
  • 描述 Logo,不要复制。 用文字描述标志和文字商标,并链接到官方媒体资料包或品牌门户。切勿重绘、描摹或嵌入 Logo、吉祥物或广告图片。色板和用替代字体设置的字体样本是允许的。
  • 明确说明替代品。 如果品牌字体是付费或自定义字体,需说明字体名称、铸造厂名称,并用最接近的免费匹配字体设置样本,同时标明其为替代品。
  • 使用条款适用。 提醒读者品牌的资产归品牌所有,其使用受品牌指南约束。
  • 署名行: 快照末尾以较小的 Beautiful Engine 署名结束。除非对方要求去掉,否则保留。

工作流程

  1. 打开网站(如果浏览器可用,需确认域名一次;否则直接获取)。确认这是对方所指的品牌。
  2. 提取 使用 references/brand-extraction.md 中的脚本第 1 节,在首页和另一个页面(定价、产品或关于页面)上进行:标题样式、加载的字体、按屏幕区域划分的颜色、样式表中的颜色、CSS 自定义属性、渐变、按钮和卡片样式,以及 Logo 信息。放大 Logo 的截图以描述它,并放大主视觉以描述图像风格。
  3. 检查官方来源:搜索品牌的媒体资料包、品牌门户、设计系统网站或指南 PDF,以及其字体的铸造厂。子品牌(活动、产品线)需单独注明。
  4. 选择调色板:按重要性顺序列出 4–8 种颜色(主要、次要、强调、中性色),每种颜色赋予一个简单的名称和角色。然后运行: python3 <skill-dir>/scripts/palette.py --colors "Name:#hex,..." --font-display "…" --font-body "…" --font-mono "…" --radius 8px --brand "<Brand>" > swatches.html 它会生成 tokens.json 和 tokens.css,并打印出包含对比度检查的色板表格。
  5. PDF 的字体系列:使用 scripts/fonts.py 安装品牌的免费字体或替代字体,并使用品牌的主色和强调色运行 scripts/tokens.py,使快照本身具有品牌风格(references/rendering.md)。
  6. 语调:3–4 个特征,每个特征搭配一条来自网站的真实引用语句(加引号)。
  7. 构建:从 assets/snapshot-template.html 开始(复制 base.css),粘贴色板表格,渲染、审核并检查联系人页。共两页;如有内容溢出,进行修剪而非扩展到第三页。
  8. 交付:提供 PDF、tokens.json 和 tokens.css。在回复中说明:主色和强调色及其十六进制码、字体及替代方案,以及官方指南的位置(如果没有公开的,则说明)。

输出文件名:<Brand>-Brand-Snapshot-<YYYY-MM>.pdf。

相关技能