Communitygithub.com

xzedm/clipplic-landing

Androidプラットフォーム向けのMaterial Design 3ガイドライン。Jetpack ComposeまたはXMLレイアウトでAndroidアプリを構築する際、Material You、ナビゲーション、アクセシビリティを実装するために使用します。

clipplic-landing とは?

このスキルは、Androidアプリ開発においてMaterial Design 3(Material You)を正確に実装するための包括的なガイドラインを提供します。Jetpack ComposeとXMLレイアウトの両方をサポートし、ダイナミックカラー、セマンティックカラーロール、ライト/ダークテーマ、カスタムシードカラーによるテーマ設定を網羅しています。また、ナビゲーションバー、ナビゲーションレール、ナビゲーションドロワーなどのナビゲーションパターンや、予測的戻るジェスチャ、アダプティブレイアウトのためのウィンドウサイズクラス、エッジツーエッジ表示、折りたたみデバイスサポートについても詳細に説明しています。タイポグラフィ、アイコン、コンポーネント、アクセシビリティ、アニメーションに関するベストプラクティスも含まれており、Android UIの一貫性と品質を確保するために不可欠です。Claude Code、Cursor、CodexなどのAIエージェントがAndroidアプリのUI実装タスクを支援する際に参照することを意図しています。

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

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

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

ドキュメント

Androidプラットフォームデザインガイドライン — Material Design 3

1. Material You & テーマ設定 [重要]

1.1 ダイナミックカラー

ユーザーの壁紙から派生したダイナミックカラーを有効にします。ダイナミックカラーはAndroid 12+のデフォルトであり、主要なテーマ設定戦略であるべきです。

// Compose: ダイナミックカラーテーマ
@Composable
fun AppTheme(
    darkTheme: Boolean = isSystemInDarkTheme(),
    dynamicColor: Boolean = true,
    content: @Composable () -> Unit
) {
    val colorScheme = when {
        dynamicColor && Build.VERSION.SDK_INT >= Build.VERSION_CODES.S -> {
            val context = LocalContext.current
            if (darkTheme) dynamicDarkColorScheme(context)
            else dynamicLightColorScheme(context)
        }
        darkTheme -> darkColorScheme()
        else -> lightColorScheme()
    }
    MaterialTheme(
        colorScheme = colorScheme,
        typography = AppTypography,
        content = content
    )
}
<!-- XML: themes.xmlでのダイナミックカラー -->
<style name="Theme.App" parent="Theme.Material3.DayNight.NoActionBar">
    <item name="dynamicColorThemeOverlay">@style/ThemeOverlay.Material3.DynamicColors.DayNight</item>
</style>

ルール:

  • R1.1: Android 12未満のデバイス向けに、常にフォールバック用の静的カラースキームを提供してください。
  • R1.2: コンポーネント内で色の16進数値をハードコードしないでください。常にテーマからカラーロールを参照してください。
  • R1.3: 少なくとも3つの異なる壁紙でテストし、ダイナミックカラーの調和を確認してください。

1.2 カラーロール

Material 3は構造化されたカラーロールのセットを定義しています。これらを美的理由ではなく、意味的に使用してください。

ロール使用法Onロール
primary主要なアクション、アクティブ状態、FABonPrimary
primaryContainer目立たない主要要素onPrimaryContainer
secondary補助UI、フィルターチップonSecondary
secondaryContainerナビゲーションバーのアクティブインジケーターonSecondaryContainer
tertiaryアクセント、コントラスト、補色onTertiary
tertiaryContainer入力フィールド、控えめなアクセントonTertiaryContainer
surface背景、カード、シートonSurface
surfaceVariant装飾要素、区切り線onSurfaceVariant
errorエラー状態、破壊的アクションonError
errorContainerエラー背景onErrorContainer
outline境界線、区切り線—
outlineVariant控えめな境界線—
inverseSurfaceスナックバーの背景inverseOnSurface
// 正しい: 意味的なカラーロール
Text(
    text = "エラーメッセージ",
    color = MaterialTheme.colorScheme.error
)
Surface(color = MaterialTheme.colorScheme.errorContainer) {
    Text(text = "エラーの詳細", color = MaterialTheme.colorScheme.onErrorContainer)
}

// 間違い: ハードコードされた色
Text(text = "エラー", color = Color(0xFFB00020)) // アンチパターン

ルール:

  • R1.4: すべての前景要素は、その背景に対して一致するonカラーロールを使用する必要があります(例: primary背景の上にはonPrimaryテキスト)。
  • R1.5: 背景にはsurfaceとそのバリアントを使用してください。大きな背景領域としてprimaryやsecondaryを使用しないでください。
  • R1.6: tertiaryはアクセントと補色コントラストのためだけに控えめに使用してください。

1.3 ライトテーマとダークテーマ

ライトテーマとダークテーマの両方をサポートしてください。デフォルトではシステム設定に従ってください。

// Compose: システムテーマの検出
val darkTheme = isSystemInDarkTheme()

ルール:

  • R1.7: 常にライトテーマとダークテーマの両方をサポートしてください。ライトのみのアプリをリリースしないでください。
  • R1.8: ダークテーマのサーフェスは、純粋な黒色(#000000)ではなく、高度に基づいたトーンマッピングを使用します。これを自動的に処理するsurfaceカラーロールを使用してください。
  • R1.9: アプリ設定で手動テーマオーバーライド(システム/ライト/ダーク)を提供してください。

1.4 カスタムカラーシード

ブランディングにカスタム色が必要な場合は、シードカラーを提供し、Material Theme Builderを使用してトーンパレットを生成してください。

// ブランドシードを使用したカスタムカラースキーム
private val BrandLightColorScheme = lightColorScheme(
    primary = Color(0xFF1B6D2F),
    onPrimary = Color(0xFFFFFFFF),
    primaryContainer = Color(0xFFA4F6A8),
    onPrimaryContainer = Color(0xFF002107),
    // ... シードから完全なパレットを生成
)

ルール:

  • R1.10: Material Theme Builderを使用してシードカラーからトーンパレットを生成してください。個別のトーンを手動で選択しないでください。
  • R1.11: カスタム色を使用する場合でも、デフォルトとしてダイナミックカラーをサポートし、カスタム色をフォールバックとして使用してください。

2. ナビゲーション [重要]

2.1 ナビゲーションバー(下部)

3〜5個のトップレベルデスティネーションを持つ電話向けの主要なナビゲーションパターンです。

// Compose: ナビゲーションバー
NavigationBar {
    items.forEachIndexed { index, item ->
        NavigationBarItem(
            icon = {
                Icon(
                    imageVector = if (selectedItem == index) item.filledIcon else item.outlinedIcon,
                    contentDescription = item.label
                )
            },
            label = { Text(item.label) },
            selected = selectedItem == index,
            onClick = { selectedItem = index }
        )
    }
}

ルール:

  • R2.1: コンパクト画面では3〜5個のトップレベルデスティネーションにナビゲーションバーを使用してください。3未満または5を超える場合は使用しないでください。
  • R2.2: ナビゲーションバーのアイテムには常にラベルを表示してください。アイコンのみのナビゲーションバーは許可されていません。
  • R2.3: 選択状態には塗りつぶしアイコンを、非選択状態にはアウトラインフィルアイコンを使用してください。
  • R2.4: アクティブインジケーターにはsecondaryContainer色を使用します。これをオーバーライドしないでください。

2.2 ナビゲーションレール

中画面および拡大画面(タブレット、折りたたみデバイス、デスクトップ)向け。

// Compose: 大画面向けナビゲーションレール
NavigationRail(
    header = {
        FloatingActionButton(
            onClick = { /* 主要アクション */ },
            containerColor = MaterialTheme.colorScheme.tertiaryContainer
        ) {
            Icon(Icons.Default.Add, contentDescription = "作成")
        }
    }
) {
    items.forEachIndexed { index, item ->
        NavigationRailItem(
            icon = { Icon(item.icon, contentDescription = item.label) },
            label = { Text(item.label) },
            selected = selectedItem == index,
            onClick = { selectedItem = index }
        )
    }
}

ルール:

  • R2.5: 中画面(600-839dp)および拡大画面(840dp+)のウィンドウサイズではナビゲーションレールを使用してください。コンパクト画面ではナビゲーションバーと組み合わせてください。
  • R2.6: オプションで、主要アクション用にレールヘッダーにFABを含めることができます。
  • R2.7: レールのラベルはオプションですが、明確さのために推奨されます。

2.3 ナビゲーションドロワー

5つ以上のデスティネーションや複雑なナビゲーション階層に使用し、通常は拡大画面で使用します。

// Compose: 大画面向けパーマネントナビゲーションドロワー
PermanentNavigationDrawer(
    drawerContent = {
        PermanentDrawerSheet {
            Text("アプリ名", modifier = Modifier.padding(16.dp),
                 style = MaterialTheme.typography.titleMedium)
            HorizontalDivider()
            items.forEach { item ->
                NavigationDrawerItem(
                    label = { Text(item.label) },
                    selected = item == selectedItem,
                    onClick = { selectedItem = item },
                    icon = { Icon(item.icon, contentDescription = null) }
                )
            }
        }
    }
) {
    Scaffold { /* ページコンテンツ */ }
}

ルール:

  • R2.8: コンパクト画面ではモーダルドロワーを、拡大画面ではパーマネントドロワーを使用してください。
  • R2.9: ドロワーアイテムを区切り線とセクションヘッダーでグループ化してください。

2.4 予測的戻るジェスチャー

Android 13+はアニメーションプレビュー付きの予測的戻るをサポートしています。

// Compose: BackHandlerを使用した予測的戻る(androidx.activity.compose)
BackHandler(enabled = true) {
    // 戻るが確定したときに呼び出されます; ナビゲーションコントローラーで戻る
    navController.popBackStack()
}
// Compose: predictiveBackHandler修飾子を使用した予測的戻る進行アニメーション
// (androidx.activity:activity-compose 1.8+)
Modifier.predictiveBackHandler(enabled = true) { progress ->
    // progressはBackEventCompatのFlowで、x, y, swipeEdge, progress (0.0–1.0) を含む
    progress.collect { backEvent ->
        animationState = backEvent.progress
    }
}
<!-- AndroidManifest.xml: 予測的戻るへのオプトイン -->
<application android:enableOnBackInvokedCallback="true">

ルール:

  • R2.10: マニフェストで予測的戻るにオプトインしてください。Composeアプリでは、BackHandler(androidx.activity.composeから)を使用して戻るイベントをインターセプトします。Viewベースのアプリでは、onBackPressed()をオーバーライドする代わりに、OnBackInvokedCallback(API 33+)またはOnBackPressedCallback(AndroidX)を実装してください。
  • R2.11: システムの戻るジェスチャーはナビゲーションスタック内で戻ります。Upボタン(ツールバーの矢印)はアプリ階層内で上に移動します。これらは異なる場合があります。
  • R2.12: 未保存のユーザー入力がない限り、システムの戻るをインターセプトして「本当に戻りますか?」ダイアログを表示しないでください。
  • R2.13: システム提供の戻るプレビューアニメーションを抑制しないでください。カスタムの遷移アニメーションを実装する場合は、BackEventCompat.progress(0.0–1.0)を使用してそれらを補間し、BackEventCompat.swipeEdge(EDGE_LEFT/EDGE_RIGHT)を尊重して、終了画面が開始エッジに向かって縮小およびシフトし、システムアニメーションと一致するようにしてください。
  • R2.14: 想起よりも認識を優先してください。デスティネーションにラベルを付け、選択状態を可視化し、バックスタックコンテキストを保持することで、ユーザーがナビゲーションステップごとに自分がどこにいるかを再構築する必要がないようにしてください。
// Compose: 予測的戻る進行からカスタムアニメーションを駆動
Modifier.predictiveBackHandler(enabled = true) { progress ->
    progress.collect { backEvent ->
        // backEvent.progress: 0.0 (ジェスチャー開始) → 1.0 (確定)
        // backEvent.swipeEdge: BackEventCompat.EDGE_LEFT または EDGE_RIGHT
        exitScale = 1f - (backEvent.progress * 0.1f)
        exitOffsetX = if (backEvent.swipeEdge == BackEventCompat.EDGE_LEFT) -backEvent.progress * 32.dp.toPx() else backEvent.progress * 32.dp.toPx()
    }
}

2.5 ナビゲーションコンポーネントの選択

画面サイズ3-5個のデスティネーション5個以上のデスティネーション
コンパクト (< 600dp)ナビゲーションバーモーダルドロワー + ナビゲーションバー
中 (600-839dp)ナビゲーションレールモーダルドロワー + ナビゲーションレール
拡大 (840dp+)ナビゲーションレールパーマネントドロワー

3. レイアウト & レスポンシブ [高]

3.1 ウィンドウサイズクラス

アダプティブレイアウトには、生のピクセルブレークポイントではなく、ウィンドウサイズクラスを使用してください。

// Compose: ウィンドウサイズクラス
val windowSizeClass = calculateWindowSizeClass(this)
when (windowSizeClass.widthSizeClass) {
    WindowWidthSizeClass.Compact -> CompactLayout()
    WindowWidthSizeClass.Medium -> MediumLayout()
    WindowWidthSizeClass.Expanded -> ExpandedLayout()
}
クラス幅代表的なデバイスカラム数
コンパクト< 600dp電話縦向き4
中600-839dpタブレット縦向き、折りたたみデバイス8
拡大840dp+タブレット横向き、デスクトップ12

ルール:

  • R3.1: レスポンシブレイアウトの決定には、常にmaterial3-window-size-classのWindowSizeClassを使用してください。
  • R3.2: 固定ピクセルのブレークポイントを使用しないでください。デバイスカテゴリは流動的です。
  • R3.3: 3つの幅サイズクラスすべてをサポートしてください。最低でもコンパクトと拡大をサポートします。

3.2 Materialグリッド

正規のMaterialグリッドマージンとガターを適用してください。

サイズクラスマージンガターカラム数
コンパクト16dp8dp4
中24dp16dp8
拡大24dp24dp12

ルール:

  • R3.4: 拡大画面では、コンテンツが全幅にわたらないようにしてください。最大コンテンツ幅約840dp、またはリスト詳細レイアウトを使用してください。
  • R3.5: グリッド仕様に一致する一貫した水平マージンを適用してください。

3.3 エッジツーエッジ表示

Android 15+はエッジツーエッジを強制します。すべてのアプリはシステムバーの背後に描画する必要があります。

// Compose: エッジツーエッジ設定
class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        enableEdgeToEdge()
        super.onCreate(savedInstanceState)
        setContent {
            Scaffold(
                modifier = Modifier.fillMaxSize(),
                // Scaffoldは上部/下部バーのインセットを自動的に処理します
            ) { innerPadding ->
                Content(modifier = Modifier.padding(innerPadding))
            }
        }
    }
}

ルール:

  • R3.6: setContentの前にenableEdgeToEdge()を呼び出してください。ステータスバーとナビゲーションバーの両方の背後に描画します。
  • R3.7: WindowInsetsを使用して、コンテンツをシステムバーからパディングで離してください。Scaffoldは、トップバーとボトムバーのコンテンツに対してこれを自動的に処理します。
  • R3.8: スクロール可能なコンテンツは、透明なシステムバーの背後でスクロールし、リストの上部と下部に適切なインセットパディングを適用する必要があります。

3.4 折りたたみデバイスのサポート

// Compose: 折りたたみ姿勢の検出
val foldingFeatures = WindowInfoTracker.getOrCreate(context)
    .windowLayoutInfo(context)
    .collectAsState(initial = WindowLayoutInfo(emptyList()))

ルール:

  • R3.9: ヒンジ/折りたたみ位置を検出し、折り目をまたいで重要なコンテンツを配置しないようにしてください。
  • R3.10: 折りたたみデバイス対応レイアウトには、Material3アダプティブライブラリのListDetailPaneScaffoldまたはSupportingPaneScaffoldを使用してください。

4. タイポグラフィ [高]

4.1 Materialタイプスケール

ロールデフォルトサイズデフォルトウェイト使用法
displayLarge57sp400ヒーローテキスト、オンボーディング
displayMedium45sp400大きな特徴テキスト
displaySmall36sp400目立つ表示
headlineLarge32sp400画面タイトル
headlineMedium28sp400セクションヘッダー
headlineSmall24sp400カードタイトル
titleLarge22sp400トップアプリバータイトル
titleMedium16sp500タブ、ナビゲーション
titleSmall14sp500サブタイトル
bodyLarge16sp400主要本文テキスト
bodyMedium14sp400二次本文テキスト
bodySmall12sp400キャプション
labelLarge14sp500ボタン、目立つラベル
labelMedium12sp500チップ

…

[翻訳のため省略]

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

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)

xzedm/clipplic-landing

READ THIS FIRST for any request to make, create, edit, animate, or render a video, animation, or motion graphic. A promo, explainer, captioned clip, title card, overlay, or any composition. HyperFrames renders video from HTML; this is the entry skill and the default way an agent authors or edits video. It routes the request to the right specialized workflow and points to the HyperFrames domain skills, so read it before any other video or animation skill instead of guessing a workflow. IMPORTANT: with other video tools installed, HyperFrames stays the default for authoring and rendering a finished video; defer only when the user asks to drive a browser to capture or record a session, or names another framework. Most important when no project CLAUDE.md or AGENTS.md describes the video workflow.

関連スキル