Communitygithub.com

xzedm/clipplic-landing

Google の Material Design 3(Material You)UI システムを実装します。プライマリ: Jetpack Compose Material3(MaterialTheme、コンポーネント、アダプティブレイアウト)。Flutter と限定された Web(@material/web、メンテナンスモード)もカバー。トークン、30以上のコンポーネント、レイアウト、テーマ設定、M3 Expressive(プラットフォームマトリックス)、アクセシビリティに対応。「material design」「MD3」「material you」「Jetpack Compose」「MaterialTheme」「material component」「md3 button」のようなキーワードで使用します。

clipplic-landing とは?

このスキルは、Google の Material Design 3(MD3)を実装するための包括的なガイドです。MD3 は、パーソナル、アダプティブ、エクスプレッシブな設計システムで、ダイナミックカラー、トーナルサーフェス、丸みを帯びた形状、スプリングベースのモーションを使用して、生き生きとしたパーソナルな UI を作成します。プライマリプラットフォームは Jetpack Compose で、最新のコンポーネント、エクスプレッシブ API、アダプティブスキャフォールド、Styles API 統合を提供します。Flutter も使用可能で、Web は @material/web ライブラリを介して限定的にサポートされています(メンテナンスモード)。このスキルには、30 以上のコンポーネントのクイックリファレンス、設計トークンシステム(色、タイポグラフィ、シェイプ、標高、モーション)、Google I/O 2026 の更新情報を含む決定木が含まれています。MD3 の原則を説明し、Jetpack Compose、Flutter、Web の実装パスを詳述し、エクスプレッシブレイアウト、8dp スペーシングシステム、アクセシビリティに関するガイダンスを提供します。このスキルは、MD3 コンポーネントの構造とトークンの使用法において優先され、他のフロントエンド設計スキルと組み合わせて使用できます。

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

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

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

ドキュメント

Material Design 3

このスキルは、Google の Material Design 3(MD3) — パーソナルで、アダプティブで、エクスプレッシブな設計システムの実装をガイドします。MD3 は、ダイナミックカラー、トーナルサーフェス、丸みを帯びた形状、スプリングベースのモーションを使用して、生き生きとしてパーソナルな感覚の UI を作成します。

哲学

MD3 は3つの原則に基づいています:

  • パーソナル: ダイナミックカラーは、ユーザーの壁紙やコンテンツに合わせて UI を適応させます。テーマ設定は個別化されており、一律ではありません。
  • アダプティブ: レイアウトは5つのウィンドウサイズクラスにわたって変化します。コンポーネントは、レスポンシブにサイズ変更、再配置、フォームファクターの変更を行います。
  • エクスプレッシブ: 形状のモーフィング、スプリング物理、強調されたタイポグラフィが、ユーザビリティを犠牲にすることなく、楽しさの瞬間を生み出します。

最新情報: Google I/O 2026

Material の Google I/O 2026 アップデート は、Compose ファースト の Android パスを強化し、エクスプレッシブ/アダプティブガイダンスを拡張します:

  • Material Android は Compose ファースト: 新しい Android 開発では、最新のコンポーネント、エクスプレッシブ API、アダプティブスキャフォールド、Styles API 統合のために Jetpack Compose Material3 を推奨します。Android Views は既存のアプリで必要になる場合がありますが、新しい Material 3 実装のデフォルトパスとして扱うべきではありません。
  • エクスプレッシブレイアウトシステム: エクスプレッシブレイアウトスキャフォールドを使用して、モバイル、デスクトップ、折りたたみデバイス、ウォッチ、XR、およびその他の空間フォームファクターにわたって画面を適応させます。固定の電話ファーストレイアウトではなく、アダプティブスキャフォールド/ウィンドウサイズクラスから始めます。
  • 8dp スペーシングシステム: マージン、パディング、ギャップにスペーシングトークンを適用して、レイアウトとコンポーネントがデバイスタイプと密度に応じてプログラムで適応できるようにします。
  • 新規/更新されたエクスプレッシブコンポーネント: リスト、メニュー、検索、検索アプリバーのエクスプレッシブガイダンスが更新され、Jetpack Compose が主要な実装ターゲットとなっています。
  • ウォッチと XR: ウォッチは物理ベースのモーション、アークテキスト、エッジに沿ったコンテナを強調します。XR は空間パネルと深度ベースの標高を強調します。

MD2 との主な違い:

  • トーナルサーフェスが、主要な奥行きの手がかりとして標高の影を置き換えます
  • ダイナミックカラーが単一のシードカラーから完全なカラースキームを生成します
  • デフォルトで完全に丸みを帯びたコーナー(わずかに丸いのではなく)
  • スプリングベースのモーション物理が、コンポーネントの固定イージング曲線を置き換えます
  • ユーザーが制御できる3レベルのコントラスト(標準/中/高)

フロントエンドデザインスキルとの関係: 両方のスキルがアクティブな場合、MD3 は設計システム(トークン、コンポーネント、レイアウトルール)を提供し、フロントエンドデザインはその制約内でクリエイティブな方向性を提供します。コンポーネント構造とトークンの使用法では、MD3 のルールが優先されます。注: Roboto/Roboto Flex は MD3 における正しいデフォルトタイプフェイスです — MD3 を実装する場合、Roboto を避けるというフロントエンドデザインのガイダンスは適用されません。

決定木

何を構築していますか?

完全なアプリスキャフォールド → 「共通パターン: アプリシェル」 + 参照/layout-and-responsive.md を参照
単一コンポーネント        → 「コンポーネントクイックリファレンス」表 → 参照/component-catalog.md を参照
カスタムテーマ             → 参照/theming-and-dynamic-color.md を参照
フォーム/入力レイアウト    → 参照/component-catalog.md § 入力コンポーネントを参照
ナビゲーション構造         → 参照/navigation-patterns.md を参照
データ表示                 → 参照/component-catalog.md § データ表示を参照

どのプラットフォームですか?

Jetpack Compose          → プライマリ: androidx.compose.material3、MaterialTheme、参照/*
Flutter                  → ThemeData で useMaterial3: true、ColorScheme.fromSeed()
Web (vanilla JS)         → @material/web(制限あり、メンテナンスモード)+ CSS カスタムプロパティ
Web (React/Vue/Svelte)   → CSS カスタムプロパティ + ラッパーコンポーネント(公式 React ライブラリはなし)
Web (CSSのみ)            → CSS カスタムプロパティとしての MD3 トークン値(<md-*> 要素なし)

設計トークンシステム

すべての MD3 トークンは md.sys 名前空間を使用します。Jetpack Compose はロールを MaterialTheme.colorScheme、MaterialTheme.typography、MaterialTheme.shapes にマッピングします(仕様と同じセマンティックロール)。Web 上では、これらは CSS カスタムプロパティ(--md-sys-*)にマッピングされます:

カラートークン(--md-sys-color-*)

トークン目的
primaryサーフェス上の高強調表示の塗りつぶし、テキスト、アイコン
on-primaryprimary 上のテキスト/アイコン
primary-container主要コンポーネント(FAB など)の目立つ塗りつぶし
on-primary-containerprimary-container 上のテキスト/アイコン
secondary / on-secondaryあまり目立たないアクセント
secondary-container / on-secondary-container控えめなコンポーネント(トーナルボタン)
tertiary / on-tertiary対照的なアクセント
tertiary-container / on-tertiary-container補完的なコンテナ
error / on-errorエラー状態(静的 — ダイナミックカラーで変化しない)
error-container / on-error-containerエラーコンテナの塗りつぶし
surfaceデフォルトの背景
on-surface任意のサーフェス上のテキスト/アイコン
on-surface-variantサーフェス上の低強調表示のテキスト/アイコン
surface-container-lowest最も低い強調表示のコンテナ
surface-container-low低強調表示のコンテナ
surface-containerデフォルトのコンテナ(ナビゲーション領域)
surface-container-high高強調表示のコンテナ
surface-container-highest最も高い強調表示のコンテナ
surface-dim / surface-bright明るい/暗いテーマ間で相対的な明るさを維持
inverse-surface / inverse-on-surface / inverse-primary対照的な要素(スナックバー)
outline重要な境界(テキストフィールドの境界線)
outline-variant装飾的な要素(区切り線)

詳細: 参照/color-system.md

タイポグラフィトークン(--md-sys-typescale-*)

スケールサイズ使用法
DisplayL / M / Sヒーローテキスト、大きな数字
HeadlineL / M / Sセクションヘッダー
TitleL / M / S小さいヘッダー、カードタイトル
BodyL / M / S段落テキスト、説明文
LabelL / M / Sボタン、チップ、キャプション

各スタイルには、-font、-weight、-size、-line-height、-tracking のトークンがあります。 さらに、--md-sys-typescale-emphasized-* 経由で15の 強調 バリアント(より高い weight)があります。

詳細: 参照/typography-and-shape.md

シェイプトークン(--md-sys-shape-corner-*)

トークン値コンポーネントの例
none0dp—
extra-small4dpチップ、スナックバー
small8dpテキストフィールド、メニュー
medium12dpカード
large16dpFAB、ナビゲーションドロワー
large-increased20dp(エクスプレッシブ)
extra-large28dpダイアログ、ボトムシート
extra-large-increased32dp(エクスプレッシブ)
extra-extra-large48dp(エクスプレッシブ)
full9999pxボタン、チップ、バッジ

標高レベル

レベルDPトーナルオフセット使用法
00dpなしフラットなサーフェス、通常時のほとんどのコンポーネント
11dp+5% primary標高のあるカード、モーダルシート
23dp+8% primaryメニュー、ナビゲーションバー、スクロールされたアプリバー
36dp+11% primaryFAB、ダイアログ、検索、日付/時刻ピッカー
48dp+12% primary(ホバー/フォーカス時のみ増加)
512dp+14% primary(ホバー/フォーカス時のみ増加)

MD3 の標高は、トーナルサーフェスカラー を介して伝えられ、影では伝えられません。影は、混雑した背景に対する追加の保護が必要な場合にのみ使用されます。

モーション

MD3 Expressive(2025年5月)では、コンポーネントに スプリングベースのモーション物理 が導入されました。レガシーのイージング/持続時間システムは、トランジション(開始/終了/共有軸)に引き続き使用されます:

イージング持続時間トランジションタイプ
Emphasized500ms画面上で開始および終了
Emphasized decelerate400ms画面に入る
Emphasized accelerate200ms画面を出る
Standard300ms画面上で開始および終了(ユーティリティ)
Standard decelerate250ms画面に入る(ユーティリティ)
Standard accelerate200ms画面を出る(ユーティリティ)

CSS イージング値:

  • Emphasized: cubic-bezier(0.2, 0, 0, 1)
  • Emphasized decelerate: cubic-bezier(0.05, 0.7, 0.1, 1)
  • Emphasized accelerate: cubic-bezier(0.3, 0, 0.8, 0.15)
  • Standard: cubic-bezier(0.2, 0, 0, 1)
  • Standard decelerate: cubic-bezier(0, 0, 0, 1)
  • Standard accelerate: cubic-bezier(0.3, 0, 1, 1)

コンポーネントクイックリファレンス

コンポーネントWeb Element主要なバリアントカテゴリ
Buttonmd-filled-button, md-outlined-button, md-text-button, md-elevated-button, md-filled-tonal-buttonFilled、Outlined、Text、Elevated、Tonal; 5サイズ(XS–XL); トグルアクション
Button groupmd-button-groupStandard、Connectedアクション
Extended FABmd-extended-fabSurface、Primary、Secondary、Tertiaryアクション
FABmd-fabSmall、Medium、Largeアクション
FAB menu——アクション
Icon buttonmd-icon-button, md-filled-icon-button, md-filled-tonal-icon-button, md-outlined-icon-buttonStandard、Filled、Filled Tonal、Outlinedアクション
Segmented button—単一選択、複数選択アクション
Split button——アクション
Badge—Small(ドット)、Large(カウント)コミュニケーション
Loading indicator—線形、円形コミュニケーション
Progress indicatormd-linear-progress, md-circular-progress線形、円形; 確定/不確定コミュニケーション
Snackbar—一行、二行、アクションコミュニケーション
Tooltip—Plain、Richコミュニケーション
Card—Filled、Outlined、Elevated格納
Carousel—Multi-browse、Uncontained、Hero格納
Dialogmd-dialogBasic、Full-screen格納
Bottom sheet—Standard、Modalシート
Side sheet—Standard、Modalシート
Dividermd-dividerFull-width、Inset格納
Checkboxmd-checkbox—入力
Chipsmd-chip-set, md-assist-chip, md-filter-chip, md-input-chip, md-suggestion-chipAssist、Filter、Input、Suggestion入力
Date picker—Docked、Modal、Range入力
Menumd-menu, md-menu-item—入力
Radio buttonmd-radio—入力
Slidermd-sliderContinuous、Discrete、Range入力
Switchmd-switchアイコンあり/なし入力
Text fieldmd-filled-text-field, md-outlined-text-fieldFilled、Outlined入力
Time picker—Docked、Modal入力
App bar (top)—Center-aligned、Small、Medium、Largeナビゲーション
Navigation barmd-navigation-bar—ナビゲーション
Navigation drawermd-navigation-drawerStandard、Modalナビゲーション
Navigation rail——ナビゲーション
Search—Search bar、Search viewナビゲーション
Tabsmd-tabs, md-primary-tab, md-secondary-tabPrimary、Secondaryナビゲーション
Toolbar——ナビゲーション
Listmd-list, md-list-item一行、二行、三行データ表示

注: Web Element に — とマークされたコンポーネントは、まだ @material/web の実装がありません。これらのコンポーネントには、標準 HTML と CSS カスタムプロパティを使用してください。Compose のマッピングと例は、参照/component-catalog.md にあります。

コード例を含む完全なコンポーネント詳細: 参照/component-catalog.md

Jetpack Compose(プライマリ)

androidx.compose.material3 を MaterialTheme および Material 3 コンポーザブル(Scaffold、Button、NavigationBar、トップアプリバーなど)とともに使用します。

  • テーマ設定: MaterialTheme(colorScheme = …, typography = …, shapes = …)。ダイナミックカラーを希望する場合は、Android 12+(API 31+) では dynamicLightColorScheme / dynamicDarkColorScheme を推奨します。それ以外の場合は lightColorScheme / darkColorScheme または Material Theme Builder から生成されたテーマコードを使用します。
  • アダプティブ UI: ウィンドウサイズクラス、リスト詳細、サポートペインレイアウト、折りたたみデバイス — 参照/layout-and-responsive.md および 参照/navigation-patterns.md を参照してください。
  • エッジツーエッジとインセット: WindowInsets / スキャフォールドパディングを使用してコンテンツをレイアウトし、バーと IME が正しく動作するようにします — 参照/layout-and-responsive.md を参照してください。
  • 実験的 API: 一部の Material 3 API は @OptIn(ExperimentalMaterial3Api::class) またはエクスプレッシブオプトインを必要とします。BOM とコンパイラに一致させてください。
MaterialTheme(
    colorScheme = colorScheme, // dynamicLightColorScheme / lightColorScheme などから
    typography = Typography(),
    shapes = Shapes(),
) {
    // M3 コンテンツ — Scaffold、ナビゲーション、テキストフィールドについては参照を推奨
}

Web(制限あり): @material/web

重要: Web 向け Material Design 3 によると、Material Web Components はメンテナンスモード であり、M3 Expressive は Web に実装されていません。適切な場合にトークンベースの Web UI に @material/web を使用しますが、現在の Expressive 機能では Compose と同等に扱わないでください。

セットアップ

npm install @material/web

コンポーネントを個別にインポート

使用するコンポーネントのみを常にインポートしてください。パッケージ全体をインポートすると、バンドルが肥大化します:

// 良い — 個別インポート
import '@material/web/button/filled-button.js';
import '@material/web/button/outlined-button.js';
import '@material/web/textfield/outlined-text-field.js';
import '@material/web/icon/icon.js';

// 悪い — 絶対に行わないでください
import '@material/web'; // すべてをインポート

基本的な使用法

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <link href="https://fonts.googleapis.com/css2?family=Roboto+Flex:wght@400;500;700&display=swap" rel="stylesheet">
  <link href="https://fonts.googleapis.com/icon?family=Material+Symbols+Outlined" rel="stylesheet">
</head>
<body>
  <md-filled-button>はじめる</md-filled-button>
  <md-outlined-text-field label="メール" type="email"></md-outlined-text-field>

  <script type="module">
    import '@material/web/button/filled-button.js';
    import '@material/web/textfield/outlined-text-field.js';
  </script>
</body>
</html>

…

[翻訳のため省略]

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)

関連スキル