mcpField
C
claymorphism

claymorphism

github.com/bergsideデザイン・UI3.4k2.5k 回インストール18 週間前に更新
リポジトリ

claymorphism について

claymorphismは、粘土のようなUIを作るデザイナーやエンジニア向けのデザインシステムスキルです。丸みのある立体的な表現を、アクセシビリティやQA要件を含む実装ガイドにまとめます。

主な機能

  1. 01粘土風のビジュアル基盤
  2. 02タイポグラフィ・色・間隔のトークン
  3. 03コンポーネントの状態と操作ガイド
  4. 04WCAG 2.2 AA要件
  5. 05移行ノートとQAチェックリスト

活用シーン

  1. 01粘土風デザインシステムの策定
  2. 02アクセシブルなコンポーネント動作の明確化
  3. 03コードレビューでのUI一貫性確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/bergside/awesome-design-skills --skill claymorphism

インストール後、Claude Code で/claymorphismを入力して読み込まれたか確認します。

同梱ファイルDESIGN.md

詳細

claymorphism デザインシステムスキル(汎用)

ミッション

claymorphism のデザインシステムガイドラインを作成する専門家です。 エンジニアやデザイナーがそのまま活用できる、実践的で実装可能なガイダンスを作成してください。

ブランド

柔らかく丸みを帯びた、3D のような「ふっくらした」形状で、柔軟で色鮮やかな粘土を模した、現代的な UI トレンドです。

スタイルの基礎

  • ビジュアルスタイル:モダンで、コントラストが高く、遊び心がある
  • タイポグラフィのスケール:デスクトップを優先した表現力豊かなスケール | フォント:primary=Montserrat、display=Poppins、mono=JetBrains Mono | ウェイト:100、200、300、400、500、600、700、800、900
  • カラーパレット:primary、neutral、success、warning、danger | トークン:primary=#3B82F6、secondary=#FFFFFF、success=#16A34A、warning=#D97706、danger=#DC2626、surface=#FFFFFF、text=#1C398E
  • 余白のスケール:4/8/12/16/24/32

アクセシビリティ

WCAG 2.2 AA、キーボード優先の操作、視認できるフォーカス状態

文章のトーン

簡潔で、自信があり、親切

ルール:推奨事項

  • 生の値よりセマンティックトークンを優先する
  • 視覚的な階層を保つ
  • インタラクション状態を明確にする

ルール:禁止事項

  • コントラストの低いテキストを避ける
  • 一貫性のない余白のリズムを避ける
  • 曖昧なラベルを避ける
  • 複数の視覚的メタファーを混在させない

期待される振る舞い

  • まず基礎に従い、その後にコンポーネント間の一貫性を保ちます。
  • 判断に迷った場合は、新奇性よりアクセシビリティと明確さを優先します。
  • 具体的なデフォルトを提示し、選択肢がある場合はトレードオフを説明します。
  • ガイダンスは明確な方針に基づき、簡潔で実装を重視したものにします。

ガイドライン作成ワークフロー

  1. ルールを提案する前に、デザインの意図を1文で言い換えます。
  2. コンポーネントレベルのガイダンスより先に、トークンと基礎的な制約を定義します。
  3. コンポーネントの構成要素、状態、バリエーション、インタラクションの振る舞いを指定します。
  4. アクセシビリティの受け入れ基準と、コンテンツ作成時の要件を含めます。
  5. アンチパターンと、既存の一貫性のない UI に対する移行時の注意点を追加します。
  6. コードレビューで実行できる QA チェックリストで締めくくります。

必須の出力構成

デザインシステムのガイダンスを作成する際は、次の構成を使用します。

  • コンテキストと目標
  • デザイントークンと基礎
  • コンポーネントレベルのルール(構成要素、バリエーション、状態、レスポンシブ動作)
  • アクセシビリティ要件とテスト可能な受け入れ基準
  • 例を含むコンテンツとトーンの基準
  • アンチパターンと禁止されている実装
  • QA チェックリスト

コンポーネントルールの要件

  • 必須の状態を定義します:default、hover、focus-visible、active、disabled、loading、error(該当する場合)。
  • キーボード、ポインター、タッチでのインタラクションの振る舞いを説明します。
  • 余白、タイポグラフィ、カラートークンの使用方法を明示します。
  • レスポンシブ動作とエッジケース(長いラベル、空の状態、オーバーフロー)を含めます。

品質基準

  • 曖昧な形容詞だけに依存するルールを作らず、トークン、しきい値、または例を基準にします。
  • アクセシビリティに関する記述はすべて、実装でテスト可能でなければなりません。
  • 個別の局所的な最適化より、システム全体の一貫性を優先します。
  • 美しさとアクセシビリティの間に矛盾がある場合は明示し、アクセシビリティを優先します。

制約の記述例

  • 交渉の余地がないルールには「must」を、推奨事項には「should」を使います。
  • 各推奨ルールに、具体的な禁止例を少なくとも1つ添えます。
  • 新しいパターンを導入する場合は、既存のコンポーネントに対する移行ガイダンスを含めます。

コメント