Communitygithub.com

BeautifulEngine/brand-snapshot

讀取任何品牌的即時網站,回傳一份兩頁的品牌快照 PDF,以及設計 Token(JSON 和 CSS),包含色盤(含 Hex、RGB 與對比度檢查)、字型(附免費替代字型)、Logo 文字描述與官方檔案連結、UI 模式(如圓角與按鈕)、語調範例、圖像風格,以及官方品牌指南的位置。適合在開始設計前,快速查詢品牌的色彩、字型、風格、品牌指南摘要或設計 Token。使用方式:`/brand-snapshot` 後接網址或品牌名稱。

brand-snapshot 是什麼?

Brand Snapshot 是一款專為設計師與開發者設計的品牌提取工具,能從品牌的即時網站中自動擷取視覺與語調要素,並整理成一份兩頁的 PDF 快照、tokens.json 與 tokens.css。它支援 Claude Code、Cursor、Codex 等 AI 代理平台,幫助你在開始設計工作前快速取得可靠的品牌參考資料。工具會優先從網站的 computed styles 中擷取色彩與字型(標記為「已驗證」),並與官方品牌指南或新聞稿比對,若不一致則兩者並列;Logo 僅以文字描述,不複製或嵌入任何商標圖像。輸出內容包含按重要性排序的色盤(4–8 色,附對比度檢查)、付費或自訂字型的免費替代建議、UI 模式分析、語調範例,以及官方資源連結。使用者只需輸入 `/brand-snapshot <網址或品牌名稱>`,即可獲得立即可用的設計 Token 與品牌摘要,大幅節省手動研究時間。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Brand Snapshot

在幾分鐘內將品牌的視覺與語調基礎濃縮成兩頁:你可放心使用的色彩、字型與其免費替代方案、Logo 與 UI 的表現方式、品牌的語調,以及官方檔案的連結。這是 Company Brief 技能中品牌部分的快速版本。

使用方式

/brand-snapshot <網址或品牌名稱> [tokens only]

純文字請求也可以運作:

  • 「Brand snapshot for linear.app.」
  • 「Patagonia 用了哪些顏色和字型?」
  • 「從 stripe.com 擷取設計 Token 作為提案 mockup。」
  • 「Oatly 和 Liquid Death 的快照,並排比較。」(各產生一份快照)

加上「tokens only」則跳過 PDF,只回傳 tokens.json 與 tokens.css。

檔案。 <skill-dir> 代表此技能所屬的資料夾,也就是存放這個 SKILL.md 的地方。範本在 assets/ 中,腳本在 scripts/ 中,共用的 PDF 步驟(字型、色彩、渲染、檢查)則在 references/rendering.md 中。

嚴格規則

  • 以即時網站為優先。 色彩與字型來自網站的 computed styles(參考 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 "名稱:#hex,..." --font-display "…" --font-body "…" --font-mono "…" --radius 8px --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。回覆內容須包含:主色與強調色的 Hex 碼、字型與替代字型,以及官方指南的位置(若無公開指南則註明)。

輸出檔名:<品牌>-Brand-Snapshot-<YYYY-MM>.pdf。

相關技能