Communitygithub.com

AradhanaID/agent-skills

UIスタイルルール。フォント統一、スペース優先、80-20-10カラー。UI作成時に発動。

agent-skills とは?

このスキルは、UIデザインの一貫性を維持するための明確なスタイルルールを実装したエージェントスキルです。主にClaude CodeやCursorなどのAIエージェントがUIを記述する際に参照するルールセットであり、「reference.md」に定義されたルールに従って動作します。スキルは5つのステップで構成され、既存のUIやルールの読み取り、スペースとボーダーの優先順位、80-20-10カラーパレットの適用、レスポンシブ対応、アイコンライブラリの統一を順に実行します。開発者がUIを構築する前にこのスキルを適用することで、後からスタイルを修正する手間を省き、常に統一されたデザインシステムを維持できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AradhanaID/agent-skills/tree/HEAD/skills/design-system

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

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

ドキュメント

デザインシステム

プロジェクトのUI設定。構築時(構築後ではない)に適用します。reference.md を参照せずにUIを記述すると、最初のステップが実行される前にフラット処理ルールが破られるため、ルールは reference.md のコンテキストとして最初に読み込まれます。

手順

  1. ルールを読み、次に既存のUIを読む。 reference.md のスタイルルールを取り込み、コードベースで既に使用されているもの(フォント、パレット、アイコンパック、角丸の設定)を確認します。 完了条件: 実装計画にルールが列挙され、コードベースに既に存在するすべてのルールが(リフレッシュせずに)一致していること。
  2. スペースをボーダーより優先する。 要素間はホワイトスペースで区切ります。ボーダーは、スペースが足りなくなった場合にのみ追加します。 完了条件: 各要素の境界がスペースだけでレンダリングされ、ボーダーが存在するのは、計画でスペースが不足した理由を明記している場合のみ。
  3. カラーは3つの帯域で割り当てる。 スタイルを記述する前に、各サーフェスに対してニュートラル80%、セカンダリ20%、アクセント10%を割り当てます。ピルやバッジは、アクセントが割り当てられた箇所です。 完了条件: コントロールとテキストが1色または2色のニュートラルトーンだけでレンダリングされ、アクセントはビューごとに最大1箇所のみに表示されること。
  4. レスポンシブで読みやすいことを確認する。 スタイル完了と宣言する前に、モバイル幅でビューを確認します。純粋な黒や純粋な白に近いテキストは、極端な色から外します。 完了条件: モバイルレイアウトが水平スクロールなしで収まり、すべてのテキスト色が極端でないトーンであること。
  5. アイコンを統一する。 プロジェクトのアイコンライブラリを検出し、その1ユニットをすべての出現箇所で再利用します。 完了条件: 1つのアイコンがルールに従って選ばれ、新しいアイコンセットが導入されていないこと。

参照

  • reference.md — 11のスタイルルール、カラー分割、および1つの完全セットによるアイコンルール。ここに知識を集約し、このファイルは決して変更してはなりません。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

関連スキル