SKILL.mdとは。Claudeのスキルの書き方と、作ったスキルを社内に配る手順

SKILL.mdは、Claudeのスキルの中身を書くファイルです。
先頭にスキルの名前（name）と説明（description）を書き、その下に、Claudeにしてほしい手順と決まりを書きます。

できたファイルはスキルの名前のフォルダに入れ、ClaudeのアプリならZIPにしてアップロード、Claude Codeなら決まった場所に置けば使えるようになります。
いちばん手間をかけたいのはdescriptionで、Claudeはこの数行を読んで、そのスキルを使うかどうかを決めます。

SKILL.mdとは、スキルの名前と手順を書いたファイル

Claudeのスキルは、繰り返す仕事の手順や社内の決まりをまとめておき、Claudeに必要なときだけ読ませる仕組みです。
そのスキルの中心にあるのが、SKILL.mdという1つのファイルです。

いちばん小さいSKILL.mdは、次のような形です（スキルを作るときに、この形を写して埋めていきます）。

---
name: スキルの名前（英小文字とハイフン）
description: 何をするスキルか。どんなときに使うか。
---
ここに、Claudeにしてほしい手順と決まりを書く

「---」で挟んだ先頭の部分には、nameとdescriptionの2つを必ず書きます。
その下の本文は、Claudeへのプロンプトとほぼ同じで、普通の文章と箇条書きで書けます。

Claudeの開発者向けの説明によると、Claudeは最初にすべてのスキルのnameとdescriptionだけを読み込みます。
本文を読むのは、頼まれた仕事がdescriptionに合ったときだけです。
そのため、スキルをたくさん入れておいても、使わないスキルの本文で会話が重くなることはありません。

SKILL.mdの書き方の例

例えば、会議の文字起こしから社内の形式で議事録を作るスキルなら、SKILL.mdは次のように書けます。

---
name: meeting-minutes
description: 会議の文字起こしやメモから、社内の形式（決定事項・宿題・保留）で議事録を作る。議事録の作成、会議メモの整理、文字起こしのまとめを頼まれたときに使う。
---
# 議事録の作り方
手順
1. 文字起こしを読み、決まったこと・宿題・決まらなかったことに分ける
2. template.md の欄の順に書く
3. 担当や期限が読み取れない宿題は「未定」と書く
決まり
- 文字起こしに書かれている内容だけを使う
- 決定事項と宿題は1件1行にする

本文に書くのは、人に仕事を頼むときに毎回口で伝えている内容です。
手順は番号つきで並べ、守ってほしい決まりは箇条書きにしておくと、Claudeが取りこぼしにくくなります。

本文の書き方は、プロンプトの書き方とほとんど変わりません。
目的・材料・出してほしい形を具体的に書くコツは、全社共通のプロンプト作法を決める。押さえるべき7つの基本にまとめています。

とはいえ、最初の1回で思いどおりに動くとは限りません。
まずは短く書いて実際の仕事で使い、Claudeが迷った所や外した所を本文に足していくと、だんだん手のかからないスキルになります。

descriptionの書き方

「スキルを入れたのに、Claudeが使ってくれないのはなぜか？」という声が上がります。
多くの場合、原因はdescriptionにあります。

開発者向けの書き方のガイドでは、descriptionには「何をするスキルか」と「どんなときに使うか」の両方を書くよう求めています。
「書類を扱う」「データを処理する」のようなあいまいな説明は、避ける例として挙げられています。

一言でいうと、社員が実際に頼むときの言葉を、descriptionにそのまま入れておきます。
上の例なら「議事録」「会議メモ」「文字起こし」が、Claudeが当てにする手がかりになります。

決まりは、次のとおりです。
nameは64文字までで、英小文字・数字・ハイフンだけを使い、「claude」「anthropic」という語は入れられません。

descriptionの長さの上限は、使う場所で違います。
Claudeのヘルプではdescriptionは200文字まで、開発者向けの説明では1,024文字までとされています。
当社では、どこで使っても読み込めるように、descriptionを200文字以内に収めることをおすすめします。

本文を長くしすぎないフォルダの分け方

手順が増えてくると、SKILL.mdが長くなります。
書き方のガイドでは、SKILL.mdの本文は500行以内を目安にし、細かい資料は別のファイルに分けるよう書かれています。

分けたときのフォルダは、次のような形になります（どのファイルが何のためにあるかを示した例です）。

meeting-minutes/
├── SKILL.md … 名前・説明・手順（必ず置く）
├── template.md … 議事録のひな形（使うときだけ読まれる）
└── scripts/ … 決まった処理をするプログラム（必要なときだけ）

別のファイルは、SKILL.mdの本文から「template.md の欄の順に書く」のように名前を出して指します。
ガイドでは、別のファイルからさらに別のファイルを指す形は避け、SKILL.mdから1段で届くようにするよう書かれています。

また、フォルダの名前はnameと同じにしておきます。
Claudeのアプリにアップロードするときは、このフォルダごとZIPにする必要があります。

ClaudeにSKILL.mdを読み込ませる手順

Claudeのアプリ（Webとデスクトップ）では、Claudeのヘルプにある次の手順でスキルを入れます。

1. 「設定」の「機能」で、コードの実行とファイルの作成をオンにする
2. 「カスタマイズ」の「スキル」を開く
3. 「＋」から「スキルを作成」を選ぶ
4. 「スキルをアップロード」を選び、フォルダごとZIPにしたファイルを選ぶ
5. 一覧に出たスキルがオンになっているかを確かめる

画面の表示の名前は、英語の画面では「Customize」「Skills」「Upload a skill」です。
TeamとEnterpriseのプランでは、手順1の設定を組織の管理者が「組織の設定」でオンにしておく必要があります。

Claude Codeでは、アップロードはしません。
Claude Codeの説明によると、自分のパソコンのすべての作業で使うなら「~/.claude/skills/スキルの名前/SKILL.md」、1つのフォルダの作業だけで使うなら、そのフォルダの「.claude/skills/スキルの名前/SKILL.md」に置きます。
置いたスキルは、Claudeが必要なときに読むほか、「/スキルの名前」と入力して呼び出すこともできます。

ただ、アプリ、Claude Code、APIのあいだでスキルは自動では同じになりません。
どちらでも使いたいスキルは、それぞれに入れておきます。

当社でも、記事の作成や動画の制作など、繰り返す作業の手順をClaude Codeのスキルにして使っています。
Claude Codeで全員が守る決まりを書くCLAUDE.mdとの分け方は、Claude Codeを非エンジニアに配る。CLAUDE.mdと禁止設定の分担で扱っています。

作ったスキルを社内に配る手順

部署で作ったスキルは、社内の人だけに配る前提で広げます。
配り方は、使っている場所とプランで変わります。

ClaudeのアプリのTeamとEnterpriseでは、スキルの「…」のメニューから「共有」を選ぶと、同じ組織の人に共有できます。
受け取った人は使えますが、中身は直せません。
グループにまとめて共有できるのはEnterpriseだけで、どちらも組織の管理者が先に共有を許可しておく必要があります。

全員に配りたいスキルは、組織の管理者が「組織の設定」の「プラグインとスキル」から追加できます。
管理者向けのヘルプによると、管理者が追加したスキルは全員のスキルの一覧にオンの状態で出て、使わない人は自分でオフにできます。
社員が「組織に公開」を選ぶ形にして、管理者が中身を確かめてから一覧に出す設定もあります。

Claude Codeでは、プロジェクトのフォルダに置いたスキルを、社内の共有のリポジトリ（コードの保管場所）に入れれば、同じフォルダで作業する人に届きます。

どの配り方でも、スキルを社外の人が見られる場所に公開するのはおすすめしません。
スキルには社内の手順や決まりがそのまま書かれているので、社外の人に見られると、そのまま中身が出ていきます。

受け取る側にも気をつけたい点があります。
ヘルプは、同僚から受け取ったスキルでも、オンにする前に中のファイルやプログラム、外部への接続の指示を確かめるよう求めています。
どこまで確かめてから使ってよいかは、社内の情報システム部門と決めておいてください。

スキルを直し続ける持ち主と直し方

スキルは、配ったあとに直す人がいないと、手順が古くなっても誰も気づきません。
そのため、スキルごとに持ち主を1人決め、使った人から「ここで迷った」「この形で出してほしい」という声を集めて直します。

書き方のガイドも、チームに共有して使われ方を見て、足りない点を足していく進め方を勧めています。
組織に公開したスキルは、新しい版が承認されると、使っている全員に自動で反映されるとヘルプにあります。

仕事の手順を言葉にしてAIに覚えさせる考え方と、更新の担当の決め方は、仕事の手順をAIに覚えさせる。社内の「型」を資産化する考え方にまとめています。
スキルを作る人が一部の社員にとどまり、ほかの人に使い方が広がらない状態は、「AIを使う人が、一部だけ」のページで取り上げています。

Claudeの業務活用を組織で進めるときの全体の考え方は、Claudeを業務で使う。Geminiとの使い分けと、組織に入れるときの考え方で扱っています。

社内のスキルを全社で探せる場所

部署ごとにスキルが増えていくと、どこにどんなスキルがあるのかが、作った人にしか分からなくなります。

組織のAIポータル「AI Portalize」では、スキルやGem、Gemini Notebook、社内で作ったアプリを登録して、社内の人だけが全社で探せるようにできます。
どのスキルがどれだけ使われているかも見えるので、直す順番を持ち主と相談しやすくなります。

SKILL.mdは、descriptionの1行から書き始める

SKILL.mdは、先頭のnameとdescription、その下の手順と決まりでできた、Claudeのスキルの中身のファイルです。
Claudeは最初にdescriptionだけを読んで使うかどうかを決めるので、社員が実際に頼むときの言葉をここに入れておく必要があります。

本文は短く書いて使いながら足し、配るときは社内の人だけに共有して、スキルごとに持ち主を決めておきます。
まずは、毎週同じことを口で説明している作業を1つ選び、そのdescriptionを1行書くところから始めてください。

参照した情報（2026年10月30日に確認）

• Claude ヘルプセンター「How to create custom skills」

• Claude ヘルプセンター「Using skills in Claude」

• Claude ヘルプセンター「Provisioning and managing skills for your organization」

• Claude Docs「Agent Skills」

• Claude Docs「Skill authoring best practices」

• Claude Code Docs「Extend Claude with skills」