Anthropicが2025年後半に提唱したClaude Code Skillsは、当初こそ単発の参照実装が中心だったが、2026年に入って「ベンダーが自社製品に束ねて配布する」フェーズに突入した。iPaaSベンダーPrismaticが2026年4月に公開した prismatic-io/prismatic-skills は、その最初期かつ最も完成度の高い実装例の一つだ。
Claude Code全体の使い方は Claude Code完全ガイド2026：インストールから本番運用まで をご覧ください。
30秒で理解する Prismatic Skills for Claude Code
- 何者か: iPaaSベンダーPrismaticが2026年4月にMITで公開した、Claude Code用プラグイン。GitHub上で
prismatic-io/prismatic-skillsとして配布。 - 5系統スキル: Component Builder / CNI Builder / Embed Advisor / Orby / Migration Analyzer。実体は6スラッシュコマンド＋7エージェント＋8スキル知識ベース。
- 設計の妙:
user-invocable: falseで内部参照スキルを定義、<disallowed-tools>でMCPツールを意図的に禁止、TypeScript製scripts/に実処理を委譲。 - 使い所: Prismatic顧客の開発高速化に加え、自社SaaSのClaude Codeプラグインを作る際の設計テンプレートとして超優秀。
- インストール:
/plugin marketplace add prismatic-io/prismatic-skills→/plugin install prismatic-skills@prismatic-skills。前提は@prismatic-io/prismCLIとNode.js 18+。
Prismatic Skills for Claude Codeとは何か—iPaaSベンダーがOSS公開した5系統スキル
PrismaticはB2B SaaS向けの組み込み型iPaaS（Embedded iPaaS）を提供するベンダーだ。SaaSプロダクトの管理画面の中に「外部サービス連携の設定UI」を埋め込み、エンドユーザー自身が連携を設定できる体験を、SaaS事業者が短期間で構築できるよう支援している。
そのPrismaticが2026年4月16日に公式ブログで発表したのが prismatic-io/prismatic-skills だ。リポジトリ詳細を一言で表現するなら「Claude Code（とそのSkills機構）を、Prismatic製iPaaSの開発／運用エージェントに変身させるOSSプラグイン」になる。
Prismatic Skillsが束ねる5系統
公式アナウンスでは「5つのスキル」と紹介されているが、これはユーザー視点での機能カテゴリであり、リポジトリ実体は複数のレイヤーで構成されている。
5系統スキル × ユースケース対応表
- Component Builder: カスタムAPIコネクタ（Prismaticでは「Component」と呼ぶ）を作る。サブエージェント
external-api-researcherが外部APIドキュメントを解析し、TypeScript足場を生成。 - CNI Builder: Code Native Integration（コードとして書かれるインテグレーション）を要件聞き取り→足場→ビルド→デプロイ→テストまで一気通貫。
- Embed Advisor: Next.jsなどのWebアプリにPrismaticのMarketplace／Workflow Builderを埋め込む際の、JWT署名・SDK統合・テーマ・i18nを助言。
- Orby: プラットフォーム運用エキスパート。GraphQL APIクエリ生成・ログ調査・デプロイ・ドキュ検索を担当。
- Migration Analyzer: BoomiやCyclrからのエクスポートファイルを標準スキーマに変換し、CNI Builderへ橋渡し。専属レビュアー
migration-reviewerが品質をチェック。
PrismaticのCTO Tanner Burson氏はプレスリリースで「Prismatic Skills gives Claude the context and capabilities to build and operate integrations end-to-end」（PrismaticスキルはClaudeにインテグレーションを最初から最後まで構築・運用するための文脈と能力を与える）と述べている。
提供形態とライセンス
リポジトリはMITライセンスで公開されており、2026年4月29日のコミット時点でスター26・最新プラグインバージョン2.3.0。Prismaticの全プラン顧客に無料で提供される。Anthropic公式マーケットプレースに登録されていない独立配布だが、Claude Codeのプラグインマーケットプレース機能（/plugin marketplace addコマンド）で任意のGitHubリポジトリをマーケットプレースとして取り込む仕組みを使うため、実質的にClaude Codeネイティブのインストール体験になっている。
ベンダーが自社製品とClaude Codeを密結合させた配布を、Anthropic公式チャネルに依存せずに実現している点が、エコシステム上の意義として大きい。これは、たとえばStripeやSupabaseが自社CLI周辺のClaude Codeプラグインを公開する際の、明確な参考事例になる。
この章のポイント
- Prismatic SkillsはiPaaSベンダー製のClaude Codeプラグイン
- 5系統（Component / CNI / Embed / Orby / Migration）でPrismatic開発の全工程をカバー
- MITライセンス、Prismatic全プランに無料提供
- SaaSベンダーがClaude Code拡張を作る際の参考事例として価値が高い
リポジトリ構造とSKILL.mdの設計パターン解剖
Prismatic Skillsの真価はリポジトリ構造とSKILL.mdの書き方そのものにある。Claude Code Skillsのフォーマットは、ファイルの命名・フロントマター・disallowed-toolsの宣言など細部に流儀の余地があり、Prismaticの選んだ流儀はベンダー製プラグインの理想形として参考になる。
ディレクトリ構造の全体像
prismatic-skills/
├── .claude-plugin/marketplace.json # マーケットプレース宣言
├── .claude/ # 開発用設定
└── plugin/ # ← 配布される本体
├── .claude-plugin/plugin.json # プラグイン本体（v2.3.0）
├── .mcp.json # prism MCPサーバ定義
├── agents/ # 7つのサブエージェント
│ ├── external-api-researcher.md
│ ├── migration-reviewer.md
│ └── ... (他5つ)
├── commands/ # 6つのスラッシュコマンド
│ ├── build-component.md
│ ├── build-integration.md
│ ├── modify-integration.md
│ ├── migrate-integration.md
│ ├── embedded.md
│ └── orby.md
├── hooks/ # MCPツール拒否Hook
├── scripts/ # TypeScript実行スクリプト群
├── skills/ # 8つのSKILL.md知識ベース
│ ├── component-patterns/SKILL.md
│ ├── integration-patterns/SKILL.md
│ ├── embedded/SKILL.md
│ ├── prismatic-api/SKILL.md
│ ├── prismatic-docs/SKILL.md
│ ├── boomi-migration/SKILL.md
│ ├── cyclr-migration/SKILL.md
│ └── migration-framework/SKILL.md
└── templates/
注目すべきはagents / commands / skills / hooks / scripts を明確に分離していることだ。Anthropic公式の参照実装は単一スキルが中心で、こうした多階層プラグインの全体構造をベンダー視点で組み上げた例は2026年5月時点でも数少ない。
user-invocable: falseという発明
Prismatic Skillsの最も学ぶべき設計選択は、SKILL.mdのフロントマターに user-invocable: false を採用したことだ。component-patterns/SKILL.mdの冒頭は次のようになっている。
---
name: component-patterns
version: 2.0.0
description: Architecture patterns, code generation guides, and reference documentation for building Prismatic custom components.
user-invocable: false
---
このuser-invocable: falseは、「ユーザーが直接/skills:component-patternsのように呼び出すスキルではなく、エージェントが内部参照する知識ベースとして使うスキル」を宣言する。ユーザーから見えるエントリーポイントは /prismatic-skills:build-component などのスラッシュコマンドだけで、その内部処理の中でエージェントが必要に応じてこのcomponent-patternsスキルをロードする。
「ユーザー呼び出し可能スキル」と「内部参照スキル」の使い分け
- user-invocable: true（暗黙のデフォルト）: ユーザーが
/skill-nameで起動する独立スキル。Anthropic公式skillsのPDF/PPTX/XLSXなど。 - user-invocable: false: スラッシュコマンドやエージェントの内部から動的にロードされる知識ベース。Prismaticの
component-patternsやprismatic-apiなど。
ベンダー製プラグインでは「ユーザー体験はコマンド単位」「実装は責務ごとに分割した知識ベース＋エージェント」という階層化が王道で、user-invocable: falseはその階層化を支える宣言として機能する。
8つのスキル知識ベースのうちprismatic-docsとprismatic-apiは、Prismaticの公式ドキュメントとGraphQL APIスキーマを丸ごと内蔵するリファレンス的な存在だ。エージェントが必要に応じて参照することで、ハルシネーションを抑え、最新ドキュメントとの整合性を保つ。
コマンドの構成—frontmatter＋自然言語の手順書
commands/build-component.mdの典型的な構造は次のようなパターンになる（リポジトリのファイル構造から再構成）。
---
description: Build and deploy a custom Prismatic component
allowed-tools: Read, Write, Bash(npx:*), Bash(prism:*)
---
# Build Component
You are an expert at building Prismatic custom components.
Use the `component-patterns` skill for architecture patterns.
## Workflow
1. Gather requirements from the user
2. Use `external-api-researcher` agent to analyze the target API
3. Generate TypeScript scaffold via `npx tsx scripts/init-component.ts`
4. Iterate on actions and triggers
5. Build with `prism components:build`
6. Deploy with `prism components:publish`
ポイントはallowed-toolsで必要最小限のツールに制限しつつ、手順を自然言語＋具体コマンドのハイブリッドで書く点だ。Claude Codeはこの手順書を実行プランの設計図として読み込み、エージェント呼び出し・スキル参照・シェルコマンド実行を組み合わせて手順を遂行する。
6つのスラッシュコマンドと7エージェントの責務分担
Prismatic Skillsを使う側のメンタルモデルは、「コマンドが入口、エージェントが脳、スキル知識ベースが教科書、scripts/が手」だ。
6種] CMD -->|内部呼び出し| AGENT[Sub Agents
7種] AGENT -->|参照| SKILL[Skills 知識ベース
8種
user-invocable false] AGENT -->|実行委譲| SCRIPTS[scripts/
TypeScript実装] SCRIPTS -->|prism CLI| PRISM[Prismatic Platform
GraphQL API] AGENT -.禁止.-> MCP[prism-mcp
禁止ツール宣言] HOOK[hooks/
MCPツール拒否] -->|PreToolUse| AGENT classDef block fill:#fff8e1,stroke:#f57f17; classDef forbidden fill:#ffebee,stroke:#c62828; class HOOK,MCP forbidden
6スラッシュコマンドの一覧
- /prismatic-skills:build-component: カスタムコンポーネント（APIコネクタ）構築・デプロイ
- /prismatic-skills:build-integration: Code Native Integration（CNI）の新規構築・デプロイ
- /prismatic-skills:modify-integration: 既存CNIの変更・更新
- /prismatic-skills:migrate-integration: BoomiやCyclrからCNIへの移行
- /prismatic-skills:embedded: Marketplace/Workflow BuilderのWebアプリ埋め込み
- /prismatic-skills:orby: 環境探索・GraphQLクエリ・運用調査
7エージェントの専門分化
エージェントの代表例は次のとおりだ。
- external-api-researcher: 外部APIドキュメント解析の専門エージェント。OpenAPI仕様・curlサンプル・認証方式を抽出してComponent Builderに渡す。
- migration-reviewer: Boomi/Cyclrからの移行アーティファクトを品質チェックするレビュアー。Migration Analyzerの出力を別エージェントが独立にレビューする「Two-Pass」設計。
- その他5エージェントがCNI/Embedded/Orbyそれぞれの深い専門領域を担当する。
「コマンド⊃エージェント⊃スキル」の階層化が効く理由
- 責務分離: 1つのSKILL.mdに全部書くと数千行になる。スキル単位で切ることで、ハルシネーション領域を限定。
- 独立進化:
prismatic-apiスキルだけGraphQLスキーマ更新でバージョンアップ可能。他スキルへの影響なし。 - レビュー対象が明確: PRレビュー時、変更スコープがファイル名から自明。
- モデル選択の最適化: 軽量タスクのエージェントにはHaiku、深い設計にはSonnet/Opusを割り当てる、といった選択が容易になる。
MCP統合と「禁止ツール」設計—<disallowed-tools>が示す品質ガード
Prismatic Skillsで最も技術的に興味深いのが、MCPサーバを同梱しつつ、その特定ツールを意図的に禁止する設計だ。
@prismatic-io/prism-mcpの同梱
plugin/.mcp.jsonでは、PrismaticがOSSで公開している@prismatic-io/prism-mcpをプラグインに同梱している。
{
"mcpServers": {
"prism": {
"command": "npx",
"args": ["-y", "@prismatic-io/prism-mcp", ".", "integration", "component"]
}
}
}
この記述により、Prismatic Skillsをインストールしたユーザーは追加設定なしでPrismatic GraphQL APIをMCP経由で叩ける。MCP一般の仕組みと作り方は MCPサーバー作り方完全ガイド を参照してほしい。
<disallowed-tools>という品質ガード
ここからが面白い。SKILL.md内には次のような宣言が含まれる。
<disallowed-tools>
- mcp__prism__prism_components_list
- mcp__prism__prism_components_get
</disallowed-tools>
<rationale>
These tools return incomplete data that breaks scaffold generation.
Use `npx tsx scripts/list-components.ts` instead, which returns the full
schema needed for code generation.
</rationale>
つまりMCPサーバが提供する一部のツールについて、「使うとスキャフォルド生成が壊れるから使うな」と明示的に禁止しているのだ。代替としてscripts/list-components.tsという自前のTypeScript実装に処理を委譲する。
MCPは便利な汎用インターフェースだが、ベンダーが自社のスキャフォルド生成・デプロイ手順を確実に動かすには、品質保証された自前スクリプトの方が信頼できる——というのがPrismaticの判断だ。
MCPの「使うべきタイミング」と「使ってはいけないタイミング」
- 使うべき: ユーザーが探索的にAPIを叩きたい場面（Orbyスキル経由でログ確認やGraphQLアドホッククエリ）。
- 使ってはいけない: コード生成・足場構築・デプロイなど、不完全なデータが下流を壊す可能性がある場面。Component BuilderやCNI Builderはこちら。
この区別をSKILL.md内に明記することで、Claudeが状況に応じて正しいツールを選ぶ。
Hooks層での強制
さらにPrismatic Skillsは、plugin/hooks/配下にPreToolUseフックを仕込んで、禁止されたツールが万一呼び出されようとした瞬間にブロックする。Claude Codeのフック機構は、設定ファイル内の正規表現とシェルコマンドで条件発火する仕組みで、SKILL.mdの自然言語での禁止宣言と二重の安全網を組む形だ。
つまり Prismatic Skills の品質ガードは次の3層構造になっている。
- SKILL.mdの
<disallowed-tools>宣言: モデルへの「使うな」明示 - SKILL.mdの
<rationale>説明</li>: なぜダメか・代替は何かを説明し、モデルが従いやすくする</li>- hooks/のPreToolUse拒否: モデルが万一無視しても物理的にブロック
</ol> これは [Claude Code ハーネスエンジニアリング](/explain/claude-code-best-practice-guide-2026/) のお手本のような実装で、自社プラグインを作る際にそのまま流用できるパターンだ。 --- ## Claude Code Skillsエコシステム内での位置づけ 2026年5月時点のClaude Code拡張エコシステムは大きく3つのレイヤーに分かれている。Prismatic Skillsはその中で固有のポジションを取っている。 | 観点 | Prismatic Skills | [anthropics/skills](https://github.com/anthropics/skills) | [davila7/claude-code-templates](/explain/claude-code-templates-davila7/) | |---|---|---|---| | 配布主体 | **iPaaSベンダー1社** | Anthropic公式 | コミュニティ（Daniel Avila） | | 配布形態 | Claude Codeプラグイン（marketplace） | スキル単品集 | npx CLI＋Web UI | | カバー範囲 | Prismatic製品の開発・運用 | PDF/PPTX/XLSX/DOCX/ユニバーサル | エージェント・MCP・スキル全部 | | MCP統合 | 自前MCP同梱＋特定ツール禁止 | なし（スキル単体） | 既存MCPの選択導入 | | 内部参照スキル | `user-invocable: false`を活用 | 主に独立スキル | 別パッケージ集積 | | ライセンス | MIT | MIT | MIT | | ターゲット | Prismatic顧客＋設計参考者 | 全Claude Codeユーザー | 全Claude Codeユーザー | | GitHubスター | 26（2026年5月時点） | 数千 | 26.8K超 | | プラグインversion | 2.3.0 | スキル個別 | CLIパッケージ | 3者は**競合ではなく補完関係**にある。Prismatic Skillsは「特定ベンダーの製品体験をClaude Code内に再現する」という最も具体的なユースケースを担当しており、汎用カタログのclaude-code-templatesや公式参照実装のanthropics/skillsとは役割が違う。### 「ベンダーが束ねたSkills」が増える理由 Prismaticの後を追って、複数のSaaSベンダーが類似のClaude Codeプラグインを公開し始めるトレンドが見える。理由は明確だ。3者の使い分け
- Prismatic顧客 or iPaaS開発者: Prismatic Skillsをそのまま使う
- Claude Code初学者・全方位の知識: claude-code-templatesでバンドル導入
- スキル単体の参照実装が欲しい: anthropics/skillsを読む
- 自社SaaSプラグイン設計の教科書: Prismatic Skillsのソースを読む
- 顧客の開発体験を一段引き上げる: 顧客の手元のClaude Codeに、自社製品の使い方を完璧に理解したエージェントを配置できる。
- ドキュメントの「動く」配布: 静的なdocsサイトより、エージェント＋スキルの形で配ったほうがユーザーが使う。
- 設計コストが下がる: SKILL.md＋エージェント＋スクリプトの組み合わせは、自社CLIをすでに持っているベンダーなら数週間で組める。
- 差別化要素になる: 同種のSaaSとの比較で「Claude Code対応」が訴求点に。
- Node.js 18+（リポジトリの
package.jsonでは>=24を要求するが、配布されるプラグインの実行は18+で動作） - Claude Code（プラグインマーケットプレース機能を含むバージョン）
- Prismaticアカウント（実機能を試す場合）
--- ## SKILL.md設計の実務テイクアウェイ 自社のSaaSやOSSに同種のClaude Codeプラグインを作りたい開発者のために、Prismatic Skillsから抽出できる実装パターンを5つにまとめる。 ### Takeaway 1: コマンド＝入口、スキル＝教科書、エージェント＝脳、scripts＝手 責務を4層に分けるのが基本。1ファイルに全部書く誘惑に勝つ。 ```text ユーザー → コマンド (.md手順書) → エージェント (.md専門役) ↓ 参照 スキル知識ベース (SKILL.md, user-invocable:false) ↓ 委譲 scripts/ (TypeScript実処理) ``` ### Takeaway 2: `user-invocable: false`で内部スキルを「隠す」 ユーザーが`/skills:component-patterns`を直接呼ぶのは混乱の元。`user-invocable: false`を1行足すだけで、コマンド経由のみアクセス可能になる。 ### Takeaway 3: MCP便利だけど「使ってはいけない場面」を宣言する `初回実行時のチェックリスト
prism meで正しいPrismaticテナントにログインしているか.mcp.jsonにprismサーバが登録されたか.claude/skills/配下にPrismaticの8スキルが配置されたかgit diffで.claude/と.mcp.jsonの差分を確認
`で品質保証付き自前スクリプトに誘導。` `で理由を書くとモデルが従いやすい。 ### Takeaway 4: hooks/で物理的に二重ガード モデルが指示を無視するリスクに備えて、PreToolUseフックでブロックする。 ### Takeaway 5: TypeScriptで実処理を書き、SKILL.mdは自然言語で短く保つ SKILL.mdに長々とロジックを書かない。実処理は`scripts/`の型安全なコードに委譲し、SKILL.mdは「いつ何を呼ぶか」のオーケストレーション指南に専念させる。 --- ## まとめ—「ベンダー製スキル」フェーズの幕開け [Prismatic Skills](https://github.com/prismatic-io/prismatic-skills)は、Claude Code Skillsエコシステムが「単発の参照実装」から「ベンダーが製品体験を束ねた配布物」へ進む転換点に位置する事例だ。自社プラグインを作る最短ルート
- 既存の自社CLIを
scripts/にラップ（またはnpxから呼ぶ） - 主要ユースケース3〜5つを
commands/のスラッシュコマンドにする - 各コマンドの専門知識を
skills/のuser-invocable: falseスキルとして切り出す - 外部API調査・レビューなど特化処理を
agents/に分離 - 禁止ツールを
<disallowed-tools>＋hooks/で二重ガード .claude-plugin/marketplace.jsonを書いてGitHubリポジトリのrootに配置- READMEに
/plugin marketplace add <org>/<repo>を載せて公開
Prismatic Skillsのリポジトリ構造をまるごとコピーして、コマンド名・スキル名・MCPサーバ名を置換するだけで、最小構成のプラグインが2日でできる。
「自社SaaSにClaude Code拡張を作りたい」という相談を受けたら、2026年5月時点ではまず`prismatic-io/prismatic-skills`のリポジトリ構造を読み込ませる、が最短の答えになる。Anthropic公式の参照実装は単発スキルが中心、claude-code-templatesは横断カタログだが、Prismaticはベンダー製プラグインの「縦の階層構造」をきれいに見せている唯一に近い実例だ。 Claude Code Skills全般の使い方は [Claude Code Skills徹底解説](/explain/claude-skills-explained/)、Claude Code拡張の運用ノウハウは [Claude Code ベストプラクティス2026](/explain/claude-code-best-practice-guide-2026/)、配布カタログ系の比較は [claude-code-templates完全解説](/explain/claude-code-templates-davila7/) を併読してほしい。 --- ## 参照ソース - [Introducing Prismatic Skills for Claude Code – Prismatic Blog（2026年4月16日）](https://prismatic.io/blog/introducing-prismatic-skills-for-claude-code/) — 公式アナウンス・5系統スキルの位置づけ - [Prismatic Launches Skills for Claude Code – IT Business Net（2026年5月）](https://itbusinessnet.com/2026/05/prismatic-launches-skills-for-claude-code-to-help-developers-ship-integrations-faster/) — CTO Tanner Burson氏コメント・プレス発表 - [prismatic-io/prismatic-skills – GitHub](https://github.com/prismatic-io/prismatic-skills) — リポジトリ本体（v2.3.0、MIT） - [@prismatic-io/prism-mcp – npm](https://www.npmjs.com/package/@prismatic-io/prism-mcp) — 同梱MCPサーバ - [Claude Code完全ガイド2026](/explain/claude-code-complete-guide-2026/) — ピラー記事この記事のまとめ
- 何が新しいか: iPaaSベンダーが自社製品体験を Claude Code プラグインとして公式マーケット非依存で配布した最初期事例。
- 5系統スキル: Component / CNI / Embed / Orby / Migration。実体は6コマンド＋7エージェント＋8スキル知識ベース。
- 設計の妙:
user-invocable: false・<disallowed-tools>・hooks二重ガード・TypeScript scripts委譲。 - 使い所: Prismatic顧客の開発高速化に加え、自社SaaSプラグインを設計する際の教科書として最有力。
- これから: 同じパターンでStripe / Supabase / Vercelなどがプラグインを出す未来は近い。
