Skill と MCP の役割分担 — なぜ Recraft を Skill でくるむのか

Recraft MCP は、Claude から Recraft の画像生成やベクター化を呼び出す「接続」の層である。接続だけでは、誰がどの場面でどのツールを呼び、どの入力を渡し、どのようにレビューするかが担当者に委ねられる。同じ Recraft を使っても、成果物の品質と再現性は担当者ごとに散る。

Skill は、その「判断の基準」の側を Claude に持たせる仕組みである。Anthropic の Claude Code ドキュメントは Skill を「同じ指示や手順を繰り返し貼っている場面、あるいは CLAUDE.md の一節が事実ではなく手順に育っている場面で作るもの」と定義している。SKILL.md 本体は必要な場面でのみ読み込まれる設計で、読み込まれないあいだは会話の枠を占めない。

Recraft の運用に当てはめると、Skill の役割は次のように整理できる。第一に、どのツール（generate_image / vectorize_image / create_style など）をどの順で呼ぶかを手順として書き下ろす。第二に、ブランドガイドラインの禁止表現、必須色、命名規則を SKILL.md 内に埋め込む。第三に、レビュー観点と保存先のパス構造を明記する。第四に、生成物を SVG で受け取るのかラスターで受け取るのかの選択規則を書く。

MCP が「Claude に何ができるか」を広げる層だとすれば、Skill は「Claude が特定の場面で何をどう行うか」を狭めて統制する層である。両者は代替関係ではなく、下敷きとして MCP が動いた上に Skill が乗る構造で運用する。

SKILL.md の設計 — Recraft MCP を呼び出すパッケージの中身

Custom Skill のフォルダは、SKILL.md を入口に、参照資料と補助スクリプトを同一ディレクトリに置く構成をとる。Recraft を扱う Skill であれば、brand-icons-recraft/ のようなフォルダを作り、直下に SKILL.md を置き、必要ならブランドガイドライン抜粋の Markdown、参照画像への URL リスト、命名規則の JSON を同梱する。

SKILL.md の冒頭には YAML frontmatter で name と description を必ず書く。この二つは、Claude が Skill を発動するかを判断するために常に読み込まれる部分である。名前は動詞と目的語を含む短い英語表記、説明は「どんな場面で使うか」を一文でまとめる。抽象的な形容詞や大げさな売り文句は避け、実際に発動してほしい場面の言葉で書く。

Recraft MCP を呼び出す指示は、本文中で Recraft:generate_image のようにサーバー名とツール名を組み合わせた形で書く。Anthropic の Enterprise ドキュメントは、MCP サーバー参照を含む Skill を「Skill 自身の範囲を超えてアクセスを広げる高リスク要素」として明示している。書き手は、呼び出すツールを最小限に絞り、想定入力と想定出力を SKILL.md 内に列挙する。

参照資料のうち大きなものは、SKILL.md 本文に埋め込まず別ファイルにして、必要な場面で読み込ませる。SKILL.md 本文は Claude の判断ロジックの短い設計書、細部の資料は分割された参照 Markdown、実行の反復部分は同梱スクリプト、という三層で保つと更新の粒度が揃う。

Custom Skill を Claude Code で配布する

Claude Code では、.claude/skills/<skill-name>/SKILL.md の構造で Skill を置く。プロジェクト直下の .claude/skills/ に置いた Skill は、そのリポジトリで作業する担当者全員に配布される。個人のみに閉じたい場合は ~/.claude/skills/ の下に置く。

Recraft を扱う Skill を制作会社と共有する案件であれば、リポジトリ直下の .claude/skills/brand-icons-recraft/ に SKILL.md を置き、Git で正本を管理する。制作会社側の Claude Code は、リポジトリを clone した時点でこの Skill を利用可能な状態になる。呼び出しは自動発動に任せるほか、/brand-icons-recraft のようにスラッシュコマンドで明示的に指定できる。

配布時に注意する点は二つある。一つは、Skill が前提とする MCP 接続を担当者側で成立させておくことである。Recraft MCP の登録が済んでいない環境で Skill を発動しても、Claude は該当ツールを見つけられない。もう一つは、Claude Code の Skill 数を過剰に増やさないことである。Anthropic のドキュメントは、同時に読み込む Skill が多すぎると Claude が発動対象を選び間違えると案内している。Recraft 系の Skill は、案件ごとに三〜五本に絞る運用が現実的である。

claude.ai と Enterprise でチームに配布する

claude.ai の Team および Enterprise プランでは、管理者機能から Custom Skill を組織全体に配布できる。管理者が有効にした Skill は、その組織のメンバー全員で初期状態が有効になり、個々のメンバーは自分の判断で無効化できる。組織側で「使わせる下地」を作り、個人側の柔軟さは残す二段構えの設計である。

Recraft を扱う Skill を Enterprise で配布する場合の手順は次のようになる。まず、Skill 作者が SKILL.md と参照資料を含むフォルダを zip でまとめる。次に、[claude.ai の Organization settings > Skills] からアップロードする。アップロード時、Enterprise で Skill and plugin security scanning を有効にしていれば、ヒドゥンなコード実行、外部への送信、Claude の安全策を書き換える指示などの兆候を自動検査する。検査が通らないと、その Skill は組織内で利用不可の状態になる。

Recraft MCP を呼び出す Skill は、ドキュメント上の「高リスク要素」に該当する。自動スキャンだけを頼りにせず、後述のセキュリティレビューを人手で必ず通す運用が前提である。

Skills API でワークスペース全体に配る

API 経由で Claude を動かしている運用では、Skills API /v1/skills を使って Skill をワークスペースにアップロードする。アップロード済みの Skill は、ワークスペースのメンバー全員から呼び出せる。API リクエスト単位では、同時に指定できる Skill は最大 20 本である。

Recraft を扱う Skill を API で配布する場合、注意点は三つある。一つ目は、API 側のアップロードは Enterprise の自動セキュリティスキャンの対象外である点である。人手のレビューとバージョン固定でリスクを抑える。二つ目は、Skills API と claude.ai と Claude Code のあいだで Skill は自動同期しない点である。同じ Skill を各サーフェスに配りたい場合は、Git 上の一本の正本から各入口に個別に配布する運用が必要になる。

三つ目は、認証情報を Skill 内に埋め込まないことである。Recraft MCP は OAuth で認証を張るため、Skill 側に API キーを書く必要はない。ハードコードは Anthropic の Enterprise ガイドでも高リスクとして明記されている。

サーフェス横断の管理 — 同期しない前提の運用

Anthropic の Enterprise ガイドは、Custom Skill が Claude.ai・Claude Code・API のあいだで自動同期しないことを警告として明示している。API にアップロードした Skill は claude.ai や Claude Code から見えず、逆方向も同じである。ブランドチームが複数の入口で同じ Recraft Skill を運用する場合、この非同期を前提にした設計が必要である。

現実的な運用は次の形になる。Skill の正本は Git のリポジトリで一つに保つ。リポジトリの直下は Claude Code の .claude/skills/ にそのままマップする。claude.ai には管理者アップロードで同じフォルダを zip 化して上げる。API には SDK 経由の CI で自動アップロードする。三つの入口に配る作業は分岐するが、正本は一つに閉じる。

この非同期を放置すると、Claude Code では最新版が動いているが claude.ai には旧版が残ったまま、といったずれが起きる。バージョン番号を SKILL.md の frontmatter に持たせ、配布時にログとして残す運用が最低限の防波堤になる。

セキュリティレビューと自動スキャン

Anthropic は Skill を「本番システムにソフトウェアをインストールするのと同等の厳しさで扱う」と Enterprise ガイドに明記している。第三者や内部の別チームが書いた Skill を配る前に、次の八項目のレビューを通す設計である。第一に、SKILL.md と参照資料、同梱スクリプトを全て読み下す。第二に、スクリプトの実挙動が説明文と一致することを隔離環境で確認する。第三に、Claude の安全策を書き換えたり、ユーザーから動作を隠したりする指示がないかを確認する。第四に、外部 URL への fetch や curl の呼び出しを走査する。第五に、API キーやトークンのハードコードがないことを確認する。第六に、Claude に対して bash やファイル操作を指示する行を洗い出す。第七に、外部 URL の遷移先ドメインが想定通りかを確認する。第八に、機密データを読んで外に送る二段構えのパターンがないかを確認する。

Recraft を扱う Skill は、Recraft: 名前空間の MCP ツールを呼び出す指示を含む時点で、Enterprise の risk tier で「High」の項目に該当する。レビューの厳しさは、MCP 未使用の Skill よりも一段引き上げる必要がある。作者と査読者を分ける separation of duties を組織側で徹底し、Skill 単体の隔離テストと、既存 Skill と並べたときの共存テストを両方通す。

Enterprise の自動スキャンは、この人手レビューを補うが置き換えるものではない。Anthropic のドキュメントも「補完するが置き換えない」と明記している。API 経由の Skill、customer-managed encryption keys、zero data retention、HIPAA readiness の構成では自動スキャンが対象外になるため、レビュー体制の設計はいずれにせよ人手を前提に組む。

バージョン管理と評価

本番運用では、Skill をバージョン番号で固定する。Anthropic のドキュメントは、バージョン指定を省略すると最新版が呼び出されるため、ワークスペースの誰かが新版を上げた瞬間に本番の挙動が変わると警告している。Recraft を扱う Skill のように、ブランド運用の結果に直接影響する Skill は特に、本番はバージョン固定、検証環境で最新版、が既定である。

新版を本番に上げる前には、Skill 単体の隔離評価と、既存 Skill と組み合わせた共存評価を通す。Anthropic の best practices ドキュメントは、Skill 作者に対して代表的な三〜五本のテストクエリを求め、発動すべき場面、発動すべきでない場面、判断が割れる境界の三種を含めるよう案内している。Recraft を扱う Skill では、たとえば「ブランドアイコン八枚を SVG で」「既存ロゴを差し替え色域で」「印刷用にアップスケール」といった代表ケースをテスト集として持ち、モデル（Haiku・Sonnet・Opus）ごとに挙動が揃うかを確認する。

Skill を消す判断も評価に紐づけておく。三ヶ月連続で発動しない Skill、精度が継続的に落ちる Skill、ブランドガイドラインの改訂で存在意義を失った Skill は、迷わず廃止する。Skill 数を絞り込む姿勢が、Claude の判断精度と担当者の混乱抑制の両方に効く。

関連する記事

FAQ

Q1. Recraft の公式パートナー Skill は存在するか

現時点で、Anthropic の Skills Directory に Recraft の公式パートナー Skill は掲載されていない。Canva、Notion、Box、Figma、Atlassian などがパートナー Skill として掲載されているが、Recraft はここに含まれない。組織で Recraft を Skills 経由で運用したい場合は、Recraft MCP を呼び出す Custom Skill を自作する設計になる。

Q2. Custom Skill から Recraft MCP を呼び出す書式は何か

SKILL.md の本文中で Recraft:generate_image のように、サーバー名とツール名をコロンで区切って参照する。Anthropic の Enterprise ドキュメントは、この参照形式を「MCP server references」として risk tier の項目に列挙している。書き手は、呼び出すツールを最小限に絞り、想定入力と想定出力を SKILL.md 内に列挙する運用にする。

Q3. Skill を Claude.ai と Claude Code と API に同時配布できるか

自動同期はできない。Anthropic の Enterprise ガイドは、Custom Skill が三つのサーフェスのあいだで同期しないことを警告として明記している。Git 上に正本を一本持ち、Claude Code は .claude/skills/ に mapping、claude.ai は管理者アップロード、API は Skills API /v1/skills に CI から自動アップロード、という配布経路をそれぞれ組む必要がある。

Q4. Enterprise の自動セキュリティスキャンは Recraft Skill にも効くか

claude.ai と Claude Cowork にアップロードされた Custom Skill が対象で、Recraft MCP を呼び出す Skill もスキャン対象に含まれる。ただし Skills API 経由のアップロードは対象外である。加えて、customer-managed encryption keys、zero data retention、HIPAA readiness の構成では自動スキャンが対象外となる。自動スキャンは補完的な位置づけで、人手のレビュー体制を置き換えない前提で運用する。

Q5. Skill を何本まで同時に有効化できるか

API リクエスト単位では、同時指定できる Skill は最大 20 本である。claude.ai や Claude Code では明示的な上限はないが、Anthropic は「同時に読み込む Skill が多すぎると Claude が発動対象を選び間違える」とドキュメントで案内している。案件ごとに、必要最小限の Skill を有効化する運用が推奨される。

情報源