ramp-ui-skills について
ramp-ui-skillsは、Ramp風の画面を構築するAIエージェント向けの設計ルールです。カラー、タイポグラフィ、レイアウト、操作性、パフォーマンスを定め、ライトモードの画面やデザインシステムに適しています。
主な機能
- 01Rampのカラーとトークン
- 02Interのタイポグラフィ規則
- 034pxグリッドと間隔スケール
- 04アクセシブルな操作状態
- 05アニメーションと性能の制約
活用シーン
- 01Ramp風のライト画面の実装
- 02AIエージェントによるUI実装の指針
- 03タイポグラフィと間隔の統一
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ ihlamury/ design-skills --skill ramp-ui-skillsインストール後、Claude Code で/ramp-ui-skillsを入力して読み込まれたか確認します。
同梱ファイルmetadata.json
詳細
Ramp UI スキル
AI エージェントで Ramp スタイルのインターフェースを構築するための、独自の制約です。
適用する場合
以下の場合に、これらのガイドラインを参照してください。
- ライトモードのインターフェースを構築するとき
- Ramp に着想を得たデザインシステムを作成するとき
- Inter フォントと 4px グリッドを使用して UI を実装するとき
色
- 主なサーフェスには、明るい背景を使用することを推奨します
- ページ背景(
surface-base)には、#FFFFFFを使用する必要があります - 主なアクションとフォーカス状態(
accent)には、#EBF123を使用する必要があります - カラーパレットを絞ることを推奨します(現在、14 色が検出されています)
- アクセシビリティのため、テキストのコントラスト比を 4.5:1 以上に保つ必要があります
セマンティックトークン
| トークン | HEX | RGB | 用途 |
|---|---|---|---|
surface-base | #FFFFFF | rgb(255,255,255) | ページ背景 |
surface-raised | #DDF21A | rgb(221,242,26) | カード、モーダル、浮き上がったサーフェス |
surface-overlay | #5A544C | rgb(90,84,76) | オーバーレイ、ツールチップ、ドロップダウン |
text-primary | #B8B8B8 | rgb(184,184,184) | 見出し、本文テキスト |
text-secondary | #8B8B8B | rgb(139,139,139) | セカンダリテキスト、控えめなテキスト |
text-tertiary | #A7A7A7 | rgb(167,167,167) | 補足テキスト |
border-default | #EAF380 | rgb(234,243,128) | 控えめな境界線、区切り線 |
accent | #EBF123 | rgb(235,241,35) | 主なアクション、リンク、フォーカス |
タイポグラフィ
- プライマリフォントファミリーには
Interを使用する必要があります - 一貫性を保つため、フォントファミリーを 1 種類にすることを推奨します
- 主見出しには
61px/700を使用する必要があります - 本文テキストには
19px/500を使用する必要があります - フォントウェイトを絞ることを推奨します(現在、6 種類が検出されています)
- 見出しには
text-balanceを、本文テキストにはtext-prettyを使用する必要があります - 数値データには
tabular-numsを使用することを推奨します - 明示的に依頼されない限り、文字間隔を変更してはいけません
テキストスタイル
| スタイル | フォント | サイズ | ウェイト | 色 | 数 |
|---|---|---|---|---|---|
heading-1 | Inter | 61px | 700 | #DDDCDA | 1 |
heading-2 | Inter | 58px | extra_bold | #EDEDEA | 1 |
body | Inter | 19px | 500 | #A9A9A9 | 1 |
body-secondary | Inter | 17px | semi_bold | #A4A4A4 | 1 |
body-secondary | Inter | 17px | 500 | #ACACAC | 1 |
body-secondary | Inter | 17px | 400 | #6D6E6D | 1 |
text-16px | Inter | 16px | semi_bold | #9D9D9D | 1 |
text-16px | Inter | 16px | 500 | #B4B4B4 | 1 |
text-16px | Inter | 16px | 400 | #B4B4B4 | 1 |
text-16px | Inter | 16px | 400 | #ACACAC | 1 |
タイポグラフィの参考情報
フォントファミリー:
Inter(33 回使用)
フォントサイズ: 10px、11px、12px、13px、14px、15px、16px、17px、19px、58px、61px
余白
- 余白には 4px グリッドを使用する必要があります
- 次のスケールから余白を使用することを推奨します:3px、4px、5px、8px、38px、65px
- 要素間のデフォルトの間隔には 5px を使用することを推奨します
- 任意の余白値は使用せず、デザインスケールを使用してください
- コンテナ内のパディングを一貫させることを推奨します
境界線
- 角丸には次のスケールを使用する必要があります:4px、5px
- 境界線の幅は 1px、3px に限定することを推奨します
- デフォルトの角丸には 4px を使用することを推奨します
- 任意の角丸値は使用せず、デザインスケールを使用してください
- 要素を区切るには、控えめな境界線(1px)を使用することを推奨します
角丸の参考情報
スケール: 4px、5px
レイアウト
- 基準のビューポート幅を 1920px として設計する必要があります
- 要素の幅を一貫させることを推奨します:20px、24px、54px、75px、28px
- 明確な階層を備えた、テキスト主体のレイアウトを維持することを推奨します
h-screenは使用せず、ビューポート全体の高さにはh-dvhを使用してください- 固定要素では
safe-area-insetを考慮する必要があります - 正方形の要素には、
w-*とh-*の組み合わせではなくsize-*を使用することを推奨します
検出されたレイアウトパターン
- ヘッダー:高さ:50px
- メインコンテンツ:幅:1920px、高さ:871px
- メインコンテンツ:幅:1920px、高さ:872px
- ヘッダー:高さ:39px
コンポーネント
ボタン
| バリエーション | 背景 | テキスト | 境界線 | 高さ | 角丸 |
|---|---|---|---|---|---|
| ゴースト | 透明 | #51590E | なし | - | - |
インタラクティブ状態
フォーカス
- アクセントカラー(
#EBF123)の2pxアウトラインを使用する必要があります 2pxのアウトラインオフセットを使用する必要があります- フォーカスインジケーターを削除してはいけません
ホバー
- ボタン(プライマリ):背景を10%明るくします
- ボタン(セカンダリ):背景に
#DDF21Aを使用します - リスト項目:背景に
#DDF21Aを使用します
無効状態
- MUST
opacity: 0.5を使用します - MUST
cursor: not-allowedを使用します
インタラクション
- 破壊的な操作や取り消せない操作には、MUST
AlertDialogを使用します - ローディング状態には、SHOULD 構造を保ったスケルトンを使用します
- エラーは操作が行われる場所のすぐ近くに表示します
inputまたはtextarea要素での貼り付けを NEVER ブロックします- アイコンのみのボタンには、MUST
aria-labelを追加します
アニメーション
- 明示的に要求されていない限り、アニメーションを NEVER 追加します
- コンポジターのプロパティ(
transform、opacity)のみを MUST アニメーションさせます - レイアウトプロパティ(
width、height、top、left、margin、padding)は NEVER アニメーションさせます - 入場アニメーションには
ease-outを SHOULD 使用します - インタラクションのフィードバックは、200ms を NEVER 超えないようにします
prefers-reduced-motionを SHOULD 尊重します
パフォーマンス
- 大きな
blur()またはbackdrop-filterの領域は NEVER アニメーションさせます - アニメーションの実行中以外は
will-changeを NEVER 適用します - レンダーロジックとして表現できる処理に
useEffectを NEVER 使用します
コメント
Markdown 対応