Claude Codeの「スキル」とは？カスタムスラッシュコマンドの作り方から活用事例まで徹底解説

Claude Codeのスキルとは、「こういう作業が来たら、この手順で処理してね」というマニュアルをマークダウンファイル1枚で定義し、/コマンド名 で即座に呼び出せる仕組みです。2026年5月時点でAgent Skillsはオープン規格（agentskills.io）として標準化され、Claude Codeだけでなく GitHub Copilot・Codex CLI・Gemini CLIなど20以上のAIエージェントが同一フォーマットに対応しています。本記事では、そもそもスキルとは何かの概念から、実際の作り方、現場の成功・失敗事例まで一気通貫で解説します。

そもそも「スキル」とは何か——新人へのマニュアルに喩えると

スキルを理解する最もわかりやすい喩えは、新入社員へのオンボーディングガイドです（Zenn解説記事）。

あなたがチームに新人を迎えたとき、こんなドキュメントを用意するはずです。

• 業務名: 「会議の議事録まとめ」
• いつやるか: 会議のたびに（週3〜5回）
• 手順: ①文字起こしファイルを読む → ②決定事項を抜き出す → ③宿題と担当者を整理 → ④Markdownで保存
• 注意点: 発言者名の表記ルール、社外共有NGの議題は除外

スキルはこれをそのまま SKILL.md というマークダウンファイルに書くだけです。Claude Codeはこのファイルを読んで、あたかも業務マニュアルを渡された新人のように、指示された手順を自律的に実行します。

スキルとプロンプトの違い

「毎回プロンプトで指示すればいいのでは？」——正直、1回だけならそれでOKです。しかし以下の場面で差が出ます。

議事録作成をスキル化した事例では、毎回のプロンプト入力が不要になっただけでなく、議事録の品質が均質化されたと報告されています（note.com公開事例）。

スキルの仕組み——Progressive Disclosureという設計思想

スキルの内部動作は、段階的な情報開示（Progressive Disclosure）という設計思想で成り立っています。

レベル1（常時読み込み）: フロントマターの name と description だけをClaude Codeが確認。「このスキル、今の会話に関係ありそうか？」を判定する

レベル2（スキル起動時のみ）: SKILL.md の本文をロード。具体的な手順・制約・出力フォーマットを読む

レベル3（必要な時だけ）: references/ フォルダ内の補助ファイル（サンプルデータ、テンプレートなど）にアクセス

この3段階構成のおかげで、スキルを何十個インストールしても普段のトークン消費は最小限に抑えられます。ただし後述するように、スキルを増やしすぎるとレベル1の読み込みだけでもコストが蓄積する点には注意が必要です。

実際にスキルを作ってみる——5分で完成する最初のスキル

ディレクトリ構成

.claude/skills/
└── meeting-summary/
    └── SKILL.md

個人用なら ~/.claude/skills/ に、チームで共有するならプロジェクトルートの .claude/skills/ に配置します。

SKILL.mdの書き方

---
name: meeting-summary
description: 会議の文字起こしから議事録を自動生成する。決定事項・宿題・次回アクションを抽出し、Markdown形式で保存する。
---

## 手順

1. 指定された文字起こしファイル（.txt / .md）を読み込む
2. 会議の結論・決定事項を箇条書きで抽出する
3. 宿題（TODO）を担当者・期限つきでリストアップする
4. 次回会議までのアクションアイテムをまとめる
5. 議事録をMarkdown形式で `meeting-notes/` に保存する

## 出力フォーマット

- ファイル名: `meeting_YYYY-MM-DD_会議名.md`
- セクション: 参加者 → 決定事項 → 宿題一覧 → 次回アクション

これだけです。Claude Codeを再起動すると /meeting-summary コマンドが使えるようになります。

フロントマターの重要オプション

description はスキルの「名刺」です。Claude Codeはここを見て「今の会話にこのスキルが使えそうか」を判定するので、具体的なキーワードを含めるのがコツです（Zenn解説記事）。

Claudeにスキルを作ってもらう——対話で完成させる流れ

実は、SKILL.mdを自分でゼロから書く必要はありません。Claude Codeに「スキルを作って」と頼めば、対話しながら完成させることができます。実際の流れを見てみましょう。

ステップ1：やりたいことを日本語で伝える

Claude Codeを開いて、こう入力するだけです。

会議の文字起こしファイルを読み込んで、決定事項・宿題・次回アクションを抽出する議事録スキルを作って

Claude Codeは「文字起こしファイルの形式は？」「出力に参加者名を含めますか？」といった確認を返してきます。プログラミングの知識は不要で、業務手順を日本語で説明できれば十分です。

ステップ2：Claudeが SKILL.md を自動生成する

やり取りを数回繰り返すと、Claude Codeが .claude/skills/meeting-summary/SKILL.md を自動生成します。フロントマターの name や description も適切に設定してくれるため、手動で書くよりも漏れが少なくなります。

ステップ3：スラッシュコマンドで実行・調整する

生成されたスキルを /meeting-summary で実行してみます。出力が期待と違えば「宿題に期限カラムも追加して」のように追加指示するだけで、SKILL.mdが更新されます。

この**「伝える → 生成 → 試す → 直す」のサイクルを回せる**のが、Claude Codeでスキルを作る最大の利点です。

ONIならもっと簡単——GUIでスキルの作成・実行・共有が完結

Claude Code（CLI）でのスキル作成は強力ですが、ターミナルに慣れていない人にはハードルがあります。ONIのデスクトップアプリなら、同じことがGUIで完結します。

GUIでスキルを作成する

ONIアプリのサイドバーから「スキル」ページを開き、「＋新規作成」ボタンをクリック。スキル名（例: meeting-summary）・説明文・手順の3つを入力するだけで、SKILL.mdが自動生成されます。マークダウンの書き方を知らなくても問題ありません。

ONIのチャットからもスキルを作れる

ONIのチャット画面でClaudeに「スキルを作って」と日本語で指示すれば、やり取りを通じてSKILL.mdが生成されます。CLI版と同じ対話フローを、使い慣れたチャットUIで実行できるのがポイントです。

ワンクリックで実行・おすすめスキルもインストール可能

作成したスキルはONIのスキル一覧に即座に反映され、「▶ 実行」ボタンで起動できます。さらに「おすすめ」タブには、Web分析・コードレビュー・レポート生成などすぐに使えるスキルがワンクリックでインストール可能。ゼロから作らなくても始められます。

ONIがスキル管理で解決する3つの課題

• 環境構築の壁をゼロにする: ターミナル不要。ダウンロード→ログイン→すぐ使える
• 3つのAIエージェントに自動同期: ONIで作ったスキルはClaude Code・Codex CLI・Gemini CLIのディレクトリに自動配置される
• チームで共有できる: ONIの管理画面からスキルを公開すれば、チームメンバー全員が同じスキルをインストール可能

やってはいけないこと

• 最初から完璧を目指す: 最初は最小限の手順だけ書いて、使いながら育てるのが正解
• 手順を曖昧にする: 「いい感じにまとめて」ではなく「セクション: 参加者 → 決定事項 → 宿題一覧 → 次回アクション」のように具体的に書く
• スキルを増やしすぎる: 後述する失敗事例のとおり、63個入れるとコンテキストの33%が消える

現場のリアル——スキル活用の成功と失敗

成功事例①：スキルの「異種間共有」が実現した

あるクリエイターが、Claude Codeで作成したスキルをOpenAI Codexでそのまま動かせるかを検証しました。結果は「かなり実用的」。SKILL.mdのフォーマットがAgent Skillsのオープン規格に準拠しているため、移植ではなく共有で済んだのです（note.com公開事例）。

これが意味するのは、一度スキルを作れば複数のAIエージェントで使い回せるということ。ベンダーロックインを気にせず、「スキル資産」を蓄積できる時代が来ています。

成功事例②：請求書確認4.5時間→35分に

ある企業では、請求書確認の作業をClaude Codeのスキルで自動化し、4.5時間かかっていた作業を35分に短縮しました（87%削減）。スキルにはPDFの読み込み→金額照合→差分レポート出力の手順が定義されており、人間は最終確認だけを行う運用に切り替わっています（Uravation調査）。

この種の定型チェック業務は、ONIのワークフロー機能とClaude連携を組み合わせることで、スキルの呼び出し自体もスケジュール自動化が可能です。

失敗事例①：スキルを63個入れたらコンテキストの33%が消えた

スキルのインストールし過ぎは実害を生みます。フロントマターの description 読み込みだけでも1スキルあたり約109文字のXMLオーバーヘッドが発生し、63個のスキルを入れた環境ではコンテキストウィンドウの33%が隠れたという報告があります（Zenn設計ガイド）。

対策はシンプルで、本当に使うスキルだけを残すこと。個人用スキルは ~/.claude/skills/ に集約し、プロジェクト固有のものだけをリポジトリに入れる使い分けが推奨されています。

失敗事例②：環境設定で詰んでスキルが使えない

「ダウンロードってどこから？」「ファイルをどこに置けばいい？」——スキル機能にたどり着く前の環境構築で挫折するケースも少なくありません（note.com公開事例）。特にデスクトップ版ではスラッシュコマンドが表示されない不具合が報告されており、CLI版の方が確実に動作するのが2026年5月時点の実情です。

また、スキルの自動起動が期待通りに動かないケースも頻発しています。呼ばれるべき場面で起動しない（Undertriggering）場合は description にキーワードを追加、逆に呼ばれすぎる（Overtriggering）場合は「Do NOT use for 〜」のネガティブ条件を加えるチューニングが有効です。

旧形式（カスタムスラッシュコマンド）からの移行

以前は .claude/commands/xxx.md 形式で「カスタムスラッシュコマンド」を作る方法が主流でした。2026年にこの機能はスキルに統合され、どちらの形式でも同じ /xxx コマンドとして動作します（Zenn解説記事）。

移行のポイントは3つ。

1. 急ぐ必要はない: 旧形式も引き続きサポートされている
2. 新規作成はスキル形式推奨: .claude/skills/xxx/SKILL.md なら補助ファイルも同梱できる
3. 同名が存在する場合、スキルが優先: commands/review.md と skills/review/SKILL.md が両方あると後者が使われる

スキルをさらに強力にする3つのテクニック

1. スクリプトとの組み合わせ

SKILL.mdに「この手順で scripts/analyze.py を実行してください」と書けば、Claude Codeがスクリプトを呼び出して結果を解釈します。SharePointからのファイルダウンロード、Excelのパース、APIへのリクエストなど、マークダウンだけでは表現できない処理を組み合わせられます（Zenn実装例）。

2. チーム配布はGit管理で

.claude/skills/ をリポジトリに含めてGit管理すれば、チーム全員が git pull するだけで最新のスキルが手に入ります。コードレビューの基準、デプロイ手順、障害対応のチェックリスト——属人化しがちなナレッジをスキルとして標準化できるのは、ONIのようなチーム向けAIワークフロー基盤と相性が良いアプローチです。

3. disable-model-invocation: true の使い分け

データベースへの書き込みやファイルの削除など副作用のある処理は、自動起動されると困ります。フロントマターに disable-model-invocation: true を設定すれば、ユーザーが明示的に /xxx を打った時だけ起動する安全設計になります。

Agent Skills——ベンダーを超えたオープン規格

2025年12月にAnthropicがオープンスタンダードとして公開したAgent Skillsは、SKILL.mdフォーマットをAIエージェント間の共通言語にする試みです（GitHub Copilot公式ドキュメント）。

2026年5月時点で対応が確認されているツール:

「Claude Codeで作ったスキルが、Codexでもそのまま動く」——この互換性は、特定のツールにロックインされたくないチームにとって大きな意味を持ちます。

まとめ——スキルは「AIへの委任状」である

スキルの本質は、テクニカルな設定ファイルではなく、「この業務をこの品質で処理してよい」という委任状です。委任の範囲が曖昧なら出力もブレる。逆に、手順と判断基準を明確に書けば、AIは驚くほど忠実に動きます。

実践から見えた3つの原則:

1. 小さく作って育てる: 最初から完璧なスキルを目指さず、最小限で動かして徐々に改善する
2. 量より質: 63個入れてコンテキストを圧迫するより、本当に使う10個を磨き込む
3. チームで共有する: スキルの価値は「自分だけの便利ツール」から「チームの標準業務手順」になった瞬間に跳ね上がる

Claude Codeのスキルは、AIエージェント時代の業務マニュアルの新しい形です。まずは1つ、自分が毎週繰り返している作業をSKILL.mdに書き出すところから始めてみてください。

出典・参考リンク

• Claude Code公式ドキュメント — スキルで Claude を拡張する
• Claude CodeのSkillsを作成例から徹底理解する（Zenn）
• カスタムスラッシュコマンドがスキルに統合されました（Zenn）
• Claude Codeのスキル、Codexでもそのまま使えた話（note.com）
• Claude Skillsで売上分析レポートを均質化してみた（note.com）
• Claude Codeの環境設定で詰んでスキル活用を諦めかけているあなたへ（note.com）
• Claudeに専門知識を持たせる！Skillsの仕組みと利用方法を解説（CyberAgent）
• Agent Skills設計ガイド — トークン予算・ネスト発見・compaction対策（Zenn）
• 部署別・業種別で進むClaude Code活用事例10選（Uravation）
• GitHub Copilot — About Agent Skills（GitHub Docs）