スキルを共有する
スキルを共有する · 4分
スキルはチームや組織全体で共有されることで、はるかに価値の高いものになります。このビデオでは、リポジトリへのコミット、プラグイン、エンタープライズ管理設定という3つの主要な配布方法を取り上げ、スキルを使用するようカスタムサブエージェントを設定する方法を説明します。どのアプローチがどのシナリオに適しているか、そして重要な注意点の扱い方を学びます。サブエージェントはスキルを自動的に継承しないのです。
重要なポイント
- プロジェクトスキルは
.claude/skillsに配置され、Gitを通じて自動的に共有されます — リポジトリをクローンした人は誰でもそれらを入手できます - プラグインを使うと、より広いコミュニティでの利用のために、マーケットプレイスを介してリポジトリ間でスキルを配布できます
- エンタープライズ管理設定は最も高い優先度で組織全体にスキルを展開するもので、必須の標準やコンプライアンスに最適です
- サブエージェントは、すでに呼び出されたスキルを認識しません。Skillツールを持っていれば、それでもスキルを見つけて呼び出すことができます
- Explore や Plan のような組み込みエージェントは、スキルを事前にロードしません。起動時にロードするスキルを一覧できるのは、
skillsフィールドを持つカスタムサブエージェントだけです
スキルは共有されることで、はるかに価値の高いものになります。あなただけが使うPRレビュースキルも役に立ちますが、それをチーム全体で共有すれば、コードレビューが標準化され、組織全体で一貫した体験が生まれます。スキルを配布するさまざまな方法を見ていきましょう。
スキルをリポジトリにコミットする
最も単純な共有方法は、スキルをリポジトリに直接コミットすることです。.claude/skillsに配置すれば、リポジトリをクローンした人は誰でも、追加のインストール作業なしで自動的にそれらのスキルを入手できます。
更新をプッシュすると、全員が次のプルでそれを受け取ります。このアプローチは次のような場合にうまく機能します。
- チームのコーディング標準
- プロジェクト固有のワークフロー
- コードベースの構造を参照するスキル
.claudeディレクトリには、エージェント、フック、スキル、設定が含まれており、すべてバージョン管理され、通常のGitワークフローを通じてチームと共有されます。
プラグインを通じてスキルを配布する
プラグインは、チームやプロジェクト間で共有されることを想定してカスタム機能でClaude Codeを拡張する方法です。プラグインプロジェクト内に、.claudeディレクトリと似たファイル構造に従うskillsディレクトリを作成します — 各スキルはそれぞれ独自のフォルダを持ち、その中にSKILL.mdファイルが入ります。
プラグインをマーケットプレイスに配布すると、他のユーザーはそれを発見し、自分のClaude Codeにインストールできます。

このアプローチは、スキルがあまりプロジェクト固有ではなく、直接のチーム以外のコミュニティメンバーにとっても有用である場合に最適です。
管理設定によるエンタープライズ展開
管理者は管理設定を通じて組織全体にスキルを展開できます。各スキルは、各マシン上の管理設定ディレクトリ内、例えばLinuxでは/etc/claude-code/.claude/skills/のように、.claude/skills/の中に配置されます。エンタープライズスキルは最も高い優先度を持ち、同名の個人スキルやプロジェクトスキルを上書きします。

管理設定はプラグインも制御します。例えば、strictKnownMarketplacesは、ユーザーがプラグインを追加・インストールできるマーケットプレイスを制限します。上記のスクリーンショットにはnpmエントリが含まれていますが、これは何にも一致しないため、この例では代わりにurlエントリを使用します。
"strictKnownMarketplaces": [
{
"source": "github",
"repo": "acme-corp/approved-plugins"
},
{
"source": "url",
"url": "https://plugins.example.com/marketplace.json"
}
]エンタープライズ展開は、組織全体で一貫して守らなければならない必須の標準、セキュリティ要件、コンプライアンスワークフロー、コーディング慣行に適した選択肢です。ここでのキーワードは「守らなければならない」です。
スキルとサブエージェント
これは人々を驚かせるポイントです。サブエージェントは、すでに呼び出されたスキルを認識しません。タスクをサブエージェントに委任すると、それがフォーク(新しいタブで開きます)でない限り、サブエージェントはまっさらで新しいコンテキストから開始します。フォークの場合は会話のコピーから開始します。まっさらな状態で開始するサブエージェントでも、Skillツールを持っている限り、そのツールを通じてスキルを見つけて呼び出すことができます。
理解しておくべき重要な区別があります。
- 組み込みエージェント(ExploreやPlanなど)はスキルを事前にロードしません
- 定義するカスタムサブエージェントは、
skillsフィールドに列挙したスキルを事前にロードできます。toolsリストを指定する場合は、サブエージェントが未列挙のスキルも呼び出せるようSkillをそこに残しておいてください - 事前にロードされたスキルは、サブエージェント起動時に完全にロードされます。メイン会話のようにオンデマンドでロードされるわけではありません
スキルを持つカスタムサブエージェントを作成するには、.claude/agentsにエージェントのMarkdownファイルを追加します。ファイルは自分で書くことも、Claudeに作成してもらうこともできます。セッション開始時に.claude/agentsが存在しなかった場合は、Claude Codeを再起動して新しいサブエージェントをロードしてください。以下のスクリーンショットは/agentsウィザードを示していますが、これはClaude Code v2.1.198で削除されました。

エージェントファイルのskillsフィールドには、ロードするスキルが列挙されます。フロントマターは次のようになります。
---
name: frontend-security-accessibility-reviewer
description: "Use this agent when you need to review frontend code for accessibility..."
tools: Bash, Glob, Grep, Read, WebFetch, WebSearch, Skill...
model: sonnet
color: blue
skills: accessibility-audit, performance-check
---このサブエージェントに委任すると、両方のスキルがロードされた状態になり、すべてのレビューにそれらが適用されます。まず.claude/skillsディレクトリにスキルが存在することを確認してから、新しいサブエージェントを作成するか、既存のエージェントのMarkdownファイルにskillsフィールドを追加します。
このパターンは、次のような場合に非常にうまく機能します。
- 特定の専門知識を持つ、独立したタスク委任を求めている場合
- 異なるサブエージェントが異なるスキルを必要とする場合(フロントエンドレビュアー対バックエンドレビュアー)
- プロンプトに頼らず、委任された作業において標準を強制したい場合
レッスンの振り返り
- 構築を検討しているスキルには、どの共有方法(リポジトリ、プラグイン、エンタープライズ)が最も適していますか?
- 特定のスキルを持つカスタムサブエージェントによって、委任された作業の一貫性が向上するようなワークフローはありますか?
次は何をしますか
最終レッスンでは、トリガーされないスキル、優先順位の競合、ランタイムエラーといった、よくあるスキルの問題をトラブルシューティングする方法を、いつでも参照できる実用的なチェックリストとともに学びます。