Communitygithub.com

coastdigitalgroup/coastai-skills

目的のある「空の状態」(ゼロデータ画面)を設計・実装し、コンテンツがない場合やまだ作成されていない場合に、ユーザーを導き、フラストレーションを減らし、明確な行動経路を提供します。

coastai-skills とは?

このスキルは、データが存在しない場合に表示される「空の状態」画面やコンポーネントを設計するためのフレームワークを提供します。単に空白の画面や「結果が見つかりません」というメッセージを表示する代わりに、このシステムは空の状態をオンボーディング、教育、プロアクティブな発見の機会として捉えます。初回ログイン時、検索結果ゼロ、フィルター適用時、空のカートなど、様々なシナリオに対応し、ユーザーの勢いを維持し、システムの有用性を明確にします。スキルは、空のトリガーの特定、視覚的階層の確立、アクション指向のコピーの作成、発見経路の提供、技術的制約の定義というステップを踏みます。また、単一アクションルール、共感優先、画像の関連性などの意思決定ルールと、アクセシビリティや応答性などの制約も定義されています。このスキルは、Claude Codeやその他のAIエージェントプラットフォームで使用でき、開発者がユーザーエクスペリエンスを向上させる空の状態を一貫して実装するのに役立ちます。

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

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

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

ドキュメント

空の状態システム

目的

空の状態システムは、表示するデータがない場合に表示される画面やコンポーネントを設計するためのフレームワークを提供します。空白の画面や単なる「結果が見つかりません」というメッセージを表示する代わりに、このシステムは空の状態をオンボーディング、教育、プロアクティブな発見の機会として扱います。潜在的な行き止まりを、ユーザーの勢いを維持し、システムの有用性を明確にする生産的な瞬間に変えます。

ユースケース

  • 初回実行エクスペリエンス: ユーザーが初めてログインし、まだコンテンツを作成していない場合(例:空のダッシュボードやプロジェクトリスト)。
  • 検索結果: ユーザーの検索クエリがゼロ件の結果を返した場合。
  • フィルタリング: アクティブなフィルターの組み合わせにより空のグリッドになった場合。
  • 空のコンテナ: 空のショッピングカート、クリアされた通知センター、新しいお気に入りリストなどの特定のUI要素。
  • エラー状態: 権限や接続の問題によりコンテンツの読み込みに失敗した場合(二次的なユースケース)。

使用すべきでない場合

  • ローディング状態: すぐにコンテンツが表示されると予想される場合は、スケルトンスクリーンまたはスピナーを使用します。
  • 永続的な「デッド」ページ: リンク切れや削除されたリソースには404ページを使用します。
  • 部分的なコンテンツ: 一部のデータは利用可能だが限られている場合は、空の状態ではなく標準のレイアウトパターンを使用します。
  • パッシブな背景: デザイン上空白であることが意図されているセクション(例:余白や装飾的な空白)には使用しないでください。

入力

  1. 空のシナリオタイプ: これはユーザーがクリアした状態(成功)、初回実行状態(オンボーディング)、または検索失敗(発見)ですか?
  2. ユーザーの意図: ユーザーは何を達成しようとしていたか、または何を見つけようとしていましたか?
  3. コアバリュープロポジション: 現在欠けているコンテンツの主な利点は何ですか?
  4. 利用可能なアクション: ユーザーにとって「最善の次の一手」は何ですか?

出力

  1. 空の状態の設計図: イラスト、見出し、本文、およびプライマリCTAを含む構造定義。
  2. コンテキストロジック: 空の状態をトリガーするタイミングと場所に関するルール。
  3. 発見戦略: 空白を埋めるための推奨コンテンツや教育のヒント。

ワークフロー

1. 空のトリガーを特定する

なぜ状態が空なのかを判断します。適切なトーンを選択するために分類します:

  • 初回実行(教育的): 最初の「作成」アクションを促します。
  • ユーザークリア(肯定的): 完了を認識します(例:「すべて完了!」)。
  • 検索/フィルター(ヘルパー): 検索を拡大または方向転換する方法を提供します。

2. 視覚的階層を確立する

空の状態を「三点ルール」(空の状態用に修正)を使用して構成します:

  • アンカー(ビジュアル): トーンを設定する、気を散らさないアイコンまたはイラスト。
  • コンテキスト(メッセージ): なぜ空なのかを説明する明確な見出しと、それを変える方法を説明する本文。
  • ターゲット(CTA): コンテンツの作成やフィルターのリセットをトリガーするプライマリボタン。

3. アクション指向のコピーを作成する

  • 見出し: 具体的に。「アイテムがありません」の代わりに「まだプロジェクトを作成していません」を使用します。
  • 本文: 価値を提供します。「プロジェクトはタスクを整理するのに役立ちます。最初のプロジェクトを作成して始めましょう。」
  • CTA: メリットに基づいた動詞を使用します。「プロジェクトを作成」または「無料トライアルを開始」。

4. 発見経路を提供する(二次アクション)

(検索のような)直接的な「作成」アクションがない場合は、代替案を提供します:

  • リセット: すべてのフィルターをクリアするリンク。
  • 提案: 人気のカテゴリまたは「もしかして:」の提案。
  • 教育: ドキュメントやビデオチュートリアルへのリンク。

5. 技術的制約を定義する

  • レスポンシブ対応: 空の状態が小さなビューポートでも中央揃えで読みやすいことを確認します。
  • アクセシビリティ: 状態が動的に表示されたときに確実に通知されるように、適切なARIAロール(例:role="status")を使用します。

意思決定ルール

  • ワンアクションルール: 潜在的な混乱の瞬間にユーザーを圧倒しないように、正確に1つのプライマリアクションに焦点を当てます。
  • 共感はユーモアに優先する: 少しの個性は構いませんが、明快さと有用性を優先します。解決策を隠す「巧妙な」コピーは避けてください。
  • 直接的 vs 間接的:
    • ユーザーが修正できる場合(例:初回実行)、プライマリCTAを使用します。
    • ユーザーが修正できない場合(例:検索失敗)、提案またはリセットリンクを使用します。
  • 画像の関連性: 特定のコンテキストを強化するイラストを使用します(例:検索には虫眼鏡、ファイルにはフォルダ)。

制約

  • アクセシビリティ: 空の状態のイラストには aria-hidden="true" を設定するか、純粋に装飾的にする必要があります。テキストはWCAG AAのコントラスト比を満たしている必要があります。プライマリCTAおよびすべての二次リンク/ボタンはWCAG 2.2 SC 2.5.8(最小ターゲットサイズ24x24ピクセル)を満たしている必要があります。
  • スケール: 空の状態は、置き換える実際のコンテンツのコンテナ幅を超えてはなりません。
  • 一貫性: パターン認識を構築するために、サイト全体のすべての空の状態で同じビジュアルスタイルとレイアウトを使用します。

一般的な失敗パターン

  • 「行き止まり」: 何かが空であることをユーザーに伝えるが、それを修正する方法は伝えない。
  • 過剰デザイン: プライマリCTAから注意をそらす、複雑で重いイラストを使用する。
  • ネガティブなトーン: エラーや失敗のように聞こえる言葉を使用する(例:「検索に失敗しました!」)。
  • 一般的なコピー: 検索から初回オンボーディングまで、すべてに「結果がありません」を使用する。
  • モバイルオーバーフロー: デスクトップでは見栄えが良いが、CTAを見るためだけにモバイルで垂直スクロールが必要なデザイン。

検証基準

  • 空の状態が、なぜ表示されているのかを明確に説明している。
  • 明確で実行可能なプライマリCTAまたは「リセット」パスがある。
  • 視覚的階層が、ビジュアルからCTAへと目を導く。
  • トーンがコンテキスト(オンボーディング vs 検索失敗)に一致している。
  • 状態がアクセシブルである(コントラスト、キーボードナビゲーション、role="status" または同等のライブリージョンによるスクリーンリーダー通知)。
  • プライマリCTAがWCAG 2.2 SC 2.5.8(最小ターゲットサイズ24x24ピクセル)を満たしている。
  • レイアウトがレスポンシブで、親コンテナ内で中央揃えになっている。

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.

関連スキル