Communitygithub.com

UIリファインメント

デザインスキル。ユーザーが知らないうちに気づける改善点を発見します。既存のウェブサイトを検査したり、新しいサイトを計画し、段階に応じたUIロードマップを作成し、階層、ナビゲーション、コンテンツ、アクセシビリティ、レスポンシブ動作、マイクロインタラクション、クリエイティブなWebGLエフェクトを洗練します。特にポートフォリオや表現力豊かな個人サイトに適していますが、他のサイトにも応用可能です。

UIリファインメント とは?

このスキルは、ユーザーが自ら質問することを求めず、デザインパートナーとして潜在的な改善点を発見し、具体的な機会を説明し、何を構築する価値があるかをユーザーが選択できるよう支援します。固定テーマや強制的な再デザインではなく、実際のウェブサイトの検査に基づいて、プロジェクトの現在の段階に合わせた小さな優先順位付けされたロードマップを作成します。目的とページマップ、コンテンツと注意、ビジュアル言語、コンポーネントと小さなインタラクション、検証と洗練の5つの段階を経て、構造、ナビゲーション、アクセシビリティ、レスポンシブ動作、マイクロインタラクション、そしてクリエイティブなWebGLエフェクトを洗練します。特にポートフォリオや表現力豊かな個人サイトに適していますが、他のサイトにも応用可能で、Claude Code、Cursor、CodexなどのAIエージェントプラットフォームで使用できます。各フェーズ後に観察結果、提案、理由を明確に示し、次のフェーズを推奨することで、継続的な改善を容易にします。

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

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

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

ドキュメント

UIリファインメント は何をしますか?

ユーザーは何を求めるべきか知っている必要はありません。 可能性を発見し、具体的な機会を説明し、ユーザーが何を構築する価値があるかを選択できるように支援するデザインパートナーとして機能します。このスキルは、固定テーマ、強制的な再デザイン、インストールするアニメーションのリスト、実際のウェブサイトの検査の代替ではありません。

インタラクションは注意を要求するのではなく、好奇心に報いるべきです。

プロジェクトの実際の段階から始める

ライブプレビュー、ページ、コード、利用可能なデザインノートを検査します。既に機能しているもの、未完成のもの、サイトのオーディエンス、訪問者が何をしようとしているかを特定します。階層とコンテンツが確定している場合は、計画を再開しないでください。訪問者がページを理解したりナビゲートできない場合は、エフェクトに飛び込まないでください。

プロジェクトが支援を必要としている場所から始めて、小さな優先順位付けされたロードマップを作成します。

  1. 目的とページマップ: 各ページの役割、それが保持するコンテンツ、ページ間の期待されるパスを定義します。訪問者の意図に基づいて、重複するトピックをマージ、分割、またはクロスリンクします。同じ主題が異なる場所で異なる深さで表示される場合があります。プロジェクトの概要は成果を強調し、記事はプロセスを教え、デモはエッセイを読まずに実験できるようにします。
  2. コンテンツと注意: 最初に理解すべきこと、それをサポートするもの、後で探索できるもの、最も明確な次のアクションを確立します。装飾的な指標や埋め草ではなく、事実に基づく証拠と有用な説明を提示します。
  3. ビジュアル言語とシグネチャーアイデア: サイト全体で一貫したアイデンティティを維持し、メインビジュアルやインタラクションがそれを印象的にするかを判断します。ムードとコンテンツを理解する前に、劇的なエフェクトを選択しないでください。
  4. コンポーネントと小さなインタラクション: ナビゲーション、ボタン、スペーシング、テキスト、カード、フッター、フォーム、スクロールキュー、ホバー/プレス/フォーカス状態、プログレッシブディスクロージャーを検査します。
  5. 検証と洗練: アクセシビリティ、レスポンシブ動作、パフォーマンス、実際のインタラクション、最終結果が以前よりも落ち着いて明確になっているかをテストします。

ユーザーに観察したこと→提案すること→なぜ役立つかを示します。具体的なページ固有の例を含む小さな次のフェーズを推奨します。実装する前に、意味のある構造的、ビジュアル、または動作の選択肢について話し合います。承認済みの範囲内での日常的な修正は、繰り返し許可を求めずに実行します。フェーズの後、結果を確認し、次の有用なステップを提案します。ロードマップ全体を自動的に実装しないでください。

サイトを評価したりロードマップを作成する際は、UI監査と決定ガイドを参照してください。

構造は親しみやすく、目的があるべき

同様の目的を持つサイトから成功しているナビゲーションの慣習を借用します。訪問者はすでに物事を見つける方法について期待を持っています。宛先を区別可能にし、名前を理解可能にし、ナビゲーションを高速に保ちます。ヘッダー、サイドバー、セカンダリメニューは、コンテンツが正当化しない限り、すべて存在する必要はありません。

すべての見出し、カード、ボタンに均等な重みを与えるのではなく、目に見える情報階層を作成します。中心的なアイデアをすぐに理解できるようにし、サポートコンテキストとより深い説明が後に続くようにします。1つの明確な次のアクションは、複数の競合するアクションよりも多くの場合うまく機能します。ページ間の重複は、目的と説明レベルが異なる場合に問題ありません。関連するエクスペリエンスを丸ごと複製するのではなく、リンクします。

拡張の前に重要な結果を示します。訪問者が要求したときに、詳細、推論、方法、図、または関連する概念を明らかにします。データが実際に意味がある場合にのみ定量化します。それ以外の場合は、問題、決定、結果を説明します。機密情報を公開したり、チャート、推薦の言葉、指標を捏造したりしないでください。

架空のテンプレートではなく、実際の詳細を洗練する

配置、余白、タイプ階層、コントラスト、要素の相対的な視覚的重みを検査します。観察された問題がそれを必要とする場合に、以下の具体的な介入を検討します。

  • テキストが画像と競合する場合は、明白な長方形のパネルではなく、シーンにフェードインするローカライズされた暗いまたは明るいグラデーションを使用します。
  • メタデータやスキルピルがコンテンツを圧倒する場合は、それらのサーフェスを統一して静かにします。情報バッジはクリック可能なボタンを装うべきではありません。
  • アクションが不明確な場合は、ラベル、プロミネンス、アイコン、または配置を改善します。代替アクションは目立たないようにします。
  • 次のセクションがフォールドの向こうに隠れている場合は、微妙なスクロールキューを与えるか、そのセクションの一部を表示したままにします。
  • 密度の高いコンテンツをスキャンするのが難しい場合は、それを再グループ化し、意味のある見出しを追加し、プログレッシブディスクロージャーを使用するか、説明を実際の図や注釈付きスクリーンショットに置き換えます。
  • インターフェースがフラットに感じられる場合は、控えめな照明、透明度、ぼかし、テクスチャ加工されたサーフェス、エッジハイライト、または予期しない仕切りにグローを検討します。すべてにグローをかけるのではありません。
  • コントロールにはプラットフォーム依存の絵文字よりも一貫したSVG/画像アイコンを優先します。絵文字は意図的にコンテンツの一部である場合にのみ使用します。

小さく適切に実行された詳細は、人々をより近くで見させます。訪問者が1つの思慮深い詳細に気づくと、他の詳細を発見するために探索するかもしれません。しかし、余分な装飾はコンテンツと簡単に競合する可能性があります。

コンポーネント固有の改善アイデアについては、マイクロインタラクションを参照してください。

動作を予測可能でレスポンシブにする

コントロールは、ホバー、フォーカス、プレス、進行中、成功、失敗、無効状態に適切なフィードバックを示す必要があります。ホバー時のわずかな浮き上がりや境界線の変更、プレス時の穏やかな圧縮、スムーズな回復により、ボタンは触感的に感じられます。方向矢印は、それが指す方向に微妙に動くかもしれません。しかし、すべてのバッジやテキストが動く必要はありません。

ルーチンナビゲーションは即座に行えるようにします。特別なページ遷移は、稀で意図的な瞬間のために予約し、訪問者が続行できる前にそれを見るように強制しないでください。フォームが送信、アップロード、保存、または失敗した場合は、結果を明確に認識し、有用な回復パスを提供します。重要なコンテンツがホバーによってのみアクセス可能でないことを確認します。

アニメーションを階層として扱う

シグネチャーエフェクト(メインビジュアルアイデア)、環境モーション(環境内の生命)、招待されたインタラクション(訪問者への応答)、イースターエッグ(小さな任意の発見)を区別します。それらが注意を奪い合わないように一緒に計画します。1つの首尾一貫したインタラクションは、5つの無関係なエフェクトよりも記憶に残る可能性があります。

WebGLは装飾的なパーティクル以上のものを提供します。シミュレートされたガラスと水、GPU流体、変形するジオメトリ、ボリューメトリックな雰囲気、奥行き、3Dワールド、インタラクティブなビジュアライゼーション、複雑なリビール。マスクはエフェクトを画像の特定の領域に制限できます。レイヤー化された奥行きにより、雨、窓、前景のガラス、遠くの風景が異なる動作をすることができます。物理的または視覚的に首尾一貫した結果を優先します。複合体をモーションでテストします。

ユーザーがクリエイティブなモーションを求める場合、WebGLアイデアとライブデモを参照してください。リンク付きの関連するデモをいくつか提示し、それぞれが作成できるエクスペリエンスを説明し、既存のサイトにどのように適合するかを実装する前に話し合います。コードやアセットを再利用する前に、元の作品のライセンスを確認してください。一部のリファレンスはプレーンなWebGLではなくWebGPUまたはThree.jsを使用しています。互換性を確認してください。

雰囲気は印象を与えます。コンテンツは信頼を獲得します。発見はそれを記憶に残します。

実際のウェブサイトで検証する

WAVE、Lighthouse、axe-core、または同等のツールが利用可能な場合にアクセシビリティチェックを実行します。空のリンク、欠落している名前とラベル、非常に低いコントラスト、テーブルヘッダー、冗長なタイトルテキスト、見出し構造、フォームステータスメッセージを検査します。確認されたエラーを修正します。すべての警告を盲目的にクリアするのではなく、コンテキストでアラートを調査します。実際の画像とアニメーション状態でコントラストをテストします。自動監査はキーボードと手動テストの代わりにはなりません。

デスクトップ、タブレット、モバイルレイアウト、拡大テキスト、キーボードナビゲーション、タッチ入力、prefers-reduced-motionを検査します。サポートされていない、または低パフォーマンスのWebGLデバイスには有用なフォールバックを提供します。ナビゲーション速度、入力応答性、コンテンツの読みやすさを保護します。既存のテストを実行し、変更がサイトを破壊していないことを確認します。

特定のテストと症状から治療法の提案については、UI監査と決定ガイドを参照してください。

各フェーズ後に引き継ぐ

変更された内容、場所、理由、テストされた内容、未解決の問題、推奨される次のフェーズを要約します。変更を提案するだけの場合は、提案と完了した作業を区別します。ロードマップは後のセッションで再開しやすいようにします。エージェントが責任を持って自分で実装できる実装の選択をユーザーに求めることは避けます。

迷ったときは、簡素化してください。

関連スキル