SNIFFOUT
  1. TOP
  2. スニフアウトAIメディア
  3. Claude Code 導入支援
  4. Claude Code のスキルの作り方:SKILL.md の書き方から社内展開まで
GUIDE約 7 分

Claude Code のスキルの作り方:SKILL.md の書き方から社内展開まで

Claude Code のスキルは、業務の手順や型、判断の基準を SKILL.md に書いたフォルダです。説明文に何をするかと、いつ使うかを書き、決まった処理はスクリプトに任せ、依頼例で試してから、リポジトリやプラグインで社内に配ります。

目次
  1. スキルとは
  2. スキルにする業務の選び方
  3. SKILL.md の書き方
  4. 試して直す
  5. 社内に配る
  6. 配ったあとの管理
  7. スニフアウトのスキルの例

Claude Code のスキルは、業務の手順や資料の型、判断の基準を SKILL.md というファイルに書いて、フォルダにまとめたものです。作り方は、スキル名のフォルダを作り、SKILL.md に何をするスキルでいつ使うかの説明と手順を書き、決まった計算や変換はスクリプトに任せ、実際の依頼で試して直す、という流れです。社内に広げるときは、リポジトリにコミットするか、プラグインや管理設定、claude.ai の組織設定で配ります。

以下、仕様は 2026 年 11 月時点の公式ドキュメントで確かめた内容です。株式会社スニフアウト(以下、スニフアウト)が社内と支援の現場でスキルを作ってきたときの手順も合わせて書きます。

スキルとは

公式のClaude をスキルで拡張するのページは、同じ指示やチェックリスト、手順をチャットに何度も貼っているときや、CLAUDE.md の一部が事実ではなく手順になってきたときに、スキルを作るよう勧めています。スキルの本文は使うときだけ読み込まれるので、長い資料を入れても、必要になるまではほとんど負担になりません。

Claude Code のスキルは、Agent Skills というオープンな仕様に沿っています。以前のカスタムコマンド(.claude/commands/ のファイル)はスキルに統合され、今も動きます。新しく作るなら、補足のファイルを持てるスキルの形にします。

スニフアウトの営業資料では、スキルを業務マニュアルのファイルと説明しています。上手な人の頭の中にある手順を、誰が頼んでも同じように動くファイルにしておくものです。

起動したとき、依頼が説明に合ったとき、手順の中で必要なときの 3 つの時点で、スキルの名前と説明、本文、資料とスクリプトの結果が順に会話に入る様子

Claude は起動時にすべてのスキルの名前と説明だけを読み、依頼が説明に合ったときに本文を、手順の中で必要になったときに補足の資料を読みます(Agent Skills の公式解説)。公式の解説では、名前と説明は 1 スキルあたり約 100 トークン、本文は 5,000 トークン未満が目安で、補足のファイルは読むまで消費しません。スキルを数多く置いても、普段かかる負担が名前と説明の分で済むのはこのためです。

スキルにする業務の選び方

スニフアウトでは、スキルにする業務を 3 つに分けて考えています。

種類中身スキルの例
型資料や文書の決まった形自社デザインの提案書、議事録の整形、報告書の書式、メールの文面
手順業務の進め方と、決まった処理見積もりの積算、データの集計と分析、手順書づくり、問い合わせ対応
判断の基準何を見て、どう判定するか契約書の確認、表記と用語の統一、納品前の品質確認

最初の 1 本には、毎週か毎日発生し、手順を説明できる人が社内にいて、出来上がりを人が確認できる業務を選びます。公式ドキュメントも、同じ手順をチャットに 3 回貼ったらスキルにする、というきっかけを挙げています(Claude Code を拡張する)。

SKILL.md の書き方

手順は次のとおりです。

  1. 業務の上手な人に、手順と判断の基準を聞き取る。うまくいかない例も集める
  2. フォルダを作る。自分だけで試すなら ~/.claude/skills/<skill-name>/、チームで使うならリポジトリの .claude/skills/<skill-name>/。フォルダ名は半角の小文字とハイフンにする
  3. SKILL.md の先頭に、名前(name)と説明(description)を書く
  4. 本文に、手順と守ることを書く。長い資料は references/ に分ける
  5. 計算や形式の変換など、毎回同じ結果にしたい処理は scripts/ のプログラムにする
  6. 実際の依頼で試し、うまくいかなかった例から直す

広告の週次レポートを作るスキルなら、SKILL.md は次のようになります。

---
name: weekly-report
description: 広告の週次レポートを社内の型で作る。数値の集計は scripts/aggregate.py で行い、前週からの変化と次の打ち手を書く。週次レポート、週報、広告の振り返りを頼まれたときに使う。
---

## 手順
1. data/ にある今週と前週の CSV を確認する
2. python scripts/aggregate.py data/ を実行し、出力された数値だけを使う。数値を自分で計算しない
3. references/format.md の章立てに沿って書く
4. 変化の理由が数値から言えないときは、推測であると明記する

## 守ること
- 社名と商品名は references/glossary.md の表記にそろえる
- 送信はしない。reports/ に下書きとして保存する

書くときに気をつける点を、公式のガイドから拾います。

  • 説明文:何をするかと、いつ使うかの両方を書く。Claude はこの説明文で、どのスキルを使うかを決める。Anthropic のスキル作成のベストプラクティスは、説明文を三人称で書くよう勧めている
  • 名前:Agent Skills の仕様では、半角の小文字と数字とハイフンで 64 文字まで。フォルダ名と合わせる
  • 本文の長さ:500 行以内。超える分は references/ のファイルに分け、本文からどのファイルに何があるかを示す
  • 自由度:判断が要る部分は文章で方針を示し、間違えると困る部分はスクリプトで固定する

スクリプトに任せる理由は、正確さだけではありません。公式の解説によると、スクリプトのコードそのものは読み込まれず、実行結果だけが会話に入ります。Claude にその場で計算させるより、会話に入る量が少なく、結果も毎回そろいます。

SKILL.md の先頭には、ほかにも項目を書けます。よく使うのは次の 3 つです。

項目使う場面
disable-model-invocation: true送信やデプロイなど、人が /スキル名 で呼んだときだけ動かしたいスキル
user-invocable: false古いシステムの説明のように、Claude が背景知識として読むだけのスキル
allowed-toolsスキルを呼んだ回だけ、確認なしで使ってよいツールを指定する

試して直す

スキルが呼び出されたことと、期待どおりに仕事をしたことは別です。公式ドキュメントは、同じ依頼をスキルがある状態とない状態で、それぞれ新しいセッションで実行して比べる方法を勧めています。作った直後の会話には作成時の情報が残っていて、手順の書き漏れが隠れてしまうためです。個人やプロジェクトのスキルは、設定の skillOverrides で "off" にすると、ない状態を作れます。

Anthropic のベストプラクティスは、本文を書き込む前に少なくとも 3 つの評価用の依頼を作り、スキルなしの結果を基準にしてから必要な分だけ書く進め方を勧めています。比べる作業は、公式の skill-creator プラグインで自動にできます。依頼例ごとに独立した環境で実行し、スキルの有無で合格率や時間を比べ、説明文の当たり外れも測れます。

スニフアウトでも、社内のスキルには評価用の依頼例を持たせ、直すときは前と後を比べてから反映する決まりにしています。スキルは一度作ると多くの依頼で使われるので、1 か所の書き漏れが全員の仕上がりに出ます。

社内に配る

配る範囲は、スキルを置く場所で決まります。

個人、チーム、部門と全社の入れ子の範囲と、外側へ配るときに境目で確かめること

チームで使うなら、.claude/skills/ をリポジトリにコミットします。変更が履歴に残り、プルリクエストで中身を確かめてから入れられます。部門や全社に配るときは、次の 3 つから選びます。

方法向く場面
プラグインとマーケットプレイス複数のスキルやフック、MCP サーバーをまとめて配り、版を管理したい。プラグインのスキルは /プラグイン名:スキル名 で呼ぶ
管理設定のディレクトリ組織が管理する端末すべてに、同じスキルを置きたい
claude.ai の組織設定組織が有効にしたスキルを、社員のアカウントに同期したい。Claude Code のほか Cowork やクラウドのセッションでも使える

最後の方法は、開発者以外の社員にスキルを届けるときに役立ちます。Cowork は Claude Code と同じ仕組みで動く Claude デスクトップアプリの機能で、ターミナルを開かずに使えます(Cowork の公式解説)。非エンジニアへの広げ方は Claude Code を定着させる研修と運用で書きました。

配ったあとの管理

スキルは指示とコードで Claude を動かすので、配る前の確認と、配ったあとの管理が要ります。

  • 提供元を絞る:Anthropic の公式解説は、自作か Anthropic から入手したスキルだけを使い、そうでないものは同梱のファイルをすべて確かめるよう勧めている。組織では管理設定の strictKnownMarketplaces で、プラグインを入れてよい配布元を決める
  • 動く条件を絞る:外に送る、公開する、デプロイするスキルには disable-model-invocation: true を付け、人が呼んだときだけ動かす。個別に止めたいスキルは、権限の拒否ルールに Skill(deploy *) のように書く
  • 使われないスキルを外す:スキルの名前と説明は毎回の会話に入る。/skill-doctor で、使われていないスキルと負担の大きいスキルを確かめられる

権限ルールや管理設定の全体は Claude Code のセキュリティ設定にまとめています。

スニフアウトのスキルの例

スニフアウトでは、自社の資料デザインをスキルにしています。配色、ロゴ、ページの組み方、末尾に入れる会社紹介までを SKILL.md と補足のファイルに書き、スライドを組む処理と、文字のはみ出しを確かめる処理はスクリプトにしました。誰が頼んでも同じ見た目の資料ができ、デザインを変えるときはスキルを直すだけで全員に反映されます。

1 つのスキルは、ほかのエージェントでも使い回せます。たとえば見積もりの積算のスキルは、提案資料を作るエージェントからも、見積書を作るエージェントからも呼べます。業務をスキルに書き起こすことが、そのまま AI エージェントを作ることになる、というのが私たちの考えです。

業務の聞き取りから、スキルの設計と実装、評価、社内への配布までは、Claude Code 導入支援の伴走の中で一緒に進めています。

FAQ

よくある質問

スキルと CLAUDE.md はどう使い分けますか?
CLAUDE.md は毎回のセッションで必ず読まれるので、いつも守る事実やルールを書きます。複数の段階からなる手順や、特定の業務でしか使わない資料はスキルにします。スキルの本文は使うときだけ読み込まれるため、長い手順を書いても普段の負担になりません。
プログラミングができなくてもスキルは作れますか?
作れます。SKILL.md は Markdown の文章なので、業務の手順書を書く感覚で書けます。計算や形式の変換のように毎回同じ結果がほしい処理だけは、スクリプトにすると誤りが減ります。
作ったスキルが使われないときは、どこを直しますか?
まず説明文(description)に、利用者が実際に使う言葉が入っているかを確かめます。/スキル名 で直接呼び出して動くなら、説明文の書き方の問題です。呼び出せない場合は、フォルダ名や SKILL.md の書式を確認します。
社外で公開されているスキルを入れても安全ですか?
Anthropic は、自作したものか Anthropic から入手したものなど、信頼できる提供元のスキルだけを使うよう勧めています。スキルは指示とコードで Claude を動かすため、入れる前に SKILL.md とスクリプトをすべて読みます。組織では、入れてよい配布元を管理設定で絞れます。
Related Service

この記事に関連するサービス

Author津本 海株式会社スニフアウト 代表取締役CEO

東京大学大学院 複雑理工学専攻卒業。理論物理学・ヒューマンインターフェースを専門とし、大手化粧品メーカー・ゲーム会社で AI/機械学習の開発に従事。2022年11月に株式会社スニフアウトを創業。RAG と AI エージェントの解説書を執筆している。