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

レッスン1: スキルとは何か: なぜカスタムワークフローが必要なのか

学習目標:

  • スキルが解決する本質的な課題を理解する
  • どんな作業がスキルによる自動化に向いているかを見極める
  • スキルが動作する基本的な仕組みを理解する

前提: Claude Code の基本機能を使ったことがある | 次: レッスン2 >>

毎回まったく同じ手順を説明している

あなたは Claude Code を使って議事録を整理しています。こう入力します。「この会議の文字起こしを構造化されたポイントにまとめてください。決定事項、アクションアイテム、未解決の論点に分け、アクションアイテムにはそれぞれ担当者と期限のタグを付けてください。」

Claude はやってくれます。出力も良い出来です。

翌日、また別の会議があります。あなたは同じ指示をもう一度入力します。

3日目、4日目。会議のたびに同じ指示を出し直しています。Claude は毎回きちんとこなしてくれますが、毎回あなたは一から説明しなければなりません。1

これがスキルの解決する課題です。何度も説明を繰り返しているワークフローを、再利用できる指示としてパッケージ化する。一度書いておけば、必要なときにいつでも呼び出せます。2

スキルとは何か

スキルとは、Claude に特定の作業のやり方を伝える SKILL.md ファイルを含むディレクトリのことです。3

これは Claude に手渡す作業手順書のようなものだと考えてください。手順を明確に書き出しておけば、Claude はそれに従って作業します。もう説明を最初からやり直す必要はありません。4

たとえば、議事録整理スキルの中核部分は次のような形になります。

これを保存しておけば、/meeting-notes と会議の内容を入力するだけで、Claude はもう何をすべきか分かっています。1

どんな場面がスキルに向いているか

スキルに向いている場面には、3つの共通する特徴があります。

  1. 繰り返し性: 毎週、毎日、ときには毎時間、同じことをしている
  2. 手順が固定されている: そのつど変わるのではなく、明確な手順として書き出せる
  3. 検証できる: Claude が正しくできたかどうかを判断できる

典型的に向いている例:

  • コードレビュー（チームの規約に照らして作業を確認する）
  • ドキュメントの形式変換（Markdown を Word に変換し、特定の書式を保つ）
  • ログ解析（エラーログから意味のある情報を抽出する）
  • テストケースの生成（機能の説明をテストシナリオに変える）
  • コミットメッセージの正規化（そっけないコミットをチームで合意した形式に書き直す）

スキルに向いていない場面:

  • 一度きりの作業（「このページのレイアウトを設計するのを手伝って」など）
  • 毎回、人間の判断を多く必要とする作業
  • 完全に自由度の高い創造的な作業

スキルの仕組み

スキルを作るとき、あなたは実際には2つのことをしています。5

  1. YAML フロントマターを書く（ファイル先頭の --- で囲まれた部分）。ここでこのスキルの名前と、いつ使うかを Claude に伝えます
  2. Markdown の指示を書く（フロントマターの後ろの本文）。ここでこの作業をどう進めるかを Claude に具体的に伝えます

使い方は2通りあります。

  • 手動で呼び出す: /meeting-notes と入力すると、Claude はそのスキルの指示を読み込んで実行します
  • 自動でトリガーする: 「この議事録を整理して」と言うと、Claude は各スキルの description を読み、meeting-notes スキルが関連すると判断して、自分から読み込みます6

自動トリガーは、description がうまく書けている場合にしか機能しません。これはレッスン2で詳しく扱います。

スキルの置き場所

置き場所は2つあります。1

  • パーソナルスキル: ~/.claude/skills/ — 自分専用で、どのプロジェクトでも使えます
  • プロジェクトスキル: .claude/skills/ — プロジェクトディレクトリに置かれるので、チームメンバーがリポジトリをクローンすると一緒に手に入ります

最初のスキルは、パーソナルスキルから始めましょう。いくつか書いてみて実際に役立つと確認できたら、よく使うものをプロジェクトディレクトリに移し、チームで共有できるようにします。

まとめ

  • スキルは繰り返されるワークフローを再利用できる指示としてパッケージ化するので、毎回説明し直す必要がなくなる
  • スキルに向いている場面: 繰り返し性、手順が固定、結果を検証できる
  • スキルとはディレクトリと SKILL.md ファイルのことで、YAML フロントマターと Markdown の指示を含む
  • 使い方は2通り: 手動で呼び出す（/skill-name）か、自動でトリガーする（Claude が description から判断する）
  • 置き場所は2つ: パーソナルスキル（~/.claude/skills/）とプロジェクトスキル（.claude/skills/）

次のレッスンでは、実際の SKILL.md ファイルを分解し、それぞれの部分が何をしているのかを見ていきます。

レッスン2 >>

Footnotes

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

  2. Anthropic プラットフォームドキュメント: Agent Skills overview — https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview ↩

  3. Anthropic ヘルプセンター: How to create custom skills — https://support.claude.com/en/articles/12512198-how-to-create-custom-skills ↩

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

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

  6. Building skills for Claude, ハンズオン: YAML frontmatter とテスト — https://sjramblings.io/building-skills-for-claude-part-2/ ↩

練習

01

この1週間の自分の仕事を振り返り、Claude に少なくとも3回は説明した作業を1つ見つけてください。

レベル1: 最初のスキル候補を見つける

次のことを書き出しましょう。

  1. その作業は何か?
  2. 手順は固定されているか?
  3. Claude が正しくできたかどうかを判断できるか?
完了基準 · ローカルでチェック