Communitygithub.com

UIデザイン

あらゆるUI画面やコンポーネント(Web/モバイル)のデザイン、構築、レビューを行う前に読み込むルール集。レイアウト、スペーシング、タイポグラフィ、色彩、シャドウ、ボタン、フォーム、カード、アイコン、ナビゲーション、画像、コピーライティング、モーション、アクセシビリティ、空/エラー状態をカバー。各トピックの詳細は参照ファイルに分かれており、タスクに関係するものだけを読む。

UIデザイン とは?

このスキルは、UIデザインのルールを包括的に提供するもので、特にAIエージェント(Claude Code、Cursor、Codexなど)がWeb/モバイル向けのユーザーインターフェースをデザイン・構築・レビューする際に役立ちます。ルールはMichael Filipiuk著『UI Design Principles』(2021年版)を基盤とし、WCAGアクセシビリティ基準や業界標準の慣例を補完しています。主な特徴として、リポジトリ既存のデザイントークン(Tailwind設定、CSS変数、shadcn/MUIテーマなど)を優先し、新たなトークンセットを導入しないこと、スペーシングには4pxや8pxのスケールを使用すること、ボディテキストは16〜17pxを標準とすること、コントラスト比4.5:1を遵守すること、クリックターゲットは44×44px以上とすることなど、50以上の具体的な非妥協ルールを定めています。また、各トピックごとに参照ファイル(`references/`フォルダ内)が用意されており、タスクに関係するファイルのみを読み込むことで効率的に作業できます。このスキルは、UIの一貫性、アクセシビリティ、使いやすさを確保するために設計されており、AIエージェントが自律的に高品質なUIを生成するためのガイドラインとして機能します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JuanEliasJabib02/ui-design-skill/tree/HEAD

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

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

ドキュメント

UIデザイン:インターフェース構築のためのルール

このルールは、Michael Filipiuk著『UI Design Principles』(2021年版)から抽出されたものです。このファイルには、すべての画面に適用されるルールが記載されています。references/(このファイルと同じディレクトリ)には、トピックごとに1ファイルずつ詳細が格納されています。タスクに関係するファイルだけを読んでください。

タグのないルールは同書からの引用です。(WCAG) は、同書に記載されていないアクセシビリティ基準を示します。(convention) は、不足を補うために追加された一般的な業界慣習値を示します。(derived) は、同書の独自手法で計算された値を示します。同書の1 pt = 1 CSS px = 1 iOS pt = 1 Android dpです。

リポジトリのデザインシステムを優先する

リポジトリに既存のトークンやテーマ(Tailwind設定、CSS変数、shadcn/MUIテーマ、components/ui/ライブラリなど)が存在する場合は、それらを使用してください。このスキルは、それらが定義していない部分のみを補完します。

  • リポジトリ独自のトークンの横に、第二のトークンセットを導入しないでください。
  • 並列的なコンポーネントを新たに作るよりも、既存のコンポーネントを再利用してください。
  • リポジトリ自体が以下のルールのいずれかを破っている場合(コントラスト不足、32pxのボタンなど)、リポジトリの値を保持し、その競合を報告してください。黙って上書きしないでください。

ルールが競合する場合の優先順位: ユーザビリティ > アクセシビリティ > 一貫性 > シンプルさ > 見た目

クイックパス

  1. まずは性格を決める: ブランドとオーディエンスに基づいて、遊び心がある、ニュートラル、またはシリアスから選択(references/personality-and-copy.md)。自分の好みは絶対に入れない。
  2. 画面より先にトークン: リポジトリのもの、またはreferences/tokens.mdから、色、タイプスケール、スペーシングスケールを取得。それ以外は使用しない。
  3. まずはグレースケールで: 階層、レイアウト、スペーシングを正しく設定してから、役割のある箇所にのみ色を追加する。
  4. すべての状態を持つコンポーネント(デフォルト、ホバー、プレス、フォーカス、無効、エラー、成功)、およびすべての画面状態(空、ローディング、エラー、404)。
  5. 完了を報告する前に: 自分が構築したものに対してreferences/checklist.mdを確認。スクリーンショット可能な場合は、コードではなくスクリーンショットでチェックする。

非妥協ルール

  1. スペーシングはスケールから取得する。 モバイルでは4ptスケール、Webでは8ptスケールを使用する。5、13、22 pxなどの値は使用しない。
  2. ボディテキストは16~17 px。 いかなるテキストも10 px未満にしてはならず、12 px以上を推奨。小さなテキストにLightウェイトは使用しない。
  3. タイプフェースは1つ、 デフォルトはサンセリフ。約5サイズを使用する。
  4. テキストやシャドウに#000000は使用しない。 #1F1F1Fなどの暗めの灰色を使用する。
  5. 1つのプライマリカラーのみ、目立たせる必要があるものにだけ適用する。すべてが目立つと、何も目立たなくなる。
  6. コントラスト: ボディテキストは4.5:1、大きなテキストとUI部品は3:1 (WCAG)。
  7. 意味を伝えるのに色だけに頼らない。 エラー、成功メッセージ、リンクには、アイコン、テキスト、ウェイト、アンダーラインも併用する。
  8. すべてのタップまたはクリックターゲットは少なくとも44×44 px、表示上のグリフがそれより小さくても同じ。
  9. ボタンの高さは40~60 px、 グループ内のプライマリボタンは1つ。ボタンがペアになる場合、プライマリは右側に配置。ラベルは実際の動作を正確に示す。
  10. 入力項目には常に表示ラベルを付ける。 プレースホルダーだけではラベルにならない。シングルカラムフォームを使用し、インライン検証を行い、ユーザーが入力した内容は決して消去しない。
  11. シャドウはソフトに(Yオフセット大、ブラー大、不透明度5~10%)、インタラクティブまたは浮上した要素にのみ使用。
  12. アイコンは1つのパックから、 1つのスタイルで、同じストローク幅と丸みで統一。汎用的に知られていないアイコンにはラベルを付ける。
  13. アニメーションはフィードバックを与え、 持続時間は1000 ms未満とし、イージングを適用する(リニアは不可)。
  14. Lorem Ipsumは使わない。 実際の短く、人間らしいコピーを書く。エラーは問題の修正方法を伝える。ダイアログは対象オブジェクトと結果を明示する。
  15. 同じものは、同じ見た目、同じ振る舞いで、画面間で統一する。振る舞いはプラットフォームのパターンに従う。

どの参照ファイルを読むか

タスクの対象読むファイル
新しいプロジェクトやテーマ、値の選定tokens.md(スペーシング、タイプスケール、色の役割、角丸、シャドウ、モーション、CSSスターター)
ページや画面のレイアウト、グリッド、スペーシング、階層layout.md
テキストスタイル、見出し、段落typography.md
パレット、ダークモード、シャドウ、グラデーションcolor-and-depth.md
ボタンとCTAbuttons.md
フォーム、入力、セレクト、チェックボックス、バリデーションforms.md
カード、アイテムのリストcards.md
アイコンicons.md
タブバー、トップナビ、サイドバー、リンクnavigation.md
写真、イラスト、空状態、404用アートimagery.md
ブランドの雰囲気、ボタンラベル、ダイアログ、エラー、トーンpersonality-and-copy.md
トランジション、ホバー、ローディング、フィードバックmotion.md
コントラスト、altテキスト、ターゲット、キャプションaccessibility.md
再利用するコンポーネント、状態、空/404画面、デザインシステムsystem-and-states.md
完成した画面のレビューchecklist.md

すべてのパスは、このスキルの references/ フォルダ以下にあります。

関連スキル