Communitygithub.com

インターフェースフィール

アプリやサイトのUIの動きや応答性を洗練させ、より高速でプレミアムな印象を与えるためのスキルです。アニメーション原則、UX法則、UIテクニックを活用して、Web/モバイルプロジェクトの品質を監査・改善します。

インターフェースフィール とは?

このスキルは、UIの動きと応答性に関する包括的な監査と修正を行います。40項目(12のアニメーション原則、8つのUX法則、20のUIテクニック)とモーションシステムをチェックし、レポートを作成した後、各項目に応じたパターンで問題を修正します。 主にClaude CodeやCodexなどのAIエージェントを想定して設計されており、プロジェクトのデザインシステムやモーショントークンを尊重しつつ、既存の実装を重複して追加しないように注意します。パフォーマンス(LCP、INP、バンドルサイズ)、アクセシビリティ、コピーは別のパスで扱います。 ワークフローは3つのパスに分かれています。**Pass 1**ではコード調査とプローブにより現状を監査し、**Pass 2**ではチェックリストに基づいて信頼性、ビルド項目、ピック項目を順に修正します。**Pass 3**では修正を検証し、テーマとモバイル幅で確認します。 このスキルは、プロジェクトのUIが「正しい」だけでなく「優れている」と感じられるようにするための実践的なガイドです。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/groseljgal/interface-feel/tree/HEAD

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

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

ドキュメント

インターフェースフィール は何をしますか?

インターフェースの動きと応答性に関するマスターパス。現在のアプリを40項目(12のアニメーション原則、8つのUX法則、20のUIテクニック)とモーションシステムに対して監査し、レポートを作成し、各項目のパターンで問題を修正します。ほとんどのアプリはリストの半分を既に持っているため、監査ではその旨を報告し、重複して追加しません。速度、ターゲットサイズ、信頼性は常に適用し、装飾は作業ツールでは控えめにします。

プロジェクト自身のデザインシステム、モーショントークン、ルールがここでの内容よりも優先されます。パフォーマンス予算(LCP、INP、バンドルサイズ)、アクセシビリティ、コピーは、これとは別のパスで扱います。

このスキルのファイル

ファイル用途
reference.md40項目それぞれ:確認方法、修正パターン、スキップ条件、実際の監査で見つかった内容
motion.mdモーションシステム:トークン、12のルール、CSSパターン、モーション監査方法
audit/census.shコード調査:各項目の背後にあるパターンをカウントし、ファイル:行を表示
audit/probe.jsライブページプローブ:実際のヒットターゲットサイズ、持続時間、イージング、数値、見出し、コードフィールド、プレースホルダー
report-template.md監査レポート:項目ごとに1行の判定、作業順序、チェックしていない内容

Pass 1: 監査(変更しない)

  1. まずプロジェクトのデザインシステム、モーショントークン、UIルールを読む。
  2. プロジェクトルートから調査を実行:bash <this skill>/audit/census.sh . --show 5。出荷されている表面のみを読みます(依存関係、ビルド、ベンダーコピー、テスト、ベンチマーク、生成ファイル、コメント行は除外;CENSUS_EXCLUDE="dir1,dir2" で追加)。高速実行にはripgrepをインストール;なければスクリプトはperlにフォールバックします。カウントは開くべきリードであり、判定ではありません。
  3. アプリを起動。主要な各ページで、1440px幅と375px幅、そしてアプリが持つ各テーマで audit/probe.js を実行(コンソールに貼り付けるか、ブラウザツールのJavaScriptランナーで await する)。ページを1画面ずつスクロールし、位置を復元します。非表示タブには幅がなく、フレームを描画しません:先に表示してください。出力を判断して読む:spaced とマークされたターゲット(次のコントロールとのギャップが下限に達している)は重要度が低い;数値は変化する場合のみ tabular-nums が必要;装飾的なモックウィンドウは aria-hidden にするか、行を無視します。
  4. スクリプトでは見えない操作を手動で、実際のポインターイベント(ブラウザツールのクリック、合成.click()ではない)を使って行う:有料または不可逆のアクションを2回素早く押し、サーバーへの影響をカウント;ネットワークと書き込みを600msに制限して押す;すべてのレイヤーを高速で開閉し、閉じかけの状態で再度開き、その不透明度をサンプリング(motion.md「再開の計測」);閉じかけのメニュー内を押す;アクセント付きおよび異なる大文字小文字のクエリを入力;ホバーサブメニューに向かって斜めに移動;レイヤーを開いた状態でAndroidの戻るボタン;電話シートをスワイプ。
  5. report-template.md からレポートを作成:40行すべて、各項目を there、missing、wrong、skip とその理由、証拠としてファイル:行または数値、そして build または pick を記入。修正前にそれを表示する。

Pass 2: チェックリストに従って修正

  1. 信頼性を最優先:項目39と、請求を2倍にしたりデータを失う可能性のあるものすべてを、修正前に失敗するテストとともに。
  2. Build 項目は外観を変えずに動作を変更する(ヒットスロップ、セーフトライアングル、戻るジェスチャー、アクセント折りたたみ、ショートカット、コマンドメニューエントリ、楽観的書き込み、スケルトン、モーショントークン、可逆トランジション)。reference.md と motion.md のパターンに従い、プロジェクト自身のコンポーネントとトークンを通じて修正し、ロジックにはテストを追加。
  3. Pick 項目は外観または製品を変更する(コーナー、ブラープレースホルダー、確認の代わりの元に戻す、エラービート、新しいモーションビート、ビュートランジション)。各項目を、スケール1で両方のテーマでbefore/afterとしてベンチマークし、番号付きで分離可能にし、オーナーが選んだもののみをビルド。
  4. 削除した装飾を新しい装飾で置き換えない。

Pass 3: 検証

調査とプローブを再実行し、数値をレポートと比較する。すべての修正されたインタラクションをユーザーのように駆動し、両方のテーマで、電話幅でも別途確認する。ビルド、テスト、視認承認、デプロイをそれぞれ別の事実として報告し、測定できなかったもの(実機なし、プロダクションビルドなし)を明記する。

チェックリスト

番号は reference.md とレポートに対応。

#項目失敗条件
Aアニメーション原則(motion.md)
1スカッシュとストレッチランディングバッジ、ドット、ノブが突然停止する
2予備動作押下に1フレーム以内の状態がない(スケール約0.97、約100ms)
3段取り開かれたレイヤーが主要なものを不明瞭にする
4ポーズ to ポーズ忙しいボタン、ラベル、アイコンの切り替えが幅や内容でジャンプする
5フォロースルーレイヤーのコンテンツがコンテナに溶接されたように到着する
6イーズイン、イーズアウトUIモーションに linear またはデフォルトの ease;3つ以上のイージング
7弧線何かが直線で遠くまで移動する
8二次アクション完了したアクションに確認の2番目のビートがない
9スナッピータイミングUI応答が300ms超;1つのサーフェスが他のものと異なる;終了が短くない
10誇張されたフィードバック無効な送信が、色のビートなしでわずかな動きのみを示す
11ソリッドドローイングシャドウとレイヤーが光と奥行きで矛盾する
12アピールスケール1でステップ実行した1つの実際のフローに継ぎ目が見える
BUX法則
13フィッツの法則デスクトップで32px未満、または電話で44px未満の実際のターゲット
14より大きなヒットエリア画像を拡大して成長させたターゲット、または重なり合う兄弟要素
15ヒックの法則1つのメニューブロックに5つ以上の項目
16ミラーの法則チャンク化されていないトップレベル項目が約7つ以上
17ドハティのしきい値押下から次の描画まで400ms超で、最初に応答するものがない
18ポステルの法則クエリのアクセント、大文字小文字、スペースのバリエーションが何も見つからない
19ヤコブの法則パターンがプラットフォームと異なる動作(ホバーサブメニュー、戻るでレイヤーを閉じる)
20使用頻度毎日のアクションが1ステップまたは1コマンド以上離れている
C速度とフィードバック
21スケルトンローダールートが空白を描画するか、クリックフレームにスピナーを表示する
22楽観的更新安価で元に戻せる書き込みがサーバーの応答まで何も表示しない
23コマンドメニュー行き先がクリックでは到達できるが、タイピングでは到達できない
24ショートカットヒントショートカットのあるコントロールがツールチップにそれを表示しない
25元に戻すトースト復元可能な削除に元に戻すがない(オーナーが確認の代わりにするかどうかを決定)
26Stale-while-revalidate再訪したページが待機し、最後のデータを表示しない
27プリレンダリング次にありそうなページが意図時にプリフェッチされていない(プロダクションで判断)
28ブラープレースホルダー読み込み中の画像が灰色のボックス
29ビュートランジショングリッドから詳細への開封に共有要素モーフがない
30スワイプで閉じる電話シートやドロワーをスワイプで閉じられない
31割り込み可能なアニメーション終了中に再開するとゼロから再生
Dプラットフォームと詳細
32予測的戻るレイヤーを開いた状態でAndroidの戻るボタンがページを離れる
33ヒットスロップ小さなアイコンコントロールに非表示のターゲット拡大がない
34セーフエリアインセット下部フロートが viewport-fit=cover 下で env(safe-area-inset-*) を無視する
35ワンタイムコード自動入力コードフィールドに autocomplete="one-time-code" と inputmode="numeric" がない
36タブラーニュメラル変化する数値がジッタする(tabular-nums なし)
37バランスの取れた見出し短い複数行見出しにオーファンが残る(text-wrap: balance なし)
38連続コーナースクィークルコーナーが考慮されていない(見た目の判断:ベンチマーク)
E信頼性
39冪等性キー有料または不可逆アクションの2回の高速押下が2つのサーバー効果を生む
40セーフトライアングルホバーサブメニューが斜め方向への移動で閉じる

よくある間違い

  • 既存のものを追加する:スケルトン、キャッシュ、モーショントークンはしばしば既にある;判定は there。
  • クライアント側の重複排除をお金のガードにする:2回のクリックがボタンを無効にする再レンダリングの前に着地する。サーバー側でガード(条件付き更新、決定論的キー、ロック)し、押下をrefで保持する。
  • 画像をターゲットの代わりに拡大する;デスクトップ幅のみでターゲットをチェックし、デスクトップルールが電話の下限を殺す。
  • 開閉のキーフレーム:それらは逆転できない。状態属性にトランジションを使用し、離れるレイヤーを inert にする。
  • 元に戻す、コーナー、エラートーンをエンジニアリングの選択として扱う。それらはオーナーに属する。
  • 開発サーバーやバックグラウンドタブでプリフェッチやタイミングを判断する。

関連スキル