複数のAIコーディングエージェントを併用しているチームが、デザイン生成やコード変換の自動化を試すとき、何を事前に用意すべきか迷う場面があります。本記事ではGoogleのStitch Design Skillsという仕組みを題材に、SREやインフラ担当者が社内導入を検討する際に確認すべき前提条件と設定ポイントを整理します。
Stitch Design Skillsは、Google Stitchというデザインツール向けに作られたAgent Skills(エージェントが呼び出せるタスク定義の集合)です。TypeScriptで書かれたgoogle-labs-code/stitch-skillsというリポジトリが本体で、Apache-2.0ライセンスで公開されています。スター数は1万1000を超えており、注目度自体は高いプロジェクトです。
この仕組み自体はデザイン生成寄りの機能ですが、「複数のエージェント実行環境に同じ設定ファイルを配布する」「外部MCPサーバーへの依存を前提に動く」という構造は、SRE視点で見ても他のエージェント連携基盤と共通する注意点が多く含まれています。
Agent Skillsという仕組みと、MCPサーバー依存の構造
Agent Skillsは、特定のオープン標準に沿って定義されたスキルファイル群です。同じファイルをCodex、Antigravity、Gemini CLI、Claude Code、Cursorといった複数のエージェント実行環境で読み込めるのが特徴です。OpenCodeだけは標準のインストーラーがなく、手動コピーでの対応になります。
Stitch Design Skillsが提供するのは4つのワークフローです。デザイン生成、コードからデザインへの変換、デザインシステムの管理、デザインからReactコンポーネントへの変換の4つが用意されています。それぞれがパッケージ化されているため、エージェントがプロンプトを都度解釈するのではなく、決まった手順を呼び出す形で実行されます。
ここで運用上重要なのが前提条件です。公式のREADMEには、これらのスキルはStitch MCPサーバーがエージェント環境内で設定・起動されていることを前提とすると明記されています。MCP(Model Context Protocol、AIエージェントが外部ツールやデータソースと通信するための標準プロトコル)のサーバーが動いていなければ、スキルを導入しても何も機能しません。
これはインフラのヘルスチェックに似た構造です。アプリケーションサーバーがデータベース接続なしでは起動しても機能しないのと同様に、Stitchのスキルも「依存先が生きているか」を事前に確認する必要があります。導入手順の最初につまずくポイントが、まさにこのMCPサーバー未起動の状態であることが多いとされています。
インストール経路の違いと、設定ミスが起きやすい箇所
エージェントごとにインストールコマンドの形式が異なります。Codexの場合はcodex plugin marketplace addコマンドに--sparseフラグを複数指定する形です。
codex plugin marketplace add google-labs-code/stitch-skills --ref main \
--sparse .agents/plugins \
--sparse plugins/stitch-design \
--sparse plugins/stitch-build \
--sparse plugins/stitch-utilities--sparseフラグは省略可能なオプションで、チェックアウト対象のパスを絞り込みクローンを高速化する目的があります。省略するとリポジトリ全体を取得することになり、不要なファイルまで引き込んでしまいます。CI環境でクローン時間やディスク使用量を気にする場合は、このフラグの有無が地味に効いてきます。
Claude CodeとCursorではnpx plugins addコマンドを使い、--scopeオプションでインストール範囲を指定します。Claude Codeならプロジェクト単位、Cursorならワークスペース単位という違いがあります。マーケットプレイス登録後はstitch-design、stitch-build、stitch-utilitiesの組み合わせで個別インストールも可能です。
部分的なインストールを行う場合はnpx skills add google-labs-code/stitch-skillsというコマンドを使いますが、ここには注意書きがあります。スキル同士が依存関係を持つことが多いため、選択的インストールでは必要な依存スキルをすべて含める必要があるという点です。依存関係の抜け漏れは、後になって原因不明のエラーとして表面化しやすい典型パターンです。
OpenCode利用時の手動設定と、命名規則の落とし穴
OpenCodeはnpx pluginsやnpx skillsに対応しておらず、CodexやClaudeのマーケットプレイス形式も使えません。インストールは完全に手動作業です。
具体的には、スキルフォルダを.opencode/skills/以下にコピーし、opencode.json(またはホームディレクトリ配下の設定ファイル)にStitch MCPのリモートエントリを追加します。urlフィールドにはStitch MCPセットアップで払い出されるエンドポイントを設定します。
cp -R plugins/stitch-design/skills/generate-design .opencode/skills/generate-designここで守るべき制約が2つあります。スキル名は小文字のkebab-case(単語をハイフンでつなぐ命名規則)である必要があり、かつディレクトリ名と一致していなければなりません。stitch::...のようなコロンを含む名前は、そのままではロードされずリネームが必須です。
この種の制約は、IaC(Infrastructure as Code、インフラ構成をコードで管理する手法)のモジュール命名規則とよく似ています。TerraformやPulumiでリソース名の文字種制約を見落としてapply時にエラーを起こすのと同じ構図です。ドキュメントの一文で片付けられる内容ですが、試行錯誤で発見すると時間を失います。加えて、Stitchのドキュメントサイトの一部リンクが誤ってリダイレクトされる場合があり、同一ホスト内で開き直す必要がある点も既知の落とし穴として挙がっています。
導入前に確認すべきチェックポイント
ここまでの内容を、実際に社内で試す前のチェックリストとして整理します。
- 利用予定のエージェント環境(Codex/Claude Code/Cursor/OpenCode等)がAgent Skills標準に対応しているか、対応方法が公式サポートか手動インストールかを確認する
- Stitch MCPサーバーを先に起動・設定し、エンドポイントが疎通することを確認してからスキル導入に進む
--sparseフラグの要否を判断し、CI/CDパイプラインに組み込む場合はクローン時間への影響を見積もる- 部分インストールを行う場合は、依存スキルの一覧を事前に洗い出し、抜け漏れがないか確認する
- OpenCodeを使う場合は、スキル名がkebab-caseかつディレクトリ名と一致しているかを導入時点で検証する
オブザーバビリティ(システムの内部状態を外部から観測可能にする仕組み)の観点では、MCPサーバーの起動状態やエージェントからの呼び出し成功率をログで追跡できるようにしておくと、導入後のトラブルシュートが楽になります。単純な死活監視だけでも、MCP未起動によるスキル不動作の切り分けには十分役立ちます。
中国語訳ドキュメントの登場自体は、技術内容を変えるものではありません。ただし、同じ手順書でも母語で読めるかどうかで、最初のつまずきにかかる時間は変わってきます。日本語話者にとっても、英語の公式READMEで--sparseフラグの意味や依存関係の注意書きを読み飛ばさないことが、同じようにインストール時間を左右します。
まとめ
Stitch Design Skillsを試す前に、まずStitch MCPサーバーが起動済みかを確認することが最初の一歩です。
次に、使用するエージェント環境がマーケットプレイス形式(Codex・Claude Code・Cursor)か手動インストール形式(OpenCode)かを見極め、それに応じたコマンド体系を選びます。
部分インストールをする場合は依存スキルの洗い出しを忘れず、OpenCodeではスキル名の命名規則違反がないかを導入時点でチェックしておくと、後からのデバッグ時間を減らせます。