descript-ui-skills

Descript UI スキル

AI エージェントで Descript スタイルのインターフェースを構築する際の、独自の制約です。

適用する場面

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

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

色

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

セマンティックトークン

トークン	HEX	RGB	用途
surface-base	#2C0814	rgb(44,8,20)	ページの背景
surface-raised	#F9F6F3	rgb(249,246,243)	カード、モーダル、浮き上がったサーフェス
surface-overlay	#F2212E	rgb(242,33,46)	オーバーレイ、ツールチップ、ドロップダウン
text-primary	#484543	rgb(72,69,67)	見出し、本文テキスト
text-secondary	#747474	rgb(116,116,116)	セカンダリ、控えめなテキスト
text-tertiary	#F4A9AF	rgb(244,169,175)	補足テキスト
border-default	#ECE3E4	rgb(236,227,228)	控えめな境界線、区切り線
destructive	#F2212E	rgb(242,33,46)	エラー状態、削除アクション
warning	#F9F6F3	rgb(249,246,243)	警告状態、注意

タイポグラフィ

• プライマリフォントファミリーには必ず Inter を使用してください
• 一貫性を保つため、フォントファミリーは 1 種類にすることを推奨します
• プライマリ見出しには必ず 79px / 700 を使用してください
• 本文テキストには必ず 18px / 400 を使用してください
• フォントウェイトは regular、bold、medium に限定してください
• 見出しには必ず text-balance を、本文テキストには text-pretty を使用してください
• 数値データには tabular-nums を使用することを推奨します
• 明示的に指示されない限り、字間を変更しないでください

テキストスタイル

スタイル	フォント	サイズ	ウェイト	色	数
heading-1	Inter	79px	700	#F1E6E3	1
body	Inter	18px	400	#BEBEBE	1
body-secondary	Inter	17px	500	#3E3337	1
body-secondary	Inter	16px	400	#C6ACB4	1
body-secondary	Inter	16px	400	#3E3236	1
caption	Inter	15px	500	#484543	1
label	Inter	15px	400	#A52335	1
label	Inter	15px	400	#413438	1
label	Inter	14px	400	#747474	1
label	Inter	14px	400	#F4A9AF	1

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

フォントファミリー：

• Inter（15 回使用）

フォントサイズ： 13px、14px、15px、16px、17px、18px、79px

余白

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

境界線

• 角丸には必ず次のスケールを使用してください：3px、6px、7px、9px、13px
• 境界線の幅は次に限定することを推奨します：1px、3px、4px
• デフォルトの角丸には 6px を使用することを推奨します
• 任意の角丸値は使用しないでください（デザインスケールを使用してください）
• 要素を分けるには、控えめな境界線（1px）を使用することを推奨します

角丸の参考情報

スケール： 3px、6px、7px、9px、13px

レイアウト

• 基準ビューポート幅 1920px 向けに必ずデザインしてください
• 次の要素幅を一貫して使用することを推奨します：8px、621px、620px、9px、68px
• 明確な階層構造を持つ、テキスト中心のレイアウトを維持することを推奨します
• h-screen は使用せず、ビューポート全体の高さには h-dvh を使用してください
• 固定要素では必ず safe-area-inset を考慮してください
• 正方形の要素には w-* と h-* の組み合わせではなく、size-* を使用することを推奨します

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

• メインコンテンツ：幅：1920px、高さ：1080px
• メインコンテンツ：幅：1920px、高さ：920px

コンポーネント

ボタン

バリエーション	背景	テキスト	境界線	高さ	角丸
ゴースト	透明	#F4A9AF	なし	-	-

インタラクティブな状態

フォーカス

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

ホバー

• ボタン（プライマリ）：背景を10％明るくします
• ボタン（セカンダリ）：背景に #F9F6F3 を使用します
• リスト項目：背景に #F9F6F3 を使用します

無効状態

• 必ず 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 を絶対に使用しないでください