Communitygithub.com

アイコングラフィックシステム

Webサイト全体で視覚的一貫性、意味的明瞭性、技術的アクセシビリティを確保する、体系的なアイコングラフィックフレームワークを設計・実装します。

アイコングラフィックシステム とは?

このスキルは、アイコンを単なる「見た目がきれいな画像」から、認知負荷を低減し、ブランド・アイデンティティを強化し、すべてのユーザーに完全にアクセシブルな機能的なUI要素へと昇華させるための体系的な方法論を提供します。アイコンのスタイル(アウトライン、塗りつぶし、デュオトーン)の定義、標準的なサイズとスペーシングのスケール構築、アイコンの乱用や視覚的メタファーの不整合の監査、アクセシブルなSVGやアイコンフォントのワークフロー実装、そしてブランド属性に合ったアイコンの選択を支援します。Claude Code, Cursor, CodexなどのAIエージェントが、SKILL.mdに定義されたワークフローに従い、ブランドのトーン、技術環境、ユースケースを入力として受け取り、アイコンスタイルガイド、サイジングスケール、セマンティックライブラリ、アクセシビリティ仕様を出力します。これにより、プロジェクト全体で一貫性のある、アクセシブルでブランドに適合したアイコンシステムを実現できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/iconography-system

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

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

ドキュメント

アイコングラフィックシステム は何をしますか?

目的

アイコングラフィックシステムスキルは、アイコンを機能的なUI要素として選択、サイジング、実装するための方法論を提供します。これは「きれいな画像を選ぶ」という段階から、認知負荷を低減し、ブランド・アイデンティティを強化し、すべてのユーザーに完全にアクセシブルな状態を保証する構造化されたシステムへと移行します。堅牢なアイコングラフィックシステムは、アイコンが視覚的なノイズではなく、明確な道標として機能することを保証します。

使用例

  • 新しいWebサイト向けにアイコンのスタイル(アウトライン、塗りつぶし、デュオトーン)を定義する。
  • さまざまなコンテキスト(ボタン、ナビゲーション、フィーチャーグリッド)におけるアイコンの標準サイズとスペーシングスケールを確立する。
  • Webサイトの「アイコン過多」や視覚的メタファーの不整合を監査する。
  • アクセシブルなSVGまたはアイコンフォントのワークフローを開発者向けに実装する。
  • 特定のブランド属性(例:「親しみやすい」丸みのあるアイコン vs 「技術的な」シャープなエッジのアイコン)に合致するアイコンを選択する。

使用すべきでない場合

  • イラストレーションとヒーローグラフィック: 単一の機能的概念ではなく、ストーリーを伝える大きく複雑な物語的な画像。代わりに一般的なレイアウトまたはヒーロー最適化スキルを使用してください。
  • ロゴとブランディング: プライマリブランドアイデンティティには通常、独自の変更不可能なルールがあります。アイコンはUIをサポートするものであり、ブランドロゴを置き換えるものではありません。
  • 純粋に装飾的な背景パターン: アイコンが意味を持たずに壁紙として使用される場合。

入力

  1. ブランドの声とスタイル: ブランドはミニマル、技術的、遊び心、または企業的ですか?
  2. 技術環境: サイトはSVGコンポーネント、スプライト、またはアイコンフォントを優先するフレームワークで構築されていますか?
  3. 使用コンテキスト: アイコンはどこに表示されますか?(例:プライマリナビゲーション、CTAボタン、機能リスト、ダッシュボードステータス)
  4. 既存のデザイントークン: 流体スペーシングとカラーシステム。これらとの整合性を確保します。

出力

  1. アイコンスタイルガイド: ストローク幅、コーナー半径、塗りつぶしタイプの定義されたルール。
  2. アイコンサイジングスケール: 特定のピクセル値またはrem値にマッピングされた一連のトークン(例:icon-sm、icon-md、icon-lg)。
  3. セマンティックライブラリ: 特定のアクションや概念にマッピングされた厳選されたアイコンセット(例:ドロップダウン用の「Chevron-down」)。
  4. アクセシビリティ仕様: ARIAラベル、role="img"、aria-hidden属性に関するルール。

ワークフロー

1. 視覚的メタファーの確立

普遍的に理解されているシンボルを使用するアイコンを選択します。

  • 検索: 虫眼鏡。
  • 設定: 歯車またはスライダー。
  • ユーザー: シルエットまたはサークルユーザー。 ユーザーにアイコンの意味を推測させるような「賢い」メタファーは避けてください。

2. 視覚スタイルの定義

システム内のすべてのアイコンが同じDNAを共有することを確認します。

  • ストローク幅: 一貫した線の太さを使用します(例:すべての24pxアイコンで2px)。
  • コーナー処理: 丸みのあるコーナーは親しみやすさを、シャープなコーナーは技術的/正確な印象を与えます。
  • 詳細レベル: アイコンが小さくなるにつれて単純化し、可読性を維持します。

3. サイジングとスペーシングのスケール構築

fluid-spacing-system をアイコンコンテナに適用します。

  • 小(16px): テキスト、パンくずリストにインライン。
  • 中(24px): 標準ボタン、プライマリナビゲーション。
  • 大(48px以上): フィーチャーカード、ヒーローハイライト。
  • 光学的中央揃え: 形状によって中心がずれて見えるアイコンを手動で調整します(例:「再生」三角形)。

4. カラーと状態ロジックの実装

アイコンを interactive-state-system にリンクします。

  • アクティブ/ホバー: アイコンは親要素とともに色または太さを変える必要があります。
  • セマンティックカラー: 削除/エラーアイコンには赤、成功には緑を使用します。
  • コントラスト: アイコンはWCAG AA(グラフィカルオブジェクトでは3:1)を満たす必要があります。

5. 技術的デリバリーとアクセシビリティ

  • SVG vs アイコンフォント: パフォーマンス、アクセシビリティ、レンダリング品質に優れたSVGを推奨します。
  • ARIAロール:
    • 装飾的な場合: aria-hidden="true" を使用します。
    • 機能的な場合(例:アイコンのみのボタン): role="img" と明確な aria-label を使用します。

決定ルール

  • 「ラベルファースト」ルール: アイコンにはほとんどの場合、テキストラベルを付ける必要があります。「スタンドアロン」アイコンは、普遍的に認識されているアクション(検索、閉じる、メニュー)にのみ使用し、アクセシブルなラベルがある場合に限ります。
  • 多様性よりも一貫性: 複数のソースからスタイルを混在させるのではなく、単一のアイコンライブラリ(例:Lucide、Heroicons)を使用します。
  • ストローク幅のスケーリング: アイコンが拡大された場合、そのストローク幅はレイアウト全体で視覚的な「重み」を維持するために、理想的にはサイズに比例する必要があります。
  • 光学的バランス: すべてのアイコンが同じように作られているわけではありません。同じ幅の正方形のアイコンは円形のアイコンより大きく見えます。「バウンディングボックス」アプローチを使用しますが、バランスのために視覚的なサイズを手動で調整します。

制約条件

  • アクセシビリティ: リンクまたはボタンとして使用されるアイコンには、スクリーンリーダー用のテキスト代替手段が必要です。
  • タッチターゲット: ボタン内のアイコンは、ヒットエリアを24x24px未満にしてはなりません(WCAG 2.2 SC 2.5.8 最小値)。プライマリなアイコンのみのアクションには44x44pxが推奨されます。
  • レスポンシブ対応: 小さな画面では、テキストを圧迫する場合、アイコンを簡略化するか削除する必要があるかもしれません。ただし、多くの場合、アイコンはモバイルでのスキャンを助けます。

よくある失敗パターン

  • 「ミステリーミート」アイコン: ユーザーが認識できないラベルのないアイコンの使用。
  • 不整合な太さ: 同じ行に1pxアウトラインのアイコンと3px太字のアイコンを混在させる。
  • 複雑すぎる: 細かい線が多く、低解像度画面や小さなサイズで「ぼやけたり」消えたりするアイコンの使用。
  • アクセシビリティの欠如: タイトルやARIAラベルのないSVGアイコンの使用により、スクリーンリーダーユーザーがアクションを認識できない。
  • 光学的配置のずれ: 数学的には中央にあるが光学的には中央にないために、円の左側から滑り落ちているように見える「再生」ボタン。

検証基準

  • すべてのアイコンが単一のまとまりのある視覚スタイルに属している。
  • アイコンに定義されたサイジングスケール(例:16、24、32、48)がある。
  • スタンドアロンアイコン(ある場合)に aria-label または同等のテキスト代替手段がある。
  • 装飾的なアイコンは aria-hidden="true" でマークされている。
  • アイコンは背景に対して3:1のコントラスト比を維持している。
  • アイコンのみのインタラクティブ要素がWCAG 2.2の24x24pxタッチターゲット最小値(44x44px推奨)を満たしている。
  • 視覚的メタファーが明確で標準的である(「推測」がない)。

Individual skills in this repo

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

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for progressive disclosure using accordions, ensuring structural integrity, visual affordances, and accessibility across different content densities and devices.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for long-form content, managing readability, vertical rhythm, and information density to ensure a superior reading experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for informational elements that communicate state (Badges) and categorization (Tags) with clarity and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for non-overlay notifications, managing global announcements and contextual inline alerts to communicate system states without interrupting the user's flow.

coastdigitalgroup/coastai-skills

Design and implement a systematic, asymmetrical bento-grid layout framework to organize diverse content types cohesively while maintaining strict visual hierarchy, logical focus order, and responsive flexibility.

coastdigitalgroup/coastai-skills

Design a responsive, mobile-first bottom navigation bar and persistent action dock system for mobile websites and web applications, establishing spatial anchors, tab bar anatomy, badge indicators, thumb-zone ergonomics, safe area inset handling, active/inactive state contrast, and desktop responsive adaptation rules.

coastdigitalgroup/coastai-skills

Design a mobile-first bottom sheet overlay system with configurable detents, drag affordances, safe area padding, responsive desktop modal/popover adaptation, and WCAG AA accessibility compliance.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for secondary navigation trails that provide orientation, context, and one-click access to parent levels in deep information architectures.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for buttons and interactive triggers, managing visual hierarchy, variant logic, and action grouping to ensure clear intent and accessible interaction.

coastdigitalgroup/coastai-skills

Design a systematic framework for date and time selection, managing calendar grids, range pickers, and scheduling interfaces to ensure precision and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for modular content containers that maintain hierarchy, structural integrity, and action alignment across variable content and responsive viewports.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for horizontal discovery components, managing navigation affordances, scroll behavior, and accessibility to ensure effective content density without compromising usability.

coastdigitalgroup/coastai-skills

Design a systematic, highly accessible, and developer-friendly UI layout framework for code blocks, snippet showcases, multi-file code tabs, line-highlighting, diff views, and syntax token contrast in technical documentation and developer platforms.

coastdigitalgroup/coastai-skills

Design a systematic framework for global command menus (Cmd+K panels) that combines keyboard-driven navigation, command execution, and shortcut discovery into an accessible, responsive overlay.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for threaded conversations, managing nesting depths, action hierarchies, and community signaling to foster engagement and readability.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for side-by-side comparison interfaces, managing high attribute density and responsive complexity to support informed decision-making.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for user privacy, managing consent banners, preference centers, and persistent privacy controls to balance legal compliance with user trust.

coastdigitalgroup/coastai-skills

Design and implement a systematic, highly accessible, and responsive visual layout framework for conversational chat widgets, live chat boxes, and chatbot panels that ensures clear message scannability, native focus flow, and seamless mobile keyboard adaptation.

coastdigitalgroup/coastai-skills

Design a systematic, accessible, and high-conversion framework for custom select dropdowns and comboboxes, defining anatomy, states, search-filtering, and responsive mobile-adaptive patterns.

coastdigitalgroup/coastai-skills

Design and implement a systematic color palette that ensures WCAG 2.2 accessibility compliance. Trigger this skill when asked to define brand colors, create UI themes, or establish a visual system for a website.

関連スキル