agent skillを複数リポジトリで共有する方法
8つのリポジトリへskillをコピーすると内容が分岐します。共有リポジトリを1つに集約し、各プロジェクトでバージョンを固定してレビューする管理方法を解説します。
リポジトリ間で agent skill を共有する方法
リポジトリ間で agent skill を共有するには、ファイルのコピーをやめ、そのファイルを依存関係として扱います。skills リポジトリを1つに集約してタグを付け、各プロジェクトでタグを固定します。次に、各 skill にスモークテストを追加し、依存関係の更新と同じ手順で更新内容を毎回レビューします。
必要な要素は4つです。共有する正規の情報源、リポジトリごとの固定バージョン、skill ごとのスモークテスト、そしてレビュー手順です。以下では、各要素が必要な理由、2026 年に提供されているツールがこの構成をどう扱うか、外部の git ホストやパッケージレジストリを使わず、self-hosted の git remote 上で全体を構築する方法を説明します。例外はスモークテストです。スモークテストでは Claude Code を実行し、すべてのリクエストを model API に送信するため、この処理だけはサーバーの外部に出ます。
agent skill は、SKILL.md ファイルと、それが必要とするスクリプトおよび参照ファイルを格納するフォルダーです。この単位を初めて扱う場合は、先にagent skill とは何か、SKILL.md がどのように動作するかを読んでください。このページでは、その単位を取り巻くサプライチェーンについて説明します。
スキルの配置場所と、共有が難しい理由
Claude Code は、次の場所などからスキルを読み込みます。skills documentation には各パスが記載されています。
.claude/skills/<skill-name>/SKILL.mdは managed settings directory 内にあり、enterprise 用の場所です。組織がこれを展開したマシンでは、すべてのユーザーに対して読み込まれます。~/.claude/skills/<skill-name>/SKILL.mdは個人用です。自分のすべてのプロジェクトで読み込まれますが、他のユーザーには適用されません。.claude/skills/<skill-name>/SKILL.mdはプロジェクトレベルです。その repository を checkout したユーザーに対して読み込まれます。<plugin>/skills/<skill-name>/SKILL.mdは plugin に含まれています。その plugin が有効な環境で読み込まれます。
Claude Code は、ネストされたプロジェクトディレクトリ、--add-dir で指定されたディレクトリ、claude.ai アカウントで有効にしたスキルからも読み込みます。
チームで使う場合に便利なのは、プロジェクトレベルの場所です。そこに置いたファイルは commit され、repository を clone した全員が取得できるためです。ただし、ここから問題が始まります。.claude/skills/ にあるスキルは、1 つの repository に属します。repository が 8 個ある場合、スキルも 8 個コピーすることになります。
frontmatter も役に立ちません。Agent Skills spec で使用できるキーは 6 個だけです。別のキーを使うと、それを適用する distribution path が次の一覧を表示します。
Unexpected key(s) in SKILL.md frontmatter: argument-hint. Allowed properties are: allowed-tools, compatibility, description, license, metadata, name欠けているものに注目してください。version キーはありません。metadata の下にバージョンを記録することはできますが、spec には依存関係の固定や更新の仕組みが定義されていません。これは、スキルが package ではなくドキュメントであることを考えれば妥当です。そのため、バージョン管理はファイルの周辺にあるレイヤーで行う必要があり、そのレイヤーを用意するのはユーザーの役割です。
問題1: 気付かないうちに分岐する8個のコピー
コピーと貼り付けは初日には機能します。しかし、60日目には破綻します。誰かがpayments repoの誤った指示を修正しても、残りの7個には反映しません。別の誰かがordersにページネーションのルールを追加します。すると、同じskill名でも、agentがどのディレクトリから起動したかによってレビュー結果が異なります。しかも、どの開発者もその違いに気付きません。
この問題は、エラー状態が存在しないため、気付かないまま発生します。skillは文章です。古い指示は、自信に満ちた誤った回答を生成します。これは、対応コストが高い種類の問題です。agentが自分のコピーを他のコピーと比較する仕組みはありません。そのため、唯一の兆候は、2つのrepoで内容が食い違っていることに誰かが気付くことです。
問題 2: バージョンを固定する仕組みがない
チームがスキルを 1 か所で管理していても、一般的な共有方法はコピーです。セットアップスクリプト、オンボーディングドキュメント内の curl 行、またはフォルダーを同期する shell alias を使います。これらはすべて、その時点でブランチの先頭にある内容をインストールします。
そのため、同じアプリケーションの同じ commit を使っている 2 人の開発者でも、異なる指示を実行する可能性があります。同期を実行した日が異なるためです。また、agent の実行に問題が起きた後に重要になる「この処理を生成したスキルのバージョンは何か」という問いにも答えられません。記録された revision がなければ実行を再現できず、バグレポートを有効な調査につなげられません。
問題 3: そのスキルがまだ機能するか誰にも分からない
スキルにはコンパイラーがありません。モデルに向けた指示であるため、ファイルが 1 バイトも変わっていなくても機能しなくなることがあります。モデルをアップグレードすると、長い指示にどの程度忠実に従うかが変わります。スキルが呼び出すコマンドラインツールでフラグの名前が変更されることもあります。参照ファイル内の URL が 404 を返すようになると、エージェントがエラーページを基に処理することもあります。
このような場合でも、明確な失敗は発生しません。エージェントは回答を返し続けます。ただし、その回答は先月より悪くなっています。これを pull request 1 件ずつの単位で把握するのは困難です。
2026 年に提供されるツールが解決する問題
現在、複数の解決策が登場しています。ただし、バージョンをどこで管理すべきかについては意見が分かれています。
ロックファイル。 Vercel Labs の skills コマンドラインツール(vercel-labs/skills、MIT ライセンス、2026 年 10 月 9 日時点で v1.7.2)は、git リポジトリからスキルをエージェントが想定するディレクトリへインストールします。70 を超えるエージェントのディレクトリ構成に対応しています。npx skills add <repo> はインストール、npx skills update はアップグレード、npx skills list はインストール済みの内容の表示に使用します。ロックファイルは 2 つあります。グローバルロックファイル ~/.agents/.skill-lock.json には、1 人のユーザーがインストールした内容が記録されます。2026 年 2 月 20 日の v1.4.1 以降、プロジェクトスコープにインストールすると、プロジェクトルートにも skills-lock.json が作成されます。ツールのソースコードでは、このファイルをバージョン管理に登録することが想定されています。npx skills experimental_install は、このファイルを使用してプロジェクトのスキルを復元します。別のマシンでグローバルロックファイルを復元する skills install コマンドを求めた Issue 283 は、2026 年 11 月 5 日に対応予定なしとしてクローズされました。メンテナーは、Issue 549 と同じ要望だと説明しています。どちらも現在の状況を示す情報として読んでください。プロジェクト単位のロックファイルは存在します。リリース済みの v1.8.1 では、復元コマンドはヘルプ上では引き続き experimental と表示されます。ただし、ソースを指定しない npx skills install でもプロジェクトのロックファイルを復元できます。
仕様とテスト。 SkillSpec は異なる方向からアプローチします。SKILL.md を信頼すべき文章ではなく、検証対象の契約として扱います。目標は、スキルを「followable, testable, and provable」にすることです。skillspec doctor <path> は、エージェントが処理の流れを失いそうな箇所を報告します。skillspec boundary map <path> はスキルの内容を表示し、skillspec boundary assess <path> はスキルがアクセスできる対象をリスク順に報告します。これは Rust のクレートで、MIT または Apache 2.0 のデュアルライセンスです。バージョン 0.2.2 は 2026 年 7 月 29 日に公開され、2026 年 10 月 10 日時点で crates.io の最新版です。最新版ではなく、指定したバージョンをインストールしてください。
cargo install skillspec --version 0.2.2 --locked
skillspec --version2026 年 11 月 12 日にリリースされた Cargo 1.100 以降、cargo install はパッケージに含まれるロックファイルをデフォルトで使用するため、--locked は何もしません。skillspec --version は 0.2.2 を出力するはずです。異なる番号が表示される場合は、PATH 内の古いバイナリが優先されています。
ベンダーの実践。 Google は、google/skills のスキルをどのように構築しているかを、エージェントスキルの構築、テスト、スケール方法に関する記事で説明しています。規模を除けば、その仕組みは一般的な継続的インテグレーション(CI)です。各スキルは、マージ前に frontmatter のメタデータ、行数、ディレクトリ構成、命名を検査する linter を通過します。リンクチェッカーは、404 を返す URL が 1 つでもあるとビルドを失敗させます。これにより、エージェントがもっともらしいリンクを生成した場合も検出できます。作成者は、スキルとともに評価用のプロンプトスイートと採点基準を提供する必要があります。定期的な評価ジョブはライブラリ全体を対象に毎週実行され、リグレッションを検出します。また、各スキルには担当者が 1 人割り当てられ、品質が低下した場合に修正することが求められます。
3 つの回答に共通するパターン
これらのいずれかを選ぶ必要はありません。3 つの回答の下には 1 つの構造があり、plain git だけでその全体を扱えます。
- 信頼できる唯一の情報源。skill には 1 つだけの本体があり、各リポジトリはコピーを保持せず、その本体を参照します。
- リポジトリごとに固定したバージョン。各プロジェクトは使用する正確な revision を記録します。そのため、アップグレードは作成者と日付を持つ、そのプロジェクト内の commit になります。
- skill ごとのスモークテスト。skill が約束した結果を引き続き生成できることを示す、実行可能なチェックを 1 つ用意します。
- レビューの経路。共有 skill への変更はレビューを経由し、各利用側は取り込む前に差分を確認できます。
これが dependency の構造です。skill は tooling が整備されるよりも早く共有 artifact になりました。そのため、すでに信頼している tooling を使うのが最も安全です。
小規模チーム向けの self-hosted git remote の構成
1 つのリポジトリにスキルを集約します。ほかのファイルは置かないため、その履歴が手順の変更履歴になります。
agent-skills/
skills/
api-review/
SKILL.md
release-notes/
SKILL.md
tests/
api-review.sh
release-notes.sh
CHANGELOG.mdリリースにはタグを使用します。メッセージと日付を保持できるため、annotated tag を使用してください。メッセージには、利用者が更新を適用する理由を記載します。
git tag -a v1.4.0 -m "api-review: require pagination on list endpoints"
git push origin v1.4.0リモートが Gitea、Forgejo、GitLab、または自分の VPS 上で SSH 経由の bare repository であっても、以下の内容は変わりません。必要なのは git と symlink だけです。
git submodule によるバージョン固定
submodule は、別のリポジトリの特定のコミットをリポジトリ内に記録します。この記録が pin です。各利用プロジェクトで、次のように設定します。
git submodule add https://git.example.com/team/agent-skills.git vendor/agent-skills
git -C vendor/agent-skills fetch --tags
git -C vendor/agent-skills checkout v1.4.0
mkdir -p .claude/skills
ln -s ../../vendor/agent-skills/skills/api-review .claude/skills/api-review
git add .gitmodules vendor/agent-skills .claude/skills/api-review
git commit -m "Pin shared agent skills to v1.4.0"この構成を機能させるのがシンボリックリンクです。プロジェクトレベルの skill エントリは、ディスク上の別の場所にあるディレクトリへのシンボリックリンクにできます。Claude Code はそのリンクをたどり、対象から SKILL.md を読み取ります。そのため、skill は通常のプロジェクト skill として読み込まれます。一方、実体は選択したコミットの submodule 内に保持されます。
pin を確認します。
git submodule status正常な行は、先頭がスペースで始まり、続いてコミット、パス、最も近いタグの順になります。
4d1a7c2f0b93e5a1c8d6f2b40e7a95c3d1f8b602 vendor/agent-skills (v1.4.0)先頭の - は、submodule がまだ初期化されていないことを示します。この場合、.claude/skills/api-review は何も指さず、skill はエラーを表示せずに読み込まれません。git submodule update --init で修正できます。先頭の + は、チェックアウトされているコミットが記録されたコミットと異なることを示します。その開発者は、他の開発者が使っていない指示で実行している状態です。新しい clone では git clone --recurse-submodules が必要です。この行は README に記載してください。通常の clone だけでは vendor/agent-skills が空のままとなり、エラーも表示されないためです。
アップグレードは意図的に行います。これが submodule を使う目的です。
git -C vendor/agent-skills fetch --tags
git -C vendor/agent-skills diff v1.4.0 v1.5.0 -- skills/
git -C vendor/agent-skills checkout v1.5.0
git add vendor/agent-skills
git commit -m "Bump shared agent skills to v1.5.0"diff の行がレビュー対象です。ほかの利用リポジトリにも適用される同じ変更を確認でき、pull request に含められます。
プラグインマーケットプレイスで固定する方法
すべての開発者に submodule の習得を求めたくない場合は、Claude Code のプラグインシステムが配布を代行します。self-hosted の remote に対しても機能します。skills リポジトリの .claude-plugin/marketplace.json にカタログを配置します。
{
"name": "acme-agents",
"owner": { "name": "Platform team", "email": "platform@example.com" },
"plugins": [
{
"name": "team-skills",
"description": "Shared review and release skills",
"version": "1.4.0",
"source": {
"source": "url",
"url": "https://git.example.com/team/agent-skills.git",
"ref": "v1.4.0",
"sha": "4d1a7c2f0b93e5a1c8d6f2b40e7a95c3d1f8b602"
}
}
]
}ここでは異なる 2 つの source を使用しており、これらを混同するのがよくある誤りです。marketplace source はカタログ自体の取得元を意味します。branch または tag には ref を指定でき、Claude Code v2.1.324 以降では完全な小文字の commit SHA も指定できます。ただし、個別の sha フィールドには対応していません。カタログ内の plugin source は両方に対応しており、両方を指定した場合は sha が実際の pin になります。marketplace source の ref でカタログを固定し、カタログエントリの sha でプラグインを固定します。type 名も異なります。カタログ内では url が clone 対象の git リポジトリを意味します。marketplace source では url が marketplace.json ファイルへの直接リンクを意味し、git リポジトリには git を指定します。
各利用リポジトリでは、コミット済みの .claude/settings.json で marketplace を宣言します。
{
"extraKnownMarketplaces": {
"acme-agents": {
"source": {
"source": "git",
"url": "https://git.example.com/team/agent-skills.git",
"ref": "v1.4.0"
}
}
},
"enabledPlugins": {
"team-skills@acme-agents": true
}
}各開発者がプロジェクトフォルダーで workspace trust ダイアログを受け入れると、Claude Code はその開発者向けに marketplace を登録します。登録方法を説明する wiki ページは必要ありません。カタログエントリは相対パスではなく git URL を指定するため、リポジトリの設定だけではプラグイン自体はインストールされません。各開発者は claude plugin install team-skills@acme-agents --scope project を 1 回実行します。それまでは、Claude Code はプロジェクト設定でプラグインが有効になっているものの、インストールされていないと報告します。plugin の skill は plugin 名で名前空間が分かれるため、/team-skills:api-review で利用できます。同じ名前の project skill と衝突することもありません。新しい tag を push し、カタログと利用リポジトリの pin を更新したら、利用側で /plugin marketplace update acme-agents を実行して更新します。その後、インストール概要で求められた場合は /reload-plugins を実行します。
1 つの skill のスモークテストを作成する
スモークテストは、既知の不具合を含むフィクスチャに対してエージェントをスクリプトで実行し、1 つのアサーションを行うテストです。Claude Code は -p を指定すると非対話的に実行でき、ユーザーが呼び出す skill もその環境で動作します。プロンプト文字列に /skill-name を記述すると、実行開始前に展開されます。
#!/usr/bin/env bash
set -euo pipefail
claude -p "/api-review Read fixtures/orders-api.md and list the rule ids it breaks." \
--allowedTools "Read" \
--output-format json \
--json-schema '{"type":"object","properties":{"rule_ids":{"type":"array","items":{"type":"string"}}},"required":["rule_ids"]}' \
| jq -e '.structured_output.rule_ids | index("pagination-required")' > /dev/nullfixtures/orders-api.md は、意図的な不具合を 1 つだけ含む短いファイルです。アサーションでは、skill がその不具合を指摘することを確認します。jq -e は、フィルターの出力が null になるとゼロ以外の終了ステータスで終了するため、埋め込んだ不具合を検出できなくなった skill はスクリプトに失敗します。claude 自体も実行が失敗するとゼロ以外の終了ステータスで終了し、set -euo pipefail によってどちらの失敗もテスト失敗になります。
モデルは実行ごとに回答の表現を変えるため、文全体をアサートしないでください。skill が出力するはずの識別子、または指定したスキーマのフィールドをアサートします。実行コストを抑えられるよう、フィクスチャは小さくしてください。
CI では --bare を追加します。これを指定しない場合、claude -p は対話セッションと同じコンテキストを読み込みます。そこにはフック、プラグイン、実行マシン上の CLAUDE.md も含まれるため、チームメイト個人の設定によって結果が変わる可能性があります。bare モードでは、--add-dir で明示的に指定したディレクトリの .claude/skills/ にある skill を除き、自動検出をスキップします。このモードでは、ここでテストするプロジェクトの skill も読み込まれないため、その skill を明示的に読み込んでください。bare モードではサブスクリプションのログイン情報も読み込まれないため、先に環境変数で ANTHROPIC_API_KEY を設定します。
claude --bare -p "/team-skills:api-review Read fixtures/orders-api.md and list the rule ids it breaks." \
--plugin-dir vendor/agent-skills \
--allowedTools "Read" \
--output-format json--plugin-dir で読み込んだプラグインは .claude-plugin/plugin.json から名前を取得します。そのマニフェストがない場合は、ディレクトリ名がプラグイン名になります。skills リポジトリの catalog の隣に、"name": "team-skills" を含む plugin.json をコミットしてください。そうしない場合、上記のコマンドでは代わりに /agent-skills:api-review を呼び出す必要があります。
--output-format stream-json を指定すると、system/init イベントで読み込まれたプラグインが報告され、読み込まれなかったプラグインは plugin_errors 配列に格納されます。起動イベントが先に発生しない場合、このイベントによってストリームが開始されます。plugin_errors が空でない場合は CI ジョブを失敗させてください。これにより、存在しなくなったリビジョンを指す pin を検出できます。検出できない場合、エージェントが組織のルールを静かに無視しているように見えます。
共有スキルは実行可能な指示です
そのことを明確にする機能が 2 つあります。ファイルが別のチームから提供された場合、どちらも重要です。
1 つ目は、SKILL.md がモデルによる読み取りの前に shell コマンドを実行できることです。本文に次のような行がある場合、これは前処理として扱われます。
- Current branch: !`git rev-parse --abbrev-ref HEAD`コマンドはスキルを読み込むマシン上で実行され、その出力が、モデルに渡されるテキスト内のプレースホルダーを置き換えます。3 つのバッククォートに続けて ! を記述して開始する fenced block も、同じ方法で複数のコマンドを実行します。実行時に、これらについてユーザーに確認を求めることはありません。Claude Code は各コマンドを権限ルールに照らして確認します。auto mode の外では、これらのルールで許可されていないコマンドがあるとスキルは中止されます。ただし、スキルが次の機能によって事前承認している場合を除きます。deny ルールと ask ルールは、その事前承認よりも優先されます。共有スキルを読むことは、そのコマンド置換を読むことでもあります。
2 つ目は、frontmatter でツールを事前承認できることです。allowed-tools は、スキルを呼び出したターンについて、指定されたツールを権限確認なしで許可します。Workspace trust はこの許可を制限しません。Claude Code は、誰も信頼していないフォルダーで -p を実行している場合でも、プロジェクトスキルの allowed-tools を適用します。Claude Code のドキュメントは、その結果を明確に説明しています。スキルは広範なツールアクセスを自ら付与できるため、そこで Claude Code を実行する前に、リポジトリに含まれるスキルの allowed-tools を確認してください。組織は、管理設定で allowManagedPermissionRulesOnly を設定すると、プロジェクトスキルと個人スキルからこのフィールドを使用できないようにできます。この機能には Claude Code v2.1.282 以降が必要です。
したがって、スキルの更新は依存関係の更新と同じように扱ってください。仕組みで許可される場合は、正確な commit で固定してください。tag は移動でき、branch は定義上移動するためです。制限されたマシンでは、設定の "disableSkillShellExecution": true により、すべてのコマンド置換が実行されず、リテラルテキスト [shell command execution disabled by policy] に置き換わります。managed settings を通じて適用した場合、ユーザーはこれを上書きできません。Bundled skill と managed skill はこの設定の対象外です。
スキルが読み取る内容にも同じ注意が必要です。env を実行したり config file を開いたりするスキルは、そこで見つかった内容をすべてモデルのコンテキストに取り込みます。これは、実行する agent から秘密情報を除外するで扱った問題です。ページを取得したり query を実行したりするスキルでは、同じ露出が外部に向かって発生します。取得したテキストは、作成した指示とまったく同じようにコンテキストへ入るためです。これは、Web 検索用に自分の SearXNG instance を agent に指定する前に確認しておく価値のある境界です。
バージョン更新時に確認する内容
- すべての
SKILL.md本文の差分。これはエージェントが従う指示だからです。 - すべてのコマンド置換。skill の読み込み時にローカルマシンで実行されるためです。
allowed-toolsの変更。プロンプトなしでツールを許可する行だからです。- タグに紐づくテスト実行結果。共有リポジトリが CI で独自のスモークテストを実行する場合、固定するタグには成功した実行結果が付いている必要があります。
レビュアーが 10 分で差分全体を読めない場合、その skill は大きくなりすぎています。分割してください。同じことは、エージェントが読むリポジトリのドキュメントにも当てはまります。永続的なルールは AGENTS.md と HUMAN.md の分割 で説明されているファイルに置き、アーキテクチャ上の判断理由は エージェント向けに作成した DESIGN.md に記載してください。skill は限定的な手順に絞ります。
モデルまたはツールの変更によって skill が機能しなくなる場合
skill を編集していなくても、その内部の複数の要素が変わることがあります。モデルのアップグレードによって長い指示への追従性が変わると、9 番目の手順まで到達することを前提にした skill は、そこまで進まなくなる可能性があります。コマンドラインツールがフラグ名を変更すると、agent は古いフラグを実行し、エラーを読み取って独自に対応します。参照先の URL が 404 を返し始めることもあります。agent harness が skill の選択方法を変更すると、以前はマッチに成功していた description が選ばれなくなる場合もあります。このように手順が途中で終了するようになった場合、バージョンを上げても解決しません。最後の手順まで強制的に進める構造を指示に組み込む必要があります。unlazy skill とその Depth Tree 手法は、この考え方に基づいています。
この構成では、smoke test が重要な役割を担います。各 skill のテストは push 時だけでなく、スケジュールでも実行してください。Google がライブラリ全体を対象に評価ジョブを毎週実行しているのも、このためです。skill が 10 個あるチームであれば、小規模な VPS 上の週次 cron job で十分です。開発者が問題に気付く前に、破損を知る唯一の方法です。
移植性も役立ちます。Agent Skills spec では frontmatter のキーを 6 個に限定しているため、その spec に従って作成した skill は、作成時に使用したツール以外でも読み込めます。一方、harness 固有のキーを追加するたびに、特定のベンダーに依存することになります。モデルを変更しても動作する skill の作成には、独自の技術が必要です。詳細は 任意のモデルで skill を動作させる方法で説明しています。
FAQ
複数のリポジトリで 1 つの agent skill を共有するにはどうすればよいですか?
skill を専用の git リポジトリに配置し、そこでリリースに tag を付けます。各利用プロジェクトでは、ファイルをコピーせずに tag を参照します。利用できる方法は 2 つあります。git submodule は正確な commit を記録します。.claude/skills/<name> から submodule への symlink を作成すると、通常のプロジェクト skill として読み込まれます。plugin marketplace でも同じことができます。/plugin を使用し、利用側リポジトリの .claude/settings.json で pin を宣言します。どちらもバージョンを git の履歴に記録するため、特定の agent の実行でどの指示が使われたかを確認できます。
agent skill を特定のバージョンに固定できますか?
SKILL.md の内部ではできません。この frontmatter には version key がないためです。pin はファイルの外側のレイヤーで指定する必要があります。git submodule は設計上、正確な commit に pin します。Claude Code plugin marketplace では、plugin source の ref で branch または tag を指定し、sha で正確な commit を指定できます。両方がある場合は sha が優先されます。marketplace source 自体では、ref に branch、tag、または Claude Code v2.1.324 以降で完全な小文字の commit SHA を指定できます。tag は確認後に移動される可能性があるため、commit による pin を推奨します。
skill の smoke test では何を検証すべきですか?
安定した内容を検証します。既知の障害を含む fixture に対して skill を非対話的に実行し、出力に特定の identifier が現れることを確認します。たとえば、skill が報告するはずの rule id を確認します。--output-format json と --json-schema で構造化出力を要求すると検証を正確にでき、jq -e により値がない場合に script を失敗させられます。モデルは実行ごとに回答の文言を変えるため、全文を検証してはいけません。
別チームのリポジトリにある共有 skill をインストールしても安全ですか?
実行可能な指示であるため、コード依存関係として扱ってください。SKILL.md は、! の command substitution 形式を通じて、読み込み時に shell command を実行できます。また、frontmatter の allowed-tools field により、prompt なしで tool を事前承認できます。更新のたびに diff を確認し、branch ではなく正確な commit に pin してください。自チームが管理する source を優先します。管理対象のマシンでは、settings の "disableSkillShellExecution": true により、user、project、plugin、additional-directory の skill で command substitution が実行されないようにできます。bundled skill と managed skill は対象外です。
共有 skill は Claude Code 以外の agent でも動作しますか?
使用する frontmatter によって異なります。Agent Skills spec では 6 つの key、name、description、license、compatibility、metadata、allowed-tools を定義しています。これらだけを使用する skill は、spec を実装する tool 間で読み込めます。Claude Code でも変更なしで読み込めます。spec に含まれない harness 固有の key や body feature は、他の環境では無視または拒否されます。そのため、広く共有する skill には含めないでください。