同じ指示をチャットに何度も貼り付けていませんか。デプロイのチェックリスト、ブランドボイスのガイドライン、「変更点を要約して」というプロンプト——これを繰り返している時点で、あなたはすでに単純なプロンプティングを卒業しています。その解決策が Claude Code の agent skills です。スキルとは SKILL.md ファイルを含むフォルダで、再利用可能なワークフローをパッケージ化し、Claude が必要なときにオンデマンドで読み込みます。これにより、AIは反復的な作業を毎回同じ手順でこなせるようになります——セッションをまたいでも、チーム全体でも同じ品質で。
本記事では、スキルとは何か、プロンプトとどう違うのか、Claude Code と Codex がそれをどう使うのかを解説し、さらにコピペで使えるスキル集と安全性チェックリストをお渡しします。読者として想定しているのは2種類——ノーコードで自社の業務を自動化したいAI起業家と、本番コードを出荷する開発者です。バイブコーディングの実践から本格的なAIコーディングまで、両方の視点で書いています。
Claude Code の agent skills とは何か
スキルとは SKILL.md ファイルを含むディレクトリです。最小構成は、description を含むYAMLフロントマターと、いくつかのMarkdown形式の指示文だけです。
---
description: Summarize what changed in the working tree as 2-3 plain-English bullets and flag anything risky.
---
Run `git diff HEAD`. Summarize the changes in 2-3 bullet points a non-technical
person could follow. Call out anything that could break the app or expose secrets.
これをフォルダに入れるだけで、Claude はそれを自分のツールキットに追加します。公式ドキュメントは端的にこう述べています——「スキルは Claude にできることを拡張します。指示を書いた SKILL.md ファイルを作成すれば、Claude はそれをツールキットに追加します」。スキルを書くべきタイミングは「同じ指示、チェックリスト、複数ステップの手順をチャットに繰り返し貼り付けているとき」です。
スキルがバンドルできるのはテキストだけではありません。テンプレート、出力例、参照ドキュメント、そして任意の言語で書かれた実行可能なスクリプトまで含められます。SKILL.md 本体は500行未満に保ち、詳細は別ファイルに切り出しましょう——そうすればスキルの読み込みコストが安く済みます。
スキルは、誰が使えるかを決める4つのスコープに存在します。
- Personal（個人） —
~/.claude/skills/<name>/SKILL.md。すべてのプロジェクトで利用可能。 - Project（プロジェクト） —
.claude/skills/<name>/SKILL.md。リポジトリにコミットすればチーム全員が使えます。 - Plugin（プラグイン） —
<plugin>/skills/<name>/。プラグイン経由で配布。 - Enterprise（エンタープライズ） — 設定経由で管理。
優先順位は enterprise > personal > project の順で、いずれのレベルも同名のバンドル済みスキルを上書きします。
Claude Code の agent skills とプロンプトの違い
プロンプトとは、一度入力したら消えてしまうものです。一方スキルは、同じ指示を保存し、名前を付け、関連するときに自動で読み込むものです。実務上、重要な違いは3つあります。
段階的開示（Progressive disclosure）。 Anthropic のエンジニアリングチームは、スキルを「新しく入社した社員のためのオンボーディングガイド」にたとえています。3つの層が順番に読み込まれます——(1) スキルの名前と説明があらかじめ読み込まれ、Claude がいつそれに手を伸ばすべきかを把握する。(2) リクエストが一致したときにのみ SKILL.md 全体が読み込まれる。(3) バンドルされた参照ファイルは実際に必要になったときにのみ読み込まれる。ドキュメントが述べる通り「長い参照資料は、必要になるまでほとんどコストがかかりません」。5,000語のプロンプトをチャットに貼り付ければ毎ターンごとにトークンを消費しますが、スキルは発火するまでほぼゼロコストです。
スキルはコードを実行し、ファイルを出荷できる。 プロンプトはテキストしか生み出しません。スキルは Python スクリプトをバンドルできます——Anthropic の代表的な例はPDFフォームへの記入で、これは単なるテキスト生成では不可能な作業です。
2通りの呼び出し方と、その制御。 Claude はリクエストが description に一致するとスキルを自動読み込みするか、あるいは /skill-name と直接入力して呼び出します。フロントマターがハンドルの役割を果たします——disable-model-invocation: true は人間だけが起動できることを意味し（/deploy や /commit に使ってください。コードが完成して見えるからといってClaudeに勝手に出荷を判断されては困ります）、user-invocable: false は Claude だけが起動できることを意味します（参照すべきだが手動では呼ばない背景知識向け）。
Claude Code はスキルをどう使うか
Claude Code は最初からスキルを内蔵しています——/code-review、/debug、/run、/verify、/loop、/batch、/claude-api など。なかでも run/verify のペアは、テストスイートだけでなく実際に動いているアプリに対して変更が機能するかを確認するため、あなたのアプリを起動します。
再利用可能なワークフローが組み上がるのは、フロントマターの部分です。
allowed-toolsは特定のツール（例:Bash(git add *)）を事前承認し、Claude が作業の途中で許可を求めて止まらないようにします。context: forkはスキルを隔離されたサブエージェントで実行し、agent: Exploreはサブエージェントの種類を選びます。pathsはスキルを一致するファイルに限定し、modelとeffortはスキルごとにモデルを上書きします。- 動的コンテキスト注入:
!`git diff HEAD`のような行はシェルコマンドを実行し、Claude が残りのスキルを読む前にその出力をインラインで埋め込みます。
知っておく価値のある詳細が一つ——カスタムコマンドとスキルは統合されました。.claude/commands/deploy.md と .claude/skills/deploy/SKILL.md はどちらも /deploy を生成します。古いコマンドファイルも引き続き動作します。スキルはそこに、サポートファイル用のディレクトリ、フロントマターによる制御、自動読み込みを上乗せするだけです。
スキルが実際に役立っているかどうかも確認できます。skill-creator プラグイン（/plugin install skill-creator@claude-plugins-official でインストール）はA/B評価を実行します——テストケースを保存し、ケースごとにサブエージェントを起動し、出力を採点し、スキルあり/なしを合格率・トークン・時間で比較します。これにより「スキルが発火した」ことと「スキルが役立った」ことを混同せずに済みます。
Codex はスキルをどう使うか
スキルはもはやAnthropic独自のアイデアではありません——このフォーマットは移植可能な標準になりつつあります。agentskills.io でオープン標準として公開されており（2025年12月18日リリース）、同じ SKILL.md が Claude.ai、Claude Code、Claude Agent SDK、Claude Developer Platform をまたいで動作します。
OpenAI Codex は2025年12月に同じ SKILL.md ディレクトリフォーマットを採用しました。その目玉機能がレコード・アンド・リプレイです——Codex はあなたがワークフローを一度実行する様子を観察し、そのスキルを下書きしてくれます。手順を文章で書くより実演したい人には便利です。Codex は独自の $skill-creator も搭載し、CLI（オープンソース、Rust製）、IDE拡張、サブエージェント付きのクラウドにまたがって動作します。
このトレンドを締めくくる3つ目の例——Nous Research の Hermes Agent（オープンソース、MITライセンス。あのファッションブランドではなく、AIエージェントの方です）は「あなたとともに成長するエージェント」を謳います。これは「あなたのプロジェクトを学習し、スキルを自動生成し、問題をどう解決したかを決して忘れない」と述べ、永続的なメモリと隔離されたサブエージェントを備えています。要点はこうです——SKILL.md はツール横断の標準へと収束しつつあり、今日エンコードしたワークフローは、あなたとともにツールを越えて持ち運べるのです。
サンプルのスキルライブラリ
盗む価値のあるスキルを4つ。いずれも一次情報のドキュメントから引いています。
summarize-changes— ライブのgit diff HEADを注入し、Claude に2〜3個のわかりやすい箇条書きを生成させ、リスクを指摘させます。技術に詳しくないAI起業家が「何を変更したっけ?」と尋ねれば、gitを学ばずとも読みやすいレビューが返ってきます。これはドキュメント自身の最初のチュートリアルです。fill-pdf— Python スクリプトをバンドルし、Claude にPDFフォーム（契約書、申請書、受付フォーム）を記入させます。Anthropic の代表例であり、スキルがチャットのプロンプトにはできないことをこなせる最も明快な証拠です。deploy—disable-model-invocation: trueを設定し、テストスイート → ビルド → プッシュ → 検証 のシーケンスを、人間が/deployと入力したときにだけ実行させます。あなたのリリース手順書をエンコードしたもので、AIは自らの判断で出荷できません。visualize-codebase— リポジトリのインタラクティブなHTMLツリーを生成する Python スクリプトをバンドルします。「このコードベースを可視化して」と頼めば閲覧可能なマップが得られます——起業家が見慣れないコードを引き継いだときに便利です。
ノーコードのAI起業家向けユースケース
ここで価値を得るのにコードを書く必要はありません。「バイブコーディング（vibe coding）」——AIにやりたいことを伝えるだけでアプリを作る手法を指す、いまや英語圏の辞書（Merriam-Webster）にも収録された言葉——は、まさにこの層を表しています。スキルは、その場限りで繰り返してきたプロンプトを、信頼できる一つの /command に変え、「うちではこうやる」というやり方をエンコードします。これによりAIはセッションをまたいでも、チームメンバー間でも一貫性を保ちます。
たとえば日本のスタートアップであれば、毎週の投資家向け報告や、業務委託契約書のひな形記入といった「定型なのに手間がかかる作業」こそ、スキル化の効果が大きい領域です。
構築する価値のある起業家向けスキル:
- ブランドボイス（
user-invocable: false）— あなたのトーン、禁止フレーズ、ポジショニング。Claude が顧客向けのコピーを書くたびに自動で読み込まれます。 - 週次の投資家向けアップデート — テンプレートと抽出すべき指標。毎週ドラフトが一貫します。
- 顧客受付 / 契約書PDF —
fill-pdfパターンを、実際に業務で触れるフォームに適用したもの。 - 差分からのリリースノート —
summarize-changesを、顧客が読める変更履歴の生成に向け直したもの。
原則はこうです——CLAUDE.md のあるセクションが事実から複数ステップの手順へと成長したら、それをスキルに移し、毎回の会話に課税する代わりにオンデマンドで読み込ませましょう。
開発者向けユースケース
- 自社ルールでのコードレビュー —
/code-reviewを、チームが実際に守らせているパターンで拡張します。 - ワンコマンドのリリース — 前述の
/deploy手順書に、allowed-toolsで安全なgitステップを事前承認させたもの。 - 隔離された調査 —
context: forkとagent: Exploreを組み合わせ、メインのコンテキストを汚さずにサブエージェントでバグを調査します。 - パススコープの規約 —
pathsにより、マイグレーション用スキルがマイグレーションディレクトリ内でのみ有効化されるようにします。 - 評価駆動の反復 —
skill-creatorで、スキルが実際に合格率を動かすかをリポジトリにコミットする前に確認します。
安全性とレビューのチェックリスト
スキルは本物のツールで動作するため、コードと同じようにレビューしてください。
- ワークスペースを信頼する前にプロジェクトスキルを監査する。 コミット済みのスキルは、自らに広範な
allowed-toolsを付与できます。ワークスペース信頼ダイアログを承認する前にレビューしましょう。 - 副作用にゲートを設ける。 デプロイ、Slack送信、金銭に触れるものはすべて
disable-model-invocation: trueを付けます。 - 発火のために
descriptionを書く。 説明が弱いとスキルは発火しません。人々が実際に口にする言葉を使い、「どんなスキルが使える?」または/doctorで検証しましょう。 SKILL.mdを軽く保つ。 一度呼び出されると、その内容はそのセッション中コンテキストに残り、再読込されません——肥大化は継続的なトークンコストになります。詳細はサポートファイルへ。- スキルの予算に気を配る。 説明には上限があります（各1,536文字、セット全体でコンテキストウィンドウのおよそ1%が予算）。冗長なスキルが多すぎると切り詰められ、使用頻度の低いものが削られます。
skillOverrides: "name-only"で領域を取り戻せます。 - 「発火した」を「機能した」と混同しない。
skill-creatorでベースラインのA/B評価を実行しましょう。
よくある質問（FAQ）
Claude Code のスキルを使うにはコーディングの知識が必要ですか? いいえ。スキルはわかりやすい指示を書いたMarkdownファイルです。起業家はこれを使ってコピー、レポート、フォーム記入を標準化しています。複雑さが入り込むのはスクリプトをバンドルするときだけで、それも公式のオープンソーススキルに頼れます。
スキルとカスタムコマンドの違いは何ですか?
両者は統合されました。.claude/commands/deploy.md と .claude/skills/deploy/SKILL.md はどちらも /deploy を作り、古いコマンドファイルも引き続き動作します。スキルはサポートファイル用ディレクトリ、フロントマターによる制御、自動読み込みを追加します。
Claude は確認なしに私のスキルを実行してしまいますか?
あなたが許可した場合だけです。Claude はリクエストが description に一致するとスキルを自動読み込みします。disable-model-invocation: true を設定すれば、人間がコマンドを入力することを必須にできます——デプロイ、コミット、そして送信や支出を伴うあらゆる操作に不可欠です。
Claude Code のスキルは他のAIツールでも動きますか?
ますます動くようになっています。SKILL.md はオープン標準です（agentskills.io、2025年12月）。OpenAI Codex はレコード・アンド・リプレイモードとともに同じフォーマットを使い、Nous Research の Hermes Agent も同じ形でスキルを自動生成します。
スキルは CLAUDE.md を編集するのと何が違うのですか?
CLAUDE.md は常時オンのコンテキストです——そこにあるすべての事実が毎ターンごとにトークンを消費します。スキルは説明が一致したときにのみ読み込まれるため、毎回の会話には必要のない複数ステップの手順を置く場所として最適です。
Boostor の関連記事: Claude Code のスラッシュコマンドとスキル：同じプロンプトを何度も書くのをやめよう · ビジネス向けAIエージェント:今週ローンチできる25のAI自動化ワークフロー · 非エンジニア創業者のためのバイブコーディング実践ガイド