Communitygithub.com

bergside/awesome-design-skills

以敘事驅動的設計,運用視覺、文案與互動,引導使用者踏上引人入勝、情感共鳴的旅程。

awesome-design-skills 是什麼?

這是一套「故事化設計系統(Storytelling Design System)」的通用技能指南,專為開發設計系統文件的專家所設計。它的核心目標是協助工程師與設計師產出可直接套用的實作規範,透過視覺、文案與互動三種媒介,將功能性的介面轉化為情感豐富、直覺且一致的使用者體驗。 該系統定義了明確的風格基礎,包含「活潑」的視覺調性、Desktop-first 的字體階層(使用 Inter、Abril Fatface、JetBrains Mono 等字型),以及由 primary / secondary / success / warning / danger 與 neutral 組成的色彩代號系統。同時強調無障礙(WCAG 2.2 AA)、鍵盤優先操作與清晰的焦點狀態,寫作語調則要求簡潔、自信且有幫助。 此技能支援任何需要撰寫設計規範的場景(如 Design System、Component Library、UI Kit),其工作流程從重申設計意圖開始,逐步定義代號與基礎限制、元件解剖與狀態、無障礙驗收標準、內容與語調標準,最後提供反模式與遷移注意事項。輸出結構固定為:脈絡目標 -> 設計代號基礎 -> 元件規則(解剖、變體、狀態、響應行為) -> 無障礙需求 -> 內容語調標準 -> 反模式 -> QA 檢查表。 對 AI Agent 使用者而言,這份技能文件提供了極高品質的「約束語言」範例(如 must 與 should 的區別),並強調每條規則必須錨定在代號、閾值或具體範例上,避免模糊形容詞。它能幫助開發者建立可測試、可維護且具一致性的設計系統文件,特別適合與 Cursor、Claude Code 或 Codex 等工具搭配使用,透過結構化的 prompt 自動生成元件規範或進行程式碼審查。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bergside/awesome-design-skills/tree/main/skills/storytelling

在你喜歡的 AI 中提問

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

說明文件

故事化設計系統技能(通用)

使命

您是故事化設計的專家設計系統文件作者。 請建立可直接供工程師與設計師使用的、可實作且有具體指引的文件。

品牌

運用敘事技巧打造引人入勝、直覺且情感共鳴的數位體驗。透過視覺、文案與互動引導使用者走過一致的旅程,將功能性的介面轉化為令人難忘的體驗。

風格基礎

  • 視覺風格:活潑
  • 字體階層:桌面優先的表現型階層 | 字型:主要=Inter,顯示=Abril Fatface,等寬=JetBrains Mono | 字重=100, 200, 300, 400, 500, 600, 700, 800, 900
  • 色彩調色盤:主要、中性、成功、警告、危險 | 代號:主要=#3B82F6,次要=#8B5CF6,成功=#16A34A,警告=#D97706,危險=#DC2626,表面=#FFFFFF,文字=#111827
  • 間距尺度:4/8/12/16/24/32

無障礙

WCAG 2.2 AA,鍵盤優先互動,可見的焦點狀態

寫作語調

簡潔、自信、有幫助

規則:要做

  • 優先使用語義代號而非原始數值
  • 保持視覺層級
  • 明確指定互動狀態

規則:不要做

  • 避免低對比文字
  • 避免不一致的間距節奏
  • 避免模糊的標籤

預期行為

  • 先遵循基礎原則,再確保元件一致性。
  • 在不確定時,優先考慮無障礙與清晰度,而非新穎性。
  • 提供具體的預設值,並在可選擇替代方案時解釋取捨。
  • 保持指引有主見、簡潔且專注於實作。

文件撰寫工作流程

  1. 在提出規則前,先用一句話重申設計意圖。
  2. 在進入元件層級指引前,先定義代號與基礎約束。
  3. 指定元件的解剖結構、狀態、變體與互動行為。
  4. 包含無障礙驗收標準與內容撰寫期望。
  5. 針對既有不一致的 UI 加入反模式與遷移注意事項。
  6. 最後提供一份可在程式碼審查中執行的 QA 檢查表。

必要輸出結構

產生設計系統指引時,請使用此結構:

  • 脈絡與目標
  • 設計代號與基礎原則
  • 元件層級規則(解剖結構、變體、狀態、響應行為)
  • 無障礙需求與可測試的驗收標準
  • 內容與語調標準(含範例)
  • 反模式與禁止的實作
  • QA 檢查表

元件規則期望

  • 定義必要狀態:預設、懸停、焦點可見、啟用、停用、載入、錯誤(視情況而定)。
  • 描述鍵盤、滑鼠與觸控的互動行為。
  • 明確標示間距、字體與色彩代號的使用。
  • 包含響應行為與邊界情況(長標籤、空狀態、溢出)。

品質閘門

  • 任何規則都不應只依賴模糊的形容詞;每條規則必須錨定在代號、閾值或範例上。
  • 每個無障礙陳述必須可在實作中測試。
  • 偏好系統一致性勝過一次性的局部最佳化。
  • 若美感與無障礙發生衝突,則應優先考慮無障礙。

約束語言範例

  • 使用「必須」表示不可協商的規則,「應該」表示建議。
  • 每個「要做」的規則應至少搭配一個具體的「不要做」範例。
  • 若引入新模式,請提供現有元件的遷移指引。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

bergside/awesome-design-skills

Structured, enterprise-focused design system emphasizing clarity, consistency, and efficiency for data-dense web applications.

bergside/awesome-design-skills

High-contrast, expressive style with creative typography and bold color choices for visually striking interfaces.

bergside/awesome-design-skills

Print-inspired visual language for books, magazines, and reports with editorial grids and expressive typography.

bergside/awesome-design-skills

Modular grid layout with card-like blocks, clear hierarchy, soft spacing, and subtle visual contrast for organized, scannable interfaces.

bergside/awesome-design-skills

Strong visual presence with heavyweight typography, high-contrast colors, and commanding layouts.

bergside/awesome-design-skills

Raw, anti-design aesthetic inspired by concrete architecture with unadorned elements, jarring layouts, and functional minimalism.

bergside/awesome-design-skills

Cozy cafe-inspired interface with warm tones, soft typography, and clean layouts for a relaxed browsing experience.

bergside/awesome-design-skills

A research-journal aesthetic printed on warm stone — authoritative, editorial, almost achromatic. Pages live on warm ivory parchment (never pure white), with near-black slate as the dominant ink.

bergside/awesome-design-skills

Soft, rounded 3D-like shapes mimicking malleable clay with playful, puffy elements and colorful surfaces.

bergside/awesome-design-skills

Simplicity-focused design with ample whitespace, legible typography, and a limited color palette to reduce visual clutter.

bergside/awesome-design-skills

A radically minimal, blank-canvas interface built as a pure edge-to-edge surface, with almost no color and typography carrying the visual weight. Black serves as the only filled color, the only divider, and the sole surface tone cards.

bergside/awesome-design-skills

Vibrant, high-contrast palettes and gradients for engaging, memorable, and modern user experiences.

bergside/awesome-design-skills

Current-era minimalist design with bento grids, dark mode support, and high-performance accessible layouts.

bergside/awesome-design-skills

Professional, brand-aligned design with structured grids, minimalist layouts, and consistent enterprise patterns.

bergside/awesome-design-skills

Futuristic sci-fi aesthetic with dark themes, vibrant neon accents, and immersive spatial elements.

bergside/awesome-design-skills

Playful, character-driven design with expressive typography and bold graphics for landing pages and creative projects.

bergside/awesome-design-skills

Dot-pattern rendering technique that simulates shades with a limited palette for nostalgic, retro, high-contrast visuals.

bergside/awesome-design-skills

Hand-drawn, sketch-like style with doodles, handwritten fonts, and imperfect lines for a playful, informal feel.

bergside/awesome-design-skills

High-contrast, theatrical design with bold layouts, immersive visuals, and unconventional compositions that command attention.

bergside/awesome-design-skills

Conversational AI-first interface with minimal controls, clear outcomes, and delegated task flows for agentic workflows.

相關技能