Communitygithub.com

21 Grams UI

既存のUIをAIらしさから脱却させ、プロジェクト自身のコンポーネントとトークンを使って、実績のあるUXとモーションの原則に従った洗練された見た目にアップリフトします。

21 Grams UI とは?

このスキルは、既存のUIを「AIが作った」という印象から脱却させ、プロジェクト自身が持つコンポーネントとデザイントークンを最大限に活用しながら、人間中心のUX原則とアニメーション技法を適用することで、プロフェッショナルで洗練された外観に向上させます。具体的には、20のUX/アニメーション原則(スカッシュ&ストレッチ、予期、ステージング、イージングなど)、10のデザインハック(同心円半径、アルファ境界、OKLCH色空間、dvh単位など)、20のアニメーションクラフト(トリガー起点の変形、shared layout、ストレッチなど)を網羅したガイドラインに従ってUIを監査・修正します。このスキルは、Claude Code、Cursor、Codexなどの任意のAIエージェントで動作し、まずプロジェクトのデザインシステムの棚卸しを行い、監査レポートをユーザーに提示した後に、プロジェクトのトークンとコンポーネントのみを使用して修正を適用します。また、ボタンやカードの半径、タイポグラフィ、スペーシング、モーション、カラーコントラストなど、具体的な数値と実装方法が詳細に定義されており、ユーザーが「UIを磨いてほしい」「AIっぽくないようにしてほしい」「21 Grams UIを適用してほしい」と依頼した際に最適です。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ilbognov/21grams/tree/HEAD/skills/ui

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

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

ドキュメント

21 Grams UI は何をしますか?

既存のUIに対するパスです。21 Grams UI(21 GramsファミリーのUIパッケージ)は、プロダクトを再設計したり、独自のUIキットを持ち込んだりしません。AIによって構築されたUIの特徴を取り除き、プロジェクトがすでに持っているコンポーネントとトークンを通じて、固定された一連のルールを適用します。その結果、見た目は考慮され、高速に感じられ、それでもプロダクトに属するものになります。

ルールゼロ:プロジェクト自身のコンポーネントを使う

すべての変更は、プロジェクトがすでに使用しているものを経由して行われます。21 Grams UIは、決して並行したコンポーネントセットを構築しません。

  1. 何かに触れる前に棚卸しを行う。 デザイントークンまたはテーマ(CSS変数、Tailwind設定、テーマファイル)、コンポーネントライブラリ(shadcn/ui、Radix、MUI、Chakra、社内キット、クライアントのデザインシステム)、アイコンセット、チャートライブラリ、アニメーションライブラリを確認します。各共有コンポーネントの名前と場所を記録します。
  2. 修正は、それらが存在する場所で行う。 ボタンのルールはプロジェクトの Button(トークン、バリアント、プロパティ、またはそのスタイル)に適用され、単一画面の使い捨てコピーには決して適用しません。色や半径のルールはトークンに適用し、ハードコードされた値には適用しません。
  3. ジョブに適したコンポーネントが存在する場合は、決して新しいコンポーネントを追加しない。 また、21 Grams UIの効果を得るために依存関係(UIキット、アイコンセット、チャート、アニメーションライブラリ)を追加してはなりません。インストールされているものを使います。アニメーションライブラリがない場合は、CSSトランジションを使用します。
  4. 本当に欠けているピースがある場合(セグメントコントロールがない、スイッチがないなど)、プロジェクトの既存のプリミティブとトークンから、そのファイルレイアウトと命名規則に従って構築します。その旨をレポートに記載します。
  5. ハウススタイルの値は、ギャップを埋めるためのデフォルトです。 rules/ と tokens/tokens.css は、プロジェクトが決定していない項目の値を提供します。それらをプロジェクトのトークンにマッピングします。既存のシステムと一緒に tokens.css をペーストしないでください。
  6. ブランドはプロジェクトのものを維持します。 ブランドカラー、フォント、ロゴ、アイコンスタイル、ボイスは決して置き換えられません。21 Grams UIは、それらがどのように使用されるか(コントラスト、階層、スペーシング、モーション)を変更し、何であるかは変更しません。

優先順位: ユーザーの言葉、次にプロジェクトのデザインシステムとブランド、その次に21 Grams UIのハウススタイルです。原則、ハック、アニメーションクラフトはすべての場所に適用され、プロジェクト自身のコンポーネントで表現されます。

内部構成

  1. ハウススタイル。 rules/ 内の8つの領域: radius.md(12/8/4 ネスト)、buttons.md(36px、.97 プレス)、motion.md(スムーズ、トリガーから、バウンスなし)、type.md(タイト、少数サイズ)、spacing.md(グループ化された4pt)、colour.md(1つのアクセント、AA)、elevation.md(トーンフィル)、copy.md(プレーンで親切)。さらに3つのコンポーネントファイル: icons.md(1スタイル、ライン、ソリッド、またはデュオトーン、混在禁止)、charts.md(ライン、カラム、水平バー)、toggles.md(スイッチとセグメントコントロール)。デフォルト値は tokens/tokens.css にあります。
  2. 20の原則。 UXとアニメーションの原則は references/principles.md にあります。
  3. 10のデザインハック。 CSSレベルのクラフト詳細は references/design-hacks.md にあります。
  4. 20のアニメーションクラフト。 実装レベルのモーションルール(原点、継続時間、スタッガー、プレス、ドラッグ、共有レイアウト)は references/animation-craft.md にあります。
  5. 10のタイポグラフィハック。 予約済みボールド幅、text-box-trim、アンダーラインオフセット、上付き文字スペーシング、流動的なディスプレイタイプ、スモールキャップスの頭文字、カーリー引用符、ミドルトランケーション、自動ハイフネーション、line-clampされたタイトルは references/typography.md にあります。
  6. 20のアンスロップルール。 構成とコンテンツの特徴(フィラーバッジ、冗長なラベル、ランダムなイタリック、装飾的なモノ、抽象的なヒーローアート、等比重の機能、曖昧な見出し、グロー、光学的位置合わせ、ローディング状態)は references/unslop.md にあります。

もしデータ可視化スキルがインストールされている場合は、チャートが関係するときはいつでもそれもロードします。

ワークフロー

  1. 棚卸しを行う(ルールゼロ)。プロジェクトにデザインシステムがまったくない場合は、その旨を伝え、ハウススタイルのデフォルトを使用します。
  2. 何も変更する前に監査する。 画面またはコンポーネントを確認し、領域(半径 … コピー)、原則番号、ハック番号、クラフト番号でグループ化された所見をリストアップします。references/principles.md、references/design-hacks.md、references/animation-craft.md、references/typography.md、references/unslop.md、rules/icons.md の末尾にあるチェックリストを使用します。それぞれの所見について、ファイルと行、問題点、修正方法、そして修正が適用される既存のコンポーネントまたはトークンを取得します。21 Grams UIのルールがプロジェクトのデザインシステムと競合するすべての場所をフラグし、ユーザーがどちらを優先するかを決定できるようにします。
  3. 監査結果をユーザーに短いリストとして表示し、広範囲にわたる変更を適用する前に確認を求めます。要求された範囲内の小さく明白な修正は、直接適用しても構いません。
  4. 次の順序で修正を適用します: トークン → 共有コンポーネント → 画面。差分は監査された範囲に限定し、プロジェクト自身の規約(フォーマット、リント、命名)に従います。
  5. ブラウザで検証する。 変更された各画面のBefore/Afterスクリーンショット。ホバー、プレス、フォーカス、ローディング、エラー、両テーマ、prefers-reduced-motion を確認します。ボタンとテキストのコントラストを測定し、目視で判断しないでください。モーションについては、可能であればBefore/Afterを記録します。ドラッグ可能なディバイダーと両側で動作するインタラクションを備えたBefore/Afterページは、アップリフトをレビューする最も明確な方法です。
  6. レポートする 領域、原則、ハック、クラフトごとに何が変更されたか、どのコンポーネントとトークンが触れられたか、そして未完了の項目があればそれも報告します。

ハウススタイル概要(ギャップを埋めるデフォルト)

  • 半径 12 コンテナ / 8 コントロール / 4 小さな部品。外側 − パディングでネスト。ピル形状はタグとトグルを除き使用しない。
  • ボタン 36px(コンパクト 32、プロミネント 40)、半径 8、14/500、ソリッドプライマリ1つ、ビューごとに1つのプライマリ、ホバー = カラーステップのみ、プレス = カラーステップ + scale(.97) 150ms、ローディングは幅を維持。
  • モーション: 日常のUIにはバウンスなし。メニュー 220ms in / 175ms out、トリガーから scale(.95) 開始、パネル 240 / 190、入場 ease-out、退場 ease-in(入場の約80%)、リスト行 30ms スタッガー、頻繁なインタラクションは瞬時に。
  • タイポグラフィ: プロジェクトのフォント(フォントがない場合は Geist)。モノはコード専用。ラベル、アイブロウ、バッジ、タイムスタンプ、数字には決して使用しない(サンセリフの tabular-nums で図形を揃える)。サイズ 12/14/16/22/28、ウェイト 400/500/600、見出し −0.022em、画面ごとに最大4サイズ。モバイルでは、見出しは1ステップ上がる: セクション 18、カード 16。
  • モバイルのチャット送信は、アイコン専用 44×44 の紙飛行機ボタンで、aria-label="Send" を持つ。
  • スペーシング: 4pt スケール。グループ内はグループ間よりもタイトに(4 / 6 / 16 / 24–32 / 48)。セレクトのシェブロンは右端から12px、padding-right 36px。
  • カラー: 1つのアクセント(アクション、フォーカス、選択)、ステータスカラーは別途。ボタンテキスト ≥ 4.5:1(両テーマで)、テーマごとに --on-accent を持つ。
  • エレベーション: 静止面は境界線やシャドウのない塗りつぶしステップ。浮遊レイヤーだけがリングとシャドウを持つ。ダークモードでは、レイヤーごとに明るくなる。
  • アイコン: プロダクトごとに1スタイル(ライン、ソリッド、デュオトーン)で統一し、メニュー、ナビ、ツールバー、リスト、カード内で混在させない。選択状態は色のみ変更し、アイコンスタイルは変更しない。1つのアイコンライブラリ、1つのストローク幅、グループごとに1つのサイズ。
  • コピー: 動詞 + 目的語のボタン、原因と修正方法を含むエラー、文形式、絵文字なし、誇大広告なし。

譲れない条件(20の原則より)

  • ユーザーがトリガーするUIモーションは120〜300ms。退場は入場の約80%。移動に linear(線形)は絶対に使用しない。
  • イージングは方向に合わせる: 入場 ease-out、退場 ease-in、画面上のA→Bは ease-in-out。日常のUIにオーバーシュートは禁止。
  • 高頻度インタラクション(キーボードナビ、リストハイライト、ツール内タブ)は瞬時に。
  • すべての入力は100ms以内に確認応答。保存には楽観的UIを使用。400msを超えたら進行状況を表示。
  • ヒットエリアはタッチで少なくとも44×44、高密度デスクトップで32×32。アイコンが小さい場合でも同様。
  • ビューごとに1つのフォーカスと1つのプライマリアクション。何かがフォーカスを取るときは、コンテキストを暗くする。
  • 長い数字はチャンク化する。入力は乱雑な形式を受け入れ、クリーンな値をエコーバックする。
  • 理由がない限り、標準的な配置とアイコンを使用。
  • すべてのコンポーネント状態がデザインされていること: idle、hover、pressed、loading、success、error、disabled。
  • prefers-reduced-motion: 移動、スケール、オーバーシュートを削除し、簡潔な不透明度の変更のみを維持。

譲れない条件(10のハックより)

  • ネストされた半径: 内側 = 外側 − パディング。
  • 境界線はアルファ(rgb(0 0 0 / .12))を使用し、さまざまなサーフェス上でソリッドグレーのhexは使用しない。
  • パレットとグラデーションはOKLCH(グラデーションで in oklch)。
  • アイコンのストロークは隣接テキストのウェイトに一致させる。
  • 水平スクローラーはマスクで端をフェードアウト。
  • アイコンの切り替えは filter: blur(4px) でクロスフェード。
  • ダークモード: 高いレイヤーほど明るく(ページ < カード < メニュー)。
  • モバイルの全高: dvh/svh を使用し、裸の 100vh は使用しない。
  • 着色されたカード上の白背景の製品ショット: mix-blend-mode: multiply。

譲れない条件(10のタイポグラフィハックより)

  • ホバー時または選択時に太字になる場合、レイアウトがずれないようにする(ボールド幅を予約)。
  • ボタンやバッジ内の単一行ラベルは、光学的に中央揃えにする(text-box-trim)。
  • リンクのアンダーラインはディセンダーを避ける(text-underline-offset: 0.2em)。上付き文字は行のリズムを崩さない。
  • コピー内の実際の句読点: カーリー引用符、アポストロフィ、enダッシュ、…。
  • 末尾が異なる名前はミドルトランケーションする。グリッド内のカードタイトルは同じ行数にクランプする。

譲れない条件(20のアニメーションクラフトより)

  • ポップオーバーとメニューはトリガーから成長する(transform-origin をトリガーに)、scale(.95) から開始し、決して scale(0) からは開始せず、トリガーに戻って退出する。
  • 古い状態と新しい状態は重なる。SaveとSavedの間に空白のフレームは決して存在しない。
  • ドラッグはホールド中はトランジションなしでポインターを1:1で追跡し、境界を超えるとラバーバンド効果を示す。
  • カード → 詳細は同じ要素を拡大する(共有 layoutId / ビュートランジション)。断片的な置き換えはしない。
  • セグメントコントロールとタブは、インジケーターとともに移動するマスクでアクティブラベルを表示する。
  • 移動するノブは約12%伸びる(面積保存)。成功時は1回のパルス。

削除すべきAIの特徴

混在したアイコンスタイル(ソリッドの家の横にあるアウトラインのフォルダ、選択時にアウトラインからソリッドに変わるアウトラインアイコン)、1つの画面に2つのアイコンライブラリ、アイコンとして使用される絵文字、見出しの上にある「NEW」フィラーバッジ、見出しを繰り返すアイブロウ、ランダムなイタリックやモノの単語が見出しにある、モノラベル、アイブロウ、バッジ、タイムスタンプ、数字(「// 01 STATUS」のような「テック」大文字モノ)、実際のプロダクトの代わりにある光沢のある3Dオーブ、等しい機能カードの行、「X, meet Y.」のような見出し、光るグラデーションボーダー、インディゴからバイオレットへのグラデーション、グラデーションテキスト、色付きのグローシャドウ、すべてに同じ16pxの半径(内側半径が外側と等しい)、丸みを帯びた入力の横にあるピルボタン、カードとボタンのホバースケールアップ、すべてに300ms ease-in-out、ページ読み込み時のフェードアップ、一律の p-6 gap-6、カード内のカード、すべてのブロックにシャドウ+ボーダー+半径、すべてのセカンダリテキストに grey-500、見出し内の絵文字、「Unlock」、「Supercharge」、「Seamless」、「Oops!」のようなコピー。

クレジット

原則、ハック、アニメーションクラフトは、5つのショートフォームデザインビデオ「20 Principles of UX & Animation」「10 Niche Design Hacks」「20 Ways to Make Beautiful AI Animations」「10 Niche Typography Hacks」「20 Ways to Unslop AI Designs」からパラフレーズおよび拡張されたものです。クレジットについてはREADMEを参照してください。

関連スキル