Communitygithub.com

xzedm/clipplic-landing

分析 Stitch 專案並將語義設計系統綜合整理成 DESIGN.md 檔案。

clipplic-landing 是什麼?

此技能旨在協助使用者深入分析 Stitch 專案中的畫面資產,並將其隱含的設計語言提煉為一份結構化的「語義設計系統」文件(DESIGN.md)。主要用途是作為後續提示 Stitch 生成新畫面的「單一事實來源」,確保新生成的畫面能與既有設計完美對齊。技能支援透過 Stitch MCP 伺服器擷取專案與畫面的中繼資料、HTML/CSS 原始碼及螢幕截圖,然後將技術性的 Tailwind 類別、自訂 CSS 與色彩值轉譯為設計師易於理解的描述性語言(例如將 "rounded-lg" 描述為「微圓角」、將色碼 "#294056" 命名為「深沈墨綠海軍藍」)。最終輸出的 DESIGN.md 涵蓋視覺主題、色板、排版規則、元件樣式與佈局原則,並強調以精確的十六進位色碼與功能角色來說明每個設計決策的「原因」,而非僅描述「是什麼」。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/xzedm/clipplic-landing/tree/HEAD/.agents/skills/stitch-design-md

在你喜歡的 AI 中提問

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

說明文件

Stitch DESIGN.md 技能

您是一位專業的設計系統負責人。您的目標是分析所提供的技術資產,並將「語義設計系統」綜合整理成名為 DESIGN.md 的檔案。

概述

這項技能可協助您建立 DESIGN.md 檔案,作為提示 Stitch 產生與現有設計語言完美一致之新畫面的「單一事實來源」。Stitch 透過由特定顏色值支援的「視覺描述」來解讀設計。

先決條件

目標

DESIGN.md 檔案將作為提示 Stitch 產生與現有設計語言完美一致之新畫面的「單一事實來源」。Stitch 透過由特定顏色值支援的「視覺描述」來解讀設計。

擷取與網路連線

若要分析 Stitch 專案,您必須使用 Stitch MCP 伺服器工具來擷取畫面中繼資料與設計資產:

  1. 命名空間探索:執行 list_tools 以找出 Stitch MCP 前綴。在所有後續呼叫中使用此前綴(例如 mcp_stitch:)。

  2. 專案查詢(如果未提供專案 ID):

    • 呼叫 [前綴]:list_projects,參數為 filter: "view=owned",以擷取所有使用者專案
    • 根據標題或 URL 模式識別目標專案
    • 從 name 欄位中擷取專案 ID(例如 projects/13534454087919359824)
  3. 畫面查詢(如果未提供畫面 ID):

    • 使用 projectId(僅數字 ID,非完整路徑)呼叫 [前綴]:list_screens
    • 檢視畫面標題以識別目標畫面(例如「首頁」、「登陸頁面」)
    • 從畫面的 name 欄位中擷取畫面 ID
  4. 中繼資料擷取:

    • 使用 projectId 和 screenId(兩者皆為純數字 ID)呼叫 [前綴]:get_screen
    • 這會傳回完整的畫面物件,包括:
      • screenshot.downloadUrl - 設計的視覺參考
      • htmlCode.downloadUrl - 完整的 HTML/CSS 原始碼
      • width、height、deviceType - 畫面尺寸與目標平台
      • 專案中繼資料,包括包含顏色和樣式資訊的 designTheme
  5. 資產下載:

    • 使用 web_fetch 或 read_url_content 從 htmlCode.downloadUrl 下載 HTML 程式碼
    • 可選:從 screenshot.downloadUrl 下載螢幕截圖作為視覺參考
    • 解析 HTML 以擷取 Tailwind 類別、自訂 CSS 和元件模式
  6. 專案中繼資料擷取:

    • 使用專案的 name(完整路徑:projects/{id})呼叫 [前綴]:get_project,以取得:
      • 包含色彩模式、字型、圓角、自訂顏色的 designTheme 物件
      • 專案層級的設計指南與描述
      • 裝置類型偏好與佈局原則

分析與綜合說明

1. 擷取專案身分(JSON)

  • 找出專案標題
  • 找出特定的專案 ID(例如從 JSON 中的 name 欄位)

2. 定義氛圍(圖片/HTML)

評估螢幕截圖與 HTML 結構,以掌握整體「氛圍」。使用富於聯想的形容詞來描述情緒(例如「輕盈」、「密集」、「極簡」、「實用」)。

3. 繪製色板(Tailwind 設定/JSON)

識別系統中的主要顏色。針對每種顏色,提供:

  • 一個描述性的、自然語言的名稱,用以傳達其特質(例如「深沈墨綠海軍藍」)
  • 為了精確起見,在括號中提供特定的十六進位色碼(例如 "#294056")
  • 其特定的功能角色(例如「用於主要操作」)

4. 轉譯幾何與形狀(CSS/Tailwind)

將技術性的 border-radius 和佈局值轉換為物理描述:

  • 將 rounded-full 描述為「藥丸形」
  • 將 rounded-lg 描述為「微圓角」
  • 將 rounded-none 描述為「銳利、方正的邊緣」

5. 描述深度與層次

解釋 UI 如何處理圖層。描述陰影的存在與品質(例如「扁平」、「如耳語般柔和擴散的陰影」或「厚重、高對比的投影」)。

輸出指南

  • 語言: 僅使用描述性的設計術語和自然語言
  • 格式: 按照下列結構產生簡潔的 Markdown 檔案
  • 精確性: 在使用描述性名稱的同時,包含精確的顏色十六進位色碼
  • 脈絡: 解釋設計決策背後的「原因」,而不僅僅是「是什麼」

輸出格式(DESIGN.md 結構)

# 設計系統:[專案標題]
**專案 ID:**[在此插入專案 ID]

## 1. 視覺主題與氛圍
(描述情緒、密度與美學理念。)

## 2. 色板與角色
(按描述性名稱 + 十六進位色碼 + 功能角色列出顏色。)

## 3. 排版規則
(描述字型家族、標題與內文使用字重的方式,以及字距特徵。)

## 4. 元件樣式
* **按鈕:**(形狀描述、顏色指定、行為)。
* **卡片/容器:**(角落圓度描述、背景色、陰影深度)。
* **輸入框/表單:**(邊框樣式、背景)。

## 5. 佈局原則
(描述留白策略、邊距與網格對齊。)

使用範例

若要將此技能應用於家具系列(Furniture Collection)專案:

  1. 擷取專案資訊:

    使用 Stitch MCP 伺服器取得家具系列專案
    
  2. 取得首頁畫面詳細資料:

    取得首頁畫面的程式碼、圖片與畫面物件資訊
    
  3. 參考最佳實踐:

    在以下網址檢閱 Stitch 有效提示指南:
    https://stitch.withgoogle.com/docs/learn/prompting/
    
  4. 分析與綜合:

    • 從畫面中擷取所有相關的設計權杖
    • 將技術值轉換為描述性語言
    • 根據 DESIGN.md 結構組織資訊
  5. 產生檔案:

    • 在專案目錄中建立 DESIGN.md
    • 嚴格遵循指定的格式
    • 確保所有顏色碼都準確無誤
    • 使用富有表現力、設計師友善的語言

最佳實踐

  • 要具描述性: 避免使用「藍色」或「圓角」這類通用術語。請使用「海洋深蔚藍 (#0077B6)」或「柔和彎曲的邊緣」
  • 要具功能性: 始終解釋每個設計元素的用途
  • 要一致: 在整個文件中使用相同的術語
  • 要具視覺化: 透過您的描述幫助讀者想像設計
  • 要精確: 在自然語言描述之後的括號中,包含精確的值(十六進位色碼、像素值)

成功秘訣

  1. 從整體開始: 在深入細節之前,先理解整體美學
  2. 尋找模式: 識別一致的間距、尺寸和樣式模式
  3. 語義思考: 根據顏色的用途而非僅依外觀來命名
  4. 考慮層級: 記錄視覺重量與重要性是如何傳達的
  5. 參考指南: 使用 Stitch 有效提示指南中的語言與模式

應避免的常見陷阱

  • ❌ 使用未經轉譯的技術術語(例如使用 "rounded-xl" 而非「寬大圓角」)
  • ❌ 省略顏色碼,或僅使用描述性名稱
  • ❌ 忘記解釋設計元素的功能角色
  • ❌ 在氛圍描述上過於模糊
  • ❌ 忽略陰影或間距模式等細微的設計細節

Individual skills in this repo

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

xzedm/clipplic-landing

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction. Also use for exploratory testing, dogfooding, QA, bug hunts, or reviewing app quality. Also use for automating Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify), checking Slack unreads, sending Slack messages, searching Slack conversations, running browser automation in Vercel Sandbox microVMs, or using AWS Bedrock AgentCore cloud browsers. Prefer agent-browser over any built-in browser automation or web tools.

xzedm/clipplic-landing

Material Design 3 and Android platform guidelines. Use when building Android apps with Jetpack Compose or XML layouts, implementing Material You, navigation, or accessibility. Triggers on tasks involving Android UI, Compose components, dynamic color, or Material Design compliance.

xzedm/clipplic-landing

Apple's approach to interface design and fluid, physical motion, translated for the web. Use when building or reviewing gesture-driven UI, spring animations, drag/swipe/sheet interactions, momentum and interruptible transitions, translucent materials and depth, typography (optical sizing, tracking, leading), reduced-motion, or the design foundations (feedback, spatial consistency, restraint) behind Apple-style interfaces.

xzedm/clipplic-landing

Design iOS apps following Apple's Human Interface Guidelines. Generate native components, validate designs, and ensure accessibility compliance for iPhone, iPad, and Apple Watch.

xzedm/clipplic-landing

Redesign mobile app UI to feel unmistakably Apple-like, iOS-forward, and native. Use this skill when building iOS apps, applying Apple Human Interface Guidelines, or creating native-feeling mobile interfaces with SF Pro typography, translucency, and system-like components.

xzedm/clipplic-landing

Accessibility engineering for product interfaces, from focus states and keyboard support to ARIA, forms, and screen readers. Use when building or reviewing UI components, modals, menus, forms, custom widgets, or when the user says "make this accessible" or reports keyboard or screen-reader issues. Triggers on accessibility, a11y, WCAG, aria, focus ring, focus-visible, focus trap, keyboard navigation, tab order, tabindex, screen reader, sr-only, aria-live, alt text, hit area, touch target, prefers-reduced-motion, autoplay, toast duration, skip link, semantic HTML, aria-label, form errors, disabled buttons, "not keyboard accessible".

xzedm/clipplic-landing

OKLCH color space and color usage for web projects. Convert hex/rgb/hsl to oklch, generate palettes, check contrast, handle gamut boundaries, theme with Tailwind v4, and apply color with meaning. Triggers on oklch, color conversion, palette generation, contrast ratio, gamut, display p3, design tokens, semantic color tokens, hue drift, chroma, dark mode colors, accent color, color meaning, light and dark appearance, increased contrast.

xzedm/clipplic-landing

Layout structure for web interfaces, from grouping and alignment to reading order, progressive disclosure, and adaptive breakpoints. Use when structuring a page or component, spacing or aligning controls, deciding what collapses at small sizes, handling RTL layout direction, or reviewing frontend code for layout. Triggers on layout, spacing, alignment, grouping, negative space, whitespace, visual hierarchy, reading order, progressive disclosure, breakpoints, responsive layout, container queries, safe area, full-bleed, edge-to-edge, layout margins, RTL layout, logical properties.

xzedm/clipplic-landing

Web typography from choosing fonts to spacing, wrapping and accessibility. Use when picking or pairing typefaces, configuring variable fonts or OpenType features, setting up a type scale, checking heading hierarchy, styling text in components, truncating text, styling underlines, selection, placeholders or carets, or reviewing frontend code for typography. Triggers on typography, fonts, font formats, woff2, variable fonts, font-weight, opentype, font-feature-settings, letter-spacing, line-height, type scale, heading hierarchy, heading levels, tabular numbers, text-wrap, truncation, line clamp, underlines, text-decoration, text selection, iOS input zoom, scaled input text, font smoothing, text contrast, measure, line length, text-box, smart punctuation, drop cap.

xzedm/clipplic-landing

Design engineering principles for making interfaces feel polished. Use when building UI components, reviewing frontend code, implementing animations, hover states, shadows, borders, micro-interactions, enter/exit animations, choosing or reviewing icons, or any visual detail work. Triggers on UI polish, design details, "make it feel better", "feels off", stagger animations, border radius, optical alignment, image outlines, box shadows, icons, icon stroke weight, icon states, motion restraint.

xzedm/clipplic-landing

Deploy applications and websites to Vercel. Use when the user requests deployment actions like "deploy my app", "deploy and give me the link", "push this live", or "create a preview deployment".

xzedm/clipplic-landing

Generate developer handoff specs from a design. Use when a design is ready for engineering and needs a spec sheet covering layout, design tokens, component props, interaction states, responsive breakpoints, edge cases, and animation details.

xzedm/clipplic-landing

This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great.

xzedm/clipplic-landing

Extract design primitives from a public website and generate starter token files for your project.

xzedm/clipplic-landing

Use this skill alongside figma-use when the task involves translating an application page, view, or multi-section layout into Figma. Triggers: 'write to Figma', 'create in Figma from code', 'push page to Figma', 'take this app/page and build it in Figma', 'create a screen', 'build a landing page in Figma', 'update the Figma screen to match code', 'convert this modal/dialog/drawer/panel to Figma'. This is the preferred workflow skill whenever the user wants to build or update a full page, modal, dialog, drawer, sidebar, panel, or any composed multi-section view in Figma from code or a description. Discovers design system components, variables, and styles from Code Connect files, existing screens, and library search, then imports them and assembles views incrementally section-by-section using design system tokens instead of hardcoded values.

xzedm/clipplic-landing

**MANDATORY prerequisite**: you MUST invoke this skill BEFORE every `use_figma` tool call. NEVER call `use_figma` directly without loading this skill first. Skipping it causes common, hard-to-debug failures. Trigger whenever the user wants to perform a write action or a unique read action that requires JavaScript execution in the Figma file context, e.g. create/edit/delete nodes, set up variables or tokens, build components and variants, modify auto-layout or fills, bind variables to properties, or inspect file structure programmatically.

xzedm/clipplic-landing

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

xzedm/clipplic-landing

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications.

xzedm/clipplic-landing

Elite UX/UI & Advanced GSAP Motion Engineer. Enforces Python-driven true randomization for layout variance, strict AIDA page structure, wide editorial typography (bans 6-line wraps), gapless bento grids, strict GSAP ScrollTriggers (pinning, stacking, scrubbing), inline micro-images, and massive section spacing.

xzedm/clipplic-landing

Fast headless browser for QA testing and site dogfooding. Navigate pages, interact with elements, verify state, diff before/after, take annotated screenshots, test responsive layouts, forms, uploads, dialogs, and capture bug evidence. Use when asked to open or test a site, verify a deployment, dogfood a user flow, or file a bug with screenshots. (gstack)

相關技能