hugging-face-ui-skills

Hugging Face UI スキル

AI エージェントで Hugging Face 風のインターフェースを構築するための、独自の制約です。

適用する場合

以下の場合にこれらのガイドラインを参照してください：

• ダークモードのインターフェースを構築する
• Hugging Face に着想を得たデザインシステムを作成する
• Inter フォントと 4px グリッドを使用して UI を実装する

色

• 主要なサーフェスには、必ず暗い背景（明度 < 20）を使用してください - 検出された明度：7
• ページの背景には必ず #0D1119 を使用してください（surface-base）
• カラーパレットを絞ることを推奨します（現在は 13 色が検出されています）
• アクセシビリティのため、テキストのコントラスト比を 4.5:1 以上に保ってください

セマンティックトークン

トークン	HEX	RGB	用途
surface-base	#0D1119	rgb(13,17,25)	ページの背景
surface-raised	#FFFFFF	rgb(255,255,255)	カード、モーダル、浮き上がったサーフェス
surface-overlay	#171D2A	rgb(23,29,42)	オーバーレイ、ツールチップ、ドロップダウン
text-primary	#3D3D3D	rgb(61,61,61)	見出し、本文テキスト
text-secondary	#909199	rgb(144,145,153)	セカンダリ、控えめなテキスト
text-tertiary	#4F4F57	rgb(79,79,87)	補足テキスト
border-default	#0B0F16	rgb(11,15,22)	控えめな境界線、区切り線

タイポグラフィ

• プライマリフォントファミリーには必ず Inter を使用してください
• 一貫性を保つため、単一のフォントファミリーを使用することを推奨します
• プライマリ見出しには必ず 61px / 700 を使用してください
• 本文テキストには必ず 15px / 500 を使用してください
• フォントウェイトを減らすことを推奨します（現在は 4 種類が検出されています）
• 見出しには必ず text-balance を、本文テキストには text-pretty を使用してください
• 数値データには tabular-nums を使用することを推奨します
• 明示的に指示されない限り、letter-spacing を変更しないでください

テキストスタイル

スタイル	フォント	サイズ	ウェイト	色	数
heading-1	Inter	61px	700	#E5E6E7	1
text-18px	Inter	18px	500	#303030	1
text-17px	Inter	17px	500	#3B3B3B	1
text-17px	Inter	17px	400	#A9ACB1	1
text-17px	Inter	17px	400	#65676F	1
body	Inter	15px	500	#353535	1
body-secondary	Inter	14px	400	#525252	2
body-secondary	Inter	14px	400	#3C3C3C	1
body-secondary	Inter	14px	500	#383838	1
body-secondary	Inter	14px	400	#7F848C	1

タイポグラフィの参考情報

フォントファミリー：

• Inter（106 回使用）

フォントサイズ： 7px, 8px, 9px, 10px, 11px, 12px, 13px, 14px, 15px, 17px, 18px, 61px

間隔

• 間隔には必ず 4px グリッドを使用してください
• 次のスケールから間隔を使用することを推奨します：1px, 2px, 3px, 4px, 5px, 6px, 7px, 8px
• 要素間のデフォルトの間隔には 2px を使用することを推奨します
• 任意の間隔の値は使用しないでください（デザインスケールを使用してください）
• コンテナ内のパディングを一貫させることを推奨します

境界線

• 必ず次のスケールから border-radius を使用してください：0px, 2px, 3px, 4px, 5px, 6px, 7px, 8px, 9px, 10px, 11px, 12px, 13px, 14px, 15px, 21px
• ピル形状の要素には 21px 以上の半径を使用することを推奨します
• 境界線の太さは次に限定することを推奨します：1px, 2px, 5px
• デフォルトの border-radius には 4px を使用することを推奨します
• 任意の border-radius の値は使用しないでください（デザインスケールを使用してください）
• 要素を区切るには、控えめな境界線（1px）を使用することを推奨します

境界線の半径の参考情報

スケール： 0px, 2px, 3px, 4px, 5px, 6px, 7px, 8px, 9px, 10px, 11px, 12px, 13px, 14px, 15px, 21px

レイアウト

• 必ずベースのビューポート幅を 1920px としてデザインしてください
• 要素の幅は次の値で統一することを推奨します：12px, 10px, 14px, 9px, 11px
• 明確な階層構造を持つ、テキスト主体のレイアウトを保つことを推奨します
• h-screen は使用せず、ビューポート全体の高さには h-dvh を使用してください
• 固定要素では必ず safe-area-inset を考慮してください
• 正方形の要素には、w-* + h-* の代わりに size-* を使用することを推奨します

検出されたレイアウトパターン

• メインコンテンツ：幅：1510px、高さ：754px
• メインコンテンツ：幅：1103px、高さ：796px
• ヘッダー：高さ：60px

コンポーネント

• 入力フィールドの高さには必ず 0px を使用してください

ボタン

バリエーション	背景	テキスト	境界線	高さ	半径
ゴースト	透明	#777B84	なし	-	-

入力フィールド

• 高さ：0px

インタラクティブ状態

フォーカス

• 2px のアウトラインをアクセントカラー（#5E6AD2）で必ず使用してください
• アウトラインオフセットには必ず 2px を使用してください
• フォーカスインジケーターを削除してはいけません

ホバー

• ボタン（プライマリ）：背景を 10% 明るくしてください
• ボタン（セカンダリ）：背景に #FFFFFF を使用してください
• リスト項目：背景に #FFFFFF を使用してください

無効状態

• 必ず opacity: 0.5 を使用してください
• 必ず cursor: not-allowed を使用してください

インタラクション

• 破壊的な操作や取り消せない操作には、必ず AlertDialog を使用してください
• ロード中の状態には、構造的なスケルトンを使用することを推奨します
• エラーは操作が行われる場所の近くに必ず表示してください
• input または textarea 要素での貼り付けを妨げてはいけません
• アイコンのみのボタンには、必ず aria-label を追加してください

アニメーション

• 明示的に要求されていない限り、アニメーションを追加してはいけません
• 合成プロパティ（transform、opacity）のみをアニメーションさせてください
• レイアウトプロパティ（width、height、top、left、margin、padding）をアニメーションさせてはいけません
• 表示時のアニメーションには ease-out を使用することを推奨します
• インタラクションのフィードバックは 200ms を超えてはいけません
• prefers-reduced-motion を尊重することを推奨します

パフォーマンス

• 大きな blur() や backdrop-filter の領域をアニメーションさせてはいけません
• アニメーションが実行中でないときに will-change を適用してはいけません
• レンダリングロジックで表現できる処理に useEffect を使用してはいけません