Agent Mentor Learn
Claude Code Skills: 自分専用の AI ワークフローを作る · 第 6 回 / 全 6 回

レッスン6: 高度なパターン: スキルをさらに強力にする

学習目標:

  • パーソナルスキルとプロジェクトスキルの違いを理解する
  • プロジェクトスキルを Git で管理する
  • 共有スキルを健全に保つチームのプラクティスを実践する
  • スキルのエコシステムに何があるかを把握する

前提: << レッスン5

パーソナルスキル vs プロジェクトスキル

ここまで作ってきたスキルはすべて ~/.claude/skills/ に置いてきました。これらはパーソナルスキル、つまりあなただけが使えるものです。 1

ただしチームで働く場合は、たいてい別のものが欲しくなります。

  • 全員が同じ基準でコードをレビューする
  • 新しく入ったメンバーがリポジトリをクローンすれば、チームのスキルがすぐに手に入る
  • スキルの改善が、ファイルをコピーして回らなくても全員に届く

そのためにあるのが プロジェクトスキル です。 2

2 つの違い

特性パーソナルスキルプロジェクトスキル
場所~/.claude/skills/.claude/skills/
スコープあなたのすべてのプロジェクト現在のプロジェクト
バージョン管理不要Git にコミットする
チーム共有共有されない全員と共有される
典型的な用途個人的な習慣、汎用ツールプロジェクトの規約、チームのプロセス

どちらを選ぶか

パーソナルスキル: 2

  • ドキュメント形式の変換（Markdown → Word）
  • あなた個人が好むタスクの整理の仕方
  • 自分のコードスタイルの好み
  • どのプロジェクトでも使いたい汎用ツール

プロジェクトスキル:

  • チームのコードレビュー基準
  • プロジェクトのコミットメッセージ形式
  • 特定のフレームワーク向けのスキャフォールディング
  • プロジェクトのデプロイ手順

プロジェクトスキルを作る

ステップ 1: プロジェクトディレクトリ内に作る

プロジェクトに移動します:

ステップ 2: Git にコミットする

ステップ 3: チームメイトが受け取る

チームのほかのメンバーは:

スキルはすぐに使えます。ほかに設定するものは何もありません。1

Git でスキルを管理する

プロジェクトスキルが Git に入ると、Git にできることはすべてスキルにも適用できます。3

バージョン履歴

スキルそのものをコードレビューする

スキルのレビューは、コードのレビューと同じくらい大切です。4

新しいスキルを提出したり、既存のスキルを変更したりするときは:

  1. description が明確かを確認する
  2. 指示が十分に具体的かを確認する
  3. 実際に意図どおりに動くかをテストする
  4. そのプロジェクトに入れる価値があるかを判断する（既存のスキルと衝突しないか？）

PR でスキルファイルをレビューする:

ブランチ運用

実験的なスキルはフィーチャーブランチに置いておく:

長く機能するチームのプラクティス

1. README にドキュメント化する

スキルのドキュメント化はシンプルです。プロジェクトルートの README か .claude/README.md に一覧を書きます: 4

2. 命名を統一する

チーム全体で 1 つの命名規約に決めます: 3

推奨:

  • ハイフン区切り: commit-format、api-doc-gen
  • 動詞-名詞、または名詞-動詞: format-commit、review-code
  • 短く明確に: 2〜3 語

避けるべき:

  • 数字の接尾辞: skill-1、helper-v2
  • 曖昧なもの: tool、helper、utility
  • プロジェクト略称 + 数字: proj-skill-3

3. 定期的に整理する

四半期に一度、まとめて見直します: 3

ほとんど使われないスキルは、改善するか削除すべきです。 使われないスキルが積み上がると、Claude が本当に当てはまるスキルを見つけにくくなります。

4. 変更を通知する

これは重要です: 既存のスキルを変更したら、チームのチャンネルに投稿しましょう。

📢 スキル更新: code-review
変更点:- React Hooks ルールのチェックを追加- 関数の長さのしきい値を引き下げ（50 行 → 40 行）
影響:- これまで通っていたコードが、今は指摘されるかもしれない- 最近の PR を再レビューする価値あり
質問: @dana

スキルを組み合わせる

スキルを組み合わせるとは、複数のスキルを連鎖させて、より大きな 1 つのタスクを処理することです: 1

/commit-format ログインのバグを直した
（Claude が整形済みのコミットを返す）
/code-review
（今変更したコードを貼り付ける）

または、あるスキルの中から別のスキルを参照する:

ここでスキルは真価を発揮します。小さく単一目的のスキルが、より大きなワークフローへと組み合わさっていくのです。Anthropic のエンジニアリングガイドはこう表現しています。「Instead of building fragmented, custom-designed agents for each use case, anyone can now specialize their agents with composable capabilities.」（ユースケースごとに断片的でカスタム設計のエージェントを作る代わりに、誰もが組み合わせ可能な能力でエージェントを専門化できる、という意味です。） 5

基礎の先へ: 次に向かう先

これでコアとなるスキルセットは手に入りました。ここから先、探る価値のある方向をいくつか挙げます。

オプションのフロントマターフィールド

このコースで使ったのは name と description だけです。ほかにもあります: 6

  • model: このスキルを動かすモデル（より強い推論が必要なとき）
  • allowed-tools: スキルを特定のツールに制限する
  • disable-model-invocation: Claude による自動読み込みを止め、手動でのみ呼び出せるようにする

3 つのうち、model はモデルを選び、allowed-tools は権限の境界を引き、disable-model-invocation は自動トリガーをオフにして手動呼び出しだけを残します。

使いどころ:

  • コストのかかる操作（外部 API 呼び出し）→ disable-model-invocation で誤発火を防ぐ
  • 慎重な推論が必要なタスク → model: claude-opus-4
  • セキュリティに敏感なスキル → allowed-tools で触れる範囲を絞る

フィールドの全リストは公式ドキュメントにあります: https://code.claude.com/docs/en/skills[^S1]

スキル + MCP サーバー

MCP（Model Context Protocol）サーバーはツールを提供し、スキルはワークフローの知識を提供します。 7

たとえば:

  • MCP サーバーが read_database ツールを公開する
  • スキルが、そのツールを使って「月次レポートを生成する」ワークフローの進め方を Claude に教える

組み合わせると、スキルは Claude と外部システムをつなぐ橋になります。 7

コミュニティのスキル

ほかの人が作ったものを見るには:

他人のスキルを実行する前に:

  • SKILL.md 全体を読み、何をするかを理解する
  • 本番コードではなく、使い捨てのプロジェクトで試す
  • 危険なもの（スクリプト実行、ネットワークアクセス、ファイル変更）がないか確認する

まとめ

  • パーソナルスキル（~/.claude/skills/）は自分の習慣のため、プロジェクトスキル（.claude/skills/）はチームで働くためのもの 2
  • プロジェクトスキルは Git に入り、チームメイトが自動で受け取り、ほかのファイルと同じようにバージョン管理・ブランチ運用できる
  • チームのプラクティス: ドキュメント化する、命名を統一する、定期的に整理する、変更を通知する
  • スキルは組み合わせられる: 小さく単一目的のスキルが、より大きなワークフローへと組み合わさる 5
  • 次に向かう先: オプションのフロントマターフィールド、MCP サーバー連携、コミュニティのスキル

コースを修了しました

あなたは今、次のことができます:

  • ✅ スキルの仕組みと適用場面を説明する
  • ✅ 構造の整った SKILL.md を書く
  • ✅ 体系的なテストとデバッグのプロセスを回す
  • ✅ より込み入ったスキルを整理する
  • ✅ 共有スキルを健全に保つチームのプラクティスを実践する

次にやること:

  1. 今日スキルを 1 つ書く: 今週 3 回説明したタスクを選んで、スキルにする
  2. 1 週間使う: 何回呼び出したか、何が壊れたか、どれだけ時間を節約できたかを記録する
  3. 反復する: 見落としていたチェックを追加し、実際に起きたことに合わせて出力形式を調整する
  4. 共有する: 本当に役立つなら、プロジェクトスキルに昇格させる

忘れないでください: 良いスキルは一度書いて終わりではなく、使われることで形づくられていきます。 3 4

さあ、何度も説明し直してきたワークフローを、実際に作り始めましょう。

Footnotes

  1. Claude Code 公式ドキュメント: Extend Claude Code with skills — https://code.claude.com/docs/en/skills ↩ ↩2 ↩3

  2. Teach Claude Code your workflow: カスタム Skills 実践ガイド — https://medium.com/@n913239/teach-claude-code-your-workflow-a-hands-on-guide-to-custom-skills-8bc35d4a11ed ↩ ↩2 ↩3

  3. Claude Code skills: .NET ワークフローと再利用可能なプロンプト — https://codewithmukesh.com/blog/skills-claude-code/ ↩ ↩2 ↩3 ↩4

  4. 自己文書化された Runbook としての Claude skills — https://zackproser.com/blog/claude-skills-internal-training ↩ ↩2 ↩3

  5. Anthropic エンジニアリングブログ: Equipping agents for the real world with Agent Skills — https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills ↩ ↩2

  6. Claude Skills 徹底解説（第一原理の視点） — https://leehanchung.github.io/blogs/2025/10/26/claude-skills-deep-dive/ ↩

  7. The complete guide to building skills for Claude（PDF） — https://resources.anthropic.com/hubfs/The-Complete-Guide-to-Building-Skill-for-Claude.pdf ↩ ↩2

練習

01

今取り組んでいるプロジェクトを 1 つ選び、そこにプロジェクトスキルを追加してみましょう。

レベル1: 最初のプロジェクトスキルを作る
  1. プロジェクトディレクトリに .claude/skills/[skill-name]/ を作る
  2. そのプロジェクトに固有のスキルを書く（コミット形式、デプロイ手順、テスト生成など、合うもの）
  3. Git にコミットする
  4. プロジェクトの README にドキュメント化する
完了基準 · ローカルでチェック
02

チームメイトが新しいスキルを追加する PR を出しました。レビューを書きましょう。

レベル2: スキルの PR をレビューする

PR の内容:

少なくとも 3 つの問題を挙げて、レビューを書きましょう。

完了基準 · ローカルでチェック