Communitygithub.com

Stitch DESIGN.md スキル

Stitch プロジェクトの画面を解析し、一貫したセマンティックデザインシステムをまとめた DESIGN.md ファイルを生成します。

Stitch DESIGN.md スキル とは?

このスキルは、デザインシステムリードとして、Stitch プロジェクトの画面メタデータ、HTML/CSS コード、スクリーンショットを解析し、セマンティックデザインシステムを DESIGN.md ファイルとして合成します。生成されたファイルは、既存のデザイン言語と完全に一致した新しい画面を Stitch で生成するための「真実の源」として機能します。対応プラットフォームは Stitch MCP サーバーを利用するすべてのプロジェクトで、ツールセットを用いてプロジェクト情報、画面詳細、デザインテーマを取得します。分析では、カラーパレット(機能的役割とともに)、タイポグラフィ、コンポーネントの形状(例:border-radius を物理的な記述に翻訳)、深度とエレベーションを設計用語で記述します。最終的な DESIGN.md は、テクニカルな値を記述的な自然言語に変換し、正確なカラーコード(16進数)を含むため、デザイナーや開発者が直感的に利用できます。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Stitch DESIGN.md スキル は何をしますか?

あなたはデザインシステムリードのエキスパートです。提供された技術アセットを分析し、「セマンティックデザインシステム」を DESIGN.md というファイルにまとめることが目標です。

概要

このスキルは、Stitch で新しい画面を生成する際、既存のデザイン言語と完全に一致させるための「真実の源」となる DESIGN.md ファイルを作成するのに役立ちます。Stitch は、特定のカラー値でサポートされた「ビジュアルディスクリプション」を通じてデザインを解釈します。

前提条件

目標

DESIGN.md ファイルは、Stitch に新しい画面を生成させる際、既存のデザイン言語と完全に一致させるための「真実の源」として機能します。Stitch は、特定のカラー値でサポートされた「ビジュアルディスクリプション」を通じてデザインを解釈します。

取得とネットワーキング

Stitch プロジェクトを分析するには、Stitch MCP サーバーツールを使用して画面メタデータとデザインアセットを取得する必要があります。

  1. 名前空間の検出: list_tools を実行して Stitch MCP プレフィックスを見つけます。以降のすべての呼び出しにはこのプレフィックス(例: mcp_stitch:)を使用します。

  2. プロジェクトの検索(プロジェクト ID が提供されていない場合):

    • [prefix]:list_projects を filter: "view=owned" で呼び出し、すべてのユーザープロジェクトを取得します
    • タイトルまたは URL パターンで対象プロジェクトを特定します
    • name フィールドからプロジェクト ID を抽出します(例: projects/13534454087919359824)
  3. 画面の検索(画面 ID が提供されていない場合):

    • [prefix]:list_screens を projectId(フルパスではなく数値 ID のみ)で呼び出します
    • 画面タイトルを確認して対象画面を特定します(例: 「Home」、「Landing Page」)
    • 画面の name フィールドから画面 ID を抽出します
  4. メタデータの取得:

    • [prefix]:get_screen を projectId と screenId(両方とも数値 ID のみ)で呼び出します
    • これにより、以下の情報を含む完全な画面オブジェクトが返されます:
      • 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. プロジェクトメタデータの抽出:

    • [prefix]:get_project をプロジェクトの name(フルパス: projects/{id})で呼び出し、以下を取得します:
      • カラーモード、フォント、丸み、カスタムカラーを含む designTheme オブジェクト
      • プロジェクトレベルのデザインガイドラインと説明
      • デバイスタイプの設定とレイアウト原則

分析と合成の手順

1. プロジェクト ID の抽出 (JSON)

  • プロジェクトタイトルを見つけます
  • 特定のプロジェクト ID を見つけます(例: JSON の name フィールドから)

2. 雰囲気の定義(画像/HTML)

スクリーンショットと HTML 構造を評価し、全体的な「雰囲気」を把握します。ムードを説明するための示唆に富む形容詞を使用します(例: 「風通しの良い」、「密度の高い」、「ミニマリスト」、「実用的」)。

3. カラーパレットのマッピング (Tailwind Config/JSON)

システム内の主要な色を特定します。各色について、以下を提供します:

  • その特性を伝える記述的な自然言語名(例: 「深みのあるミュートされたティールネイビー」)
  • 正確性のための特定の16進数カラーコード(例: "#294056")
  • その特定の機能的役割(例: 「プライマリアクションに使用」)

4. ジオメトリと形状の翻訳 (CSS/Tailwind)

テクニカルな border-radius とレイアウト値を物理的な記述に変換します:

  • rounded-full を「ピル型」と記述
  • rounded-lg を「微妙に丸みを帯びた角」と記述
  • rounded-none を「鋭い、角張ったエッジ」と記述

5. 深度とエレベーションの記述

UI がレイヤーをどのように扱うかを説明します。シャドウの存在と質を記述します(例: 「フラット」、「かすかなソフトな拡散シャドウ」、または「重くてコントラストの高いドロップシャドウ」)。

出力ガイドライン

  • 言語: 記述的なデザイン用語と自然言語のみを使用します
  • フォーマット: 以下の構造に従ってクリーンな Markdown ファイルを生成します
  • 正確性: 色には記述的な名前を使用しながら、正確な16進数カラーコードを含めます
  • 文脈: デザイン決定の「理由」を説明し、「何が」だけでなく説明します

出力フォーマット (DESIGN.md 構造)

# デザインシステム: [プロジェクトタイトル]
**プロジェクト ID:** [ここにプロジェクト ID を挿入]

## 1. ビジュアルテーマと雰囲気
(ムード、密度、美的哲学の説明。)

## 2. カラーパレットと役割
(色を記述名 + 16進数コード + 機能的役割でリストアップ。)

## 3. タイポグラフィルール
(フォントファミリー、見出しと本文の太さの使用法、文字間隔の特徴の説明。)

## 4. コンポーネントのスタイリング
* **ボタン:** (形状の説明、色の割り当て、動作)。
* **カード/コンテナ:** (角の丸みの説明、背景色、シャドウの深さ)。
* **入力/フォーム:** (ストロークスタイル、背景)。

## 5. レイアウト原則
(ホワイトスペース戦略、マージン、グリッド配置の説明。)

使用例

このスキルを Furniture Collection プロジェクトで使用するには:

  1. プロジェクト情報を取得:

    Stitch MCP サーバーを使用して Furniture Collection プロジェクトを取得
    
  2. Home ページの画面詳細を取得:

    Home ページ画面のコード、画像、画面オブジェクト情報を取得
    
  3. ベストプラクティスを参照:

    Stitch 効果的なプロンプティングガイドを参照:
    https://stitch.withgoogle.com/docs/learn/prompting/
    
  4. 分析して合成:

    • 画面から関連するすべてのデザイントークンを抽出
    • テクニカルな値を記述的な言語に翻訳
    • DESIGN.md 構造に従って情報を整理
  5. ファイルを生成:

    • プロジェクトディレクトリに DESIGN.md を作成
    • 指定されたフォーマットに正確に従う
    • すべてのカラーコードが正確であることを確認
    • 示唆に富むデザイナーフレンドリーな言語を使用

ベストプラクティス

  • 記述的に: 「blue」や「rounded」のような一般的な用語を避け、「Ocean-deep Cerulean (#0077B6)」または「Gently curved edges」を使用
  • 機能的に: 各デザイン要素が何に使用されるかを常に説明
  • 一貫的に: ドキュメント全体で同じ用語を使用
  • 視覚的に: 説明を通じて読者がデザインを視覚化できるようにする
  • 正確に: 自然言語での記述の後に、正確な値(16進数コード、ピクセル値)を括弧内に含める

成功のためのヒント

  1. 全体像から始める: 詳細に入る前に全体的な美しさを理解する
  2. パターンを探す: 一貫したスペーシング、サイジング、スタイリングパターンを特定する
  3. 意味的に考える: 色を外見だけでなく、目的に基づいて命名する
  4. 階層を考慮する: ビジュアルウェイトと重要度がどのように伝達されるかを文書化する
  5. ガイドを参照する: Stitch 効果的なプロンプティングガイドの言語とパターンを使用する

避けるべき一般的な落とし穴

  • ❌ テクニカルな専門用語を翻訳せずに使用する(例: 「rounded-xl」を「generously rounded corners」とせずにそのまま使う)
  • ❌ カラーコードを省略したり、記述名のみを使用する
  • ❌ デザイン要素の機能的役割を説明し忘れる
  • ❌ 雰囲気の説明があいまいすぎる
  • ❌ シャドウやスペーシングパターンなどの微妙なデザイン詳細を無視する

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)

関連スキル