使い方ガイドへスキップ
Theming System作者 Owl-Listener

Theming System スキル。

構造を複製することなく、1つのコンポーネントライブラリの見た目を切り替えられるようにします。

  • デザインシステム
  • テーマ設定
ソースレビュー · Theming SystemSKILL.md
タスク デザインシステム 成果物 • 上書きルールを含む3層のトークンアーキテクチャ。 • 必要なカラー、ブランド、密度のモードを網羅したテーママトリクス。 • コンポーネントの対応範囲と、固定トークンとテーマ可変トークンに関するガイダンス。 開始前に 実装にはプロジェクトのトークンシステムまたはプラットフォームの同等機能を使用します。ランタイムでの切り替えは、構築とテストが必要です。
編集部による要約 · ソース確認日 2026-10-07 · 生成された例ではありません

01 機能概要

トークンで複数のテーマに対応する

ブランド、カラーモード、密度バリエーションをまたいで共有コンポーネントを扱うための、階層型テーマアーキテクチャです。

ソースに基づくワークフロー実行ベンチマークではありません

進め方

Theming Systemは、テーマごとの違いを階層型トークンアーキテクチャに集約します。ローのパレット値がセマンティックロールに反映され、さらにコンポーネント単位のトークンに反映されます。テーマの上書きは主にセマンティック層を変更するため、同じコンポーネントを異なるブランドやカラーモードで使えます。

ソースでは、テーマを単なる色の反転とは区別しています。ダークの面、エレベーション、彩度、画像バリエーションには、意図的な対応が必要です。また、密度もテーマの次元として挙げており、色以外にも適用できる仕様になっています。

期待される成果物

  • 上書きルールを含む3層のトークンアーキテクチャ。
  • 必要なカラー、ブランド、密度のモードを網羅したテーママトリクス。
  • コンポーネントの対応範囲と、固定トークンとテーマ可変トークンに関するガイダンス。
サンプルブリーフを見る

ブリーフからレビューまで

  1. 01
    トークン層を分ける

    ローのプリミティブ、用途ベースのエイリアス、コンポーネントレベルの参照を特定します。

  2. 02
    テーマの上書きをマッピングする

    コンポーネントの契約を保ったまま、要求されたテーマごとにセマンティックロールを変更します。

  3. 03
    ライブラリ全体を確認する

    対応するすべてのテーマで、画像やOSの設定に応じた挙動も含め、全コンポーネントをレビューします。

02 利用場面

使いどころ

実装にはプロジェクトのトークンシステムまたはプラットフォームの同等機能を使用します。ランタイムでの切り替えは、構築とテストが必要です。

適したケース

  • マルチブランドの製品ホワイトラベルやサブブランドのインターフェースでコンポーネントライブラリを共有する必要がある場合に役立ちます。
  • ライトとダークだけではないハイコントラストや密度のバリエーションにも対応できる構造を提供します。

確認すべき制限

  • 単一パレットの作業ではない1組の色を選ぶだけでは、保守しやすいテーマアーキテクチャにはなりません。
  • コントラストの自動認証はない実際のテキスト、面、状態の組み合わせすべてについて、引き続きテストが必要です。

用意する入力

  • 対応するテーマブランド、カラーモード、コントラストモード、密度の要件を挙げてください。
  • 既存のトークンパレット、セマンティックエイリアス、コンポーネント参照を提供してください。
  • 固定のブランド要素テーマ間で変えてはならないアセットや値を明示してください。

03 重要な判断

重要な判断

  1. 適切な層で上書きする

    セマンティックエイリアスを使うことで、ブランド固有の色がコンポーネント実装のあちこちに散らばるのを防げます。

  2. アセットもテーマの一部

    画像やイラストにはバリエーションが必要な場合があります。CSS変数を変えるだけでは、ダークモードが一貫したものにならないことがあります。

04 依頼例

絞ったブリーフを試す

以下のサンプルブリーフはテストされていません。使用前にスキルのセットアップを確認してください。

セットアップを確認する

リポジトリに記載されたインストール方法を使用し、参照されている付属ファイルはすべて残してください。この項目は実行可能なアプリケーションではなく、特定のデザイン手法を説明するものです。

アップストリームのソースファイル
https://github.com/Owl-Listener/designer-skills/blob/9a6930cf84a822eb458624bd11c61aac5bbdf224/design-systems/skills/theming-system/SKILL.md

実装にはプロジェクトのトークンシステムまたはプラットフォームの同等機能を使用します。ランタイムでの切り替えは、構築とテストが必要です。

まず1つの成果物から始める

スキルを実行する前に、このブリーフの範囲、ソース資料、制約を調整してください。

サンプルブリーフ
ライトモードとダークモードを持つ2つのブランドで共有するコンポーネントライブラリにtheming-systemを使用してください。プリミティブ、セマンティック、コンポーネントの各層を定義し、固定トークンを特定し、テーマの上書きがどう機能するかを示してください。色の反転で十分だと仮定せず、画像バリエーションと、コンポーネント×テーマのQAマトリクスを含めてください。

結果を確認する

実際の出力を、以下の観察可能な基準に照らして確認してください。

  • コンポーネントトークンは、文書化されたセマンティックロールを通じて解決される。
  • テーマ可変の値と固定の値が区別されている。
  • テストマトリクスに、対応するすべてのテーマが含まれている。

OpenDesignは、コーディングエージェント向けのローカルデザインワークスペースを提供します。この掲載は、スキルが同梱されていること、または外部ツール、認証情報、ソフトウェア依存関係が含まれていることを意味しません。

05 ソースとライセンス

ソースとライセンス

このページは、下記にリンクされた固定リビジョンのソースについて説明しています。アップストリームの挙動や要件は変更される可能性があります。

ソースの所有者
Owl-Listener
ライセンス
MIT
確認済みスナップショット
2026-10-07 · 9a6930cf84a8
編集部によるソース要約
ブランド、カラーモード、密度バリエーションをまたいで共有コンポーネントを扱うための、階層型テーマアーキテクチャです。

リンク先のソースに基づく、OpenDesignによるオリジナルの要約です。リポジトリのスター数は日付時点の人気の指標であり、スキルの利用状況や品質スコアではありません。

06 開始前の質問

開始前の質問

テーマはどこでトークンを上書きすべきですか?

ソースでは、主な上書きを、ロー値とコンポーネント固有トークンの間にあるセマンティック層に置いています。

密度はテーマになり得ますか?

はい。ソースでは、カラーモードやブランドモードと並んで、標準、コンパクト、ゆったりの密度を挙げています。

特定の実装ツールを指定していますか?

特定のスタックを義務づけるのではなく、CSSカスタムプロパティ、トークンファイル、Figma変数モード、ランタイム切り替えを挙げています。

OpenDesign

次のデザイン反復の余地をつくる。

ブリーフ、ソース資料、デザイン作業をローカルワークスペースにまとめて管理できます。ワークフローに追加する前に、スキル自体のセットアップを確認してください。

アップストリームのソースファイル
https://github.com/Owl-Listener/designer-skills/blob/9a6930cf84a822eb458624bd11c61aac5bbdf224/design-systems/skills/theming-system/SKILL.md