Claude Skillを作成するには、1つのファイルを含む1つのフォルダーを作成します。そのファイルは、名前と説明で始まり、その後に平易な言葉で書かれた指示が続くSKILL.mdです。フォルダーをZip圧縮してClaudeにアップロードする(またはClaude Codeの場合は~/.claude/skills/に配置する)と、リクエストが説明に一致したときにClaudeが読み込みます。コードもSDKもビルド手順も必要ありません。
このページ
仕組みはこれだけです。毎回起動してそのまま使える成果物を生み出すSkillと、まったく起動しないSkillを分けるのは、およそ6つの判断です。このガイドではそれらを順番に説明します。最後にはコピーして使える無料テンプレートと、頼る前にSkillをテストするためのチェックリストがあります。
この考え方自体が初めてなら、まずClaude Skillsとは?を読んでから戻ってきてください。このページでは、Skillとは何かを理解し、Skillを作成したいと考えていることを前提としています。
始める前に必要なもの
- コード実行を有効にしたClaudeアカウント。SkillはFree、Pro、Max、Team、Enterpriseの各プランで実行できますが、コード実行とファイル作成の設定を有効にする必要があります。TeamとEnterpriseでは、管理者がまず組織向けにSkillを有効にしなければならない場合があります。
- テキストエディター。プレーンテキストを保存できるものなら何でも構いません:VS Code、TextEditのプレーンテキストモード、メモ帳。
- 繰り返し行うタスクを1つ。「マーケティング」ではありません。「営業通話の文字起こしを当社の形式のCRMメモに変換する」や「契約書を当社の5つの標準的な危険信号について確認する」のようなものです。作業の範囲は狭いほど良いSkillになります。
- 良い出力の実例を2つか3つ。喜んで送れる過去のレポート、メール、ブリーフ。これらはSkillにとって最良の生の素材です。
ステップ1:1つの作業を選び、「完了」の定義を決める
失敗するSkillの多くは、1行も書く前にここでつまずきます。「マーケティングマネージャーが行うすべて」をカバーしようとするSkillは、説明が曖昧になり、誤ったタイミングで起動し、起動しても一般的な回答しか返さなくなります。
何よりも先に、次の2文を書きます。
- トリガー:「誰かがXを依頼したとき、またはYを渡したときに使用します。」
- 成果物:「出力は、これらのセクションを、この長さ、このトーンで含むZです。」
例:「誰かが顧客との通話の文字起こしを貼り付け、メモを求めたときに使用します。出力は、通話に参加していなかった営業マネージャー向けに、200語以内で書かれた、概要、課題、予算、次のステップ、リスクを含むCRMメモです。」この2文を書けない場合は、作業を2つのSkillに分けてください。
ステップ2:フォルダーとSKILL.mdファイルを作成する
Skillとは、Skill名と一致する名前のフォルダーです。その中で必須なのは SKILL.md (ファイル名は大文字と小文字が区別されます)。オプションの追加ファイルはその隣に配置します。
| パス | 必須? | 用途 |
|---|---|---|
call-notes/SKILL.md |
はい | フロントマターと、Claudeが従う指示 |
call-notes/resources/example-output.md |
推奨 | 成果物の完成例 |
call-notes/resources/style-guide.md |
任意 | Claudeが必要なときだけ読む、より詳しい参考資料 |
call-notes/scripts/ |
任意 | CSVの解析など、正確さが必要な手順用のPythonまたはシェルスクリプト |
フォルダー名は、次のように小文字とハイフンを使ってください: call-notes または quarterly-report。同じ文字列を 名前 次のステップのフィールドに。
ステップ3:フロントマター(起動条件を決める部分)を書く
ファイルは、3つのハイフンを2行に1つずつ置いた短いYAMLブロックで始まります。必須フィールドは2つです。
-
name- 小文字、数字、ハイフンのみで、最大64文字。識別子になり、Claude Codeではスラッシュコマンド(/call-notes)になります。 -
description- 最大1,024文字。インストール済みの各スキルについて、セッション開始時にClaudeが読むのはこの部分だけです。スキルを読み込むかどうかは、ここで決まります。
説明文は、依頼が自分の担当かどうかを1秒で判断しなければならない同僚に説明するように書きます。まずスキルが生成するものを示し、次に起動すべき状況やフレーズを列挙します。比較してください。
- 弱い例:「営業メモを手伝います。」
- 優れた例:「営業またはディスカバリーコールの書き起こしを、200語以内の構造化されたCRMメモ(概要、課題、予算、次のステップ、リスク)に変換します。ユーザーが通話の書き起こし、会議録音のテキスト、または大まかな通話メモを貼り付け、『メモ』『要約』『CRMへの記録』『フォローアップ用の概要』を求めたときに使用します。」
優れたバージョンでは、入力、出力、そして実際に人々が入力する言葉を明確にします。それによって確実に起動し、それ以外のときは静かにしていられます。
ステップ4:指示を雰囲気ではなく方法として書く
フロントマター以下は、スキルの読み込み後にClaudeが従うMarkdownです。よくある間違いは、長いペルソナ(「20年の経験を持つ世界クラスの営業エキスパート」など)だけで、手順がないことです。Claudeに必要なのは経歴ではありません。手順、ルール、目標とする形式です。ほとんどのビジネススキルで使える構成は次のとおりです。
- 入力 - ユーザーが提供する情報と、それが不足している場合に尋ねる内容(質問は最大2つまでとし、その後は明示した前提に基づいて進める)。
- ワークフロー - 注意深い専門家が行う順番に並べた番号付きの手順。
- 出力形式 - セクション、見出し、長さ、トーンを正確に指定したもの。
- ルール - 常に、または決して起きてはならないこと(「予算額を決して作らず、『話し合われていない』と書く」など)。
- 品質チェック - Claudeが回答前に確認する短いリスト。
1~2画面に収まる程度を目安にします。ファイルがだいたい500行を超える場合は、長いスタイルガイド、価格表、ポリシー文書などの参考資料をresources/内のファイルに移し、必要なときにSKILL.mdでClaudeに開くよう指示します。ファイルの構成について詳しくは、SKILL.mdファイルとはをご覧ください。
ステップ5:完成した出力の例を1つ追加する
どれだけ説明しても、1つの例のほうが形式を早く伝えられます。現実的で完成済みの成果物を1つ、 resources/example-output.md ワークフローから参照します(「resources/example-output.mdの構成と長さに合わせる」)。角括弧だらけのプレースホルダーではなく、名前や数値を変更した実際の過去の成果物を使ってください。私たちのカタログも同じルールに従っています。すべてのSkillにexample outputが付属しているのは、実際にテストしたことを示す最も明確な証拠だからです。
ステップ6:パッケージ化してインストールする
Claude(ウェブ版とデスクトップ版)の場合: フォルダ自体がzipのルートに置かれるようにフォルダをzip圧縮します(call-notes.zipにcall-notes/SKILL.mdが含まれる形)。設定でSkillsセクションを開き、zipをアップロードしてSkillをオンにします。新しいチャットを開始し、説明に一致するリクエストを送信します。
Claude Codeの場合: zipは必要ありません。フォルダを~/.claude/skills/に置くとすべてのプロジェクトで使え、リポジトリ内の.claude/skills/に置くと、そのリポジトリで作業する全員と共有できます。/call-notesと入力するか、タスクを説明するだけで使えます。Claude Codeは再起動しなくてもフォルダの変更を認識します。
各環境の詳しい手順(ファイルの場所や、アップロードが拒否された場合の対処法を含む)は、Claude Skillのインストール方法にあります。主にターミナルで作業する開発者は、Claude Code Skillsもお読みください。
ステップ7:本番さながらにテストする
一度しか試していないSkillは、テスト済みとは言えません。チームに共有する前に、このチェックを実行してください。
- 起動テスト(5個のprompts)。 表現を変えた、Skillを起動すべきリクエストを5つ書きます。いくつ起動したかを数えます。4未満なら、説明にユーザーが実際に使う表現をもっと含める必要があります。
- 無反応テスト(5個のprompts)。 これを起動すべきでない、近い内容のリクエストを5つ書きます。いずれかで起動したら、説明をより限定的にします。
- 入力不足テスト。 入力の半分だけを与えます。事実をでっち上げず、短い質問をするか、前提を明示するはずです。
- 形式テスト。 3つの出力を例と並べて比較します。セクション、長さの範囲、トーンは同じですか?
- エッジケーステスト。 手元にある最も扱いにくい実際の入力を与えます。冗長な文字起こしや、途中までしか入力されていないスプレッドシートなどです。
トリガーの問題にはdescriptionを、出力の問題にはワークフローまたはルールを修正します。ファイルの末尾に短い変更履歴を残して、チームが実行しているバージョンを把握できるようにします。
無料のClaude Skillテンプレート(コピーして適応)
大文字部分を置き換え、不要な部分を削除して、次の名前で保存します SKILL.md 同じ名前の 名前 フィールド。
---
name: your-skill-name
description: 特定の入力から特定の成果物(セクション、長さ)を作成します。ユーザーがXを依頼したとき、Yを貼り付けたとき、またはZに言及したときに使用します。別の場所に属する近接したタスクには使用しないでください。
---
# Skillのタイトル
## 目的
対象者と、「完了」がどのような状態かを1文または2文で説明する。
## 入力
- 必須:ユーザーが提供しなければならないもの
- 任意:結果を改善するもの
- 必須の入力が不足している場合は、短い質問を最大2つまで行う。
その後、出力の先頭に前提を列挙して進める。
## ワークフロー
1. 入力を読み、主要な要素を特定する。
2. RULES OR CRITERIAと照合する。
3. 以下の形式で出力の下書きを作成する。
4. 品質チェックを実行し、不合格の項目を修正してから回答する。
## 出力形式
- セクション1:名前 - ここに記載する内容(長さ)
- セクション2:名前 - ここに記載する内容(長さ)
- セクション3:名前 - ここに記載する内容(長さ)
resources/example-output.mdの構成と長さに合わせる。
## ルール
- 数値、名前、日付を決して捏造しない。代わりに「未提供」と書く。
- 平易な英語を使う。冗長な書き出しは避ける。
- チームまたは業界固有のルール。
## 品質チェック
- すべてのセクションが存在し、順番どおりですか?
- すべての主張を入力内容までたどれますか?
- 長さの上限内に収まっていますか?
## 変更履歴
- v1.0 初版、日付
完成したSkillがどのようなものか見てみませんか? Claude Skillの例では、実際のSKILL.mdファイル12個を1行ずつ解説しており、十分な詳細量を把握する最短の方法です。
Skillを役に立たなくする5つの間違い
- いつ使うかではなく、Skillが何であるかを説明する説明文。 「熟練したコピーライター」では起動しません。「ユーザーが商品説明、PDPのコピー、または商品一覧のテキストを求めたときに、機能一覧から商品ページのコピーを作成する」なら起動します。
- 部署全体で1つのSkill。 予算編成、給与計算、監査を1つのファイルにまとめると、中途半端な回答が3つ得られるだけです。Skillを3つ作成してください。
- 出力形式なし。 形式がなければ、実行するたびに結果が異なり、誰も信頼してくれません。
- ファイル内の秘密情報。APIキー、パスワード、クライアントデータをSkillに貼り付けないでください。共有した相手は誰でも読むことができます。
- 他人のSkillを読まずにインストールする。Skillには、スクリプトが含まれることもある、Claudeが従う指示が書かれています。スクリプトを実行する前に読むのと同じように、Skillも読んでください。
Claudeに最初の下書きを書いてもらう
空のファイルから始める必要はありません。Claudeにタスクについてインタビューさせ、frontmatterとワークフローの下書きを作成し、出力例を生成させ、上記のテスト用promptsを提案させることができます。Anthropicはまさにこの目的のために組み込みのskill-creator Skillを提供しています。また、平易な言葉で「毎週のクライアントレポートをどう書いているかインタビューして、そのためのSKILL.mdを書いて」と頼むこともできます。下書きには、特に説明文とルールについて、あなたの編集が必要になりますが、入力作業の大部分を省けます。
チャットよりフォームが好みですか?無料のClaude Skill Builderなら、タスクの簡単な説明から、frontmatterとワークフローを含むすぐ使えるSKILL.mdを作成できます。Claude.aiやClaude Code用にコピーまたは.zipとしてダウンロードできます。サインアップは不要です。
インタビュー、セルフテスト、パッケージ化まで任せたいですか? Claude Skill Creator(19ドル)は、Skillを作るSkillです。業務内容、実際に人が入力する依頼、絶対に起きてはいけないことをたずね、SKILL.mdと出力例を含む完全なSkillフォルダーを書き出し、起動すべき依頼と起動すべきでない依頼に対して説明文をテストし、Claude、Claude Code、API向けにフォルダーをパッケージ化します。自分で作成またはダウンロードしたSkillを監査するには、Claude Skill Reviewer & Security Linterを使うか、prompt、MCP、コードレビュー用のSkillも含めてBuild Your Own Claude Skills Kit(49ドル)を入手してください。
自分で作る?それとも既製のものから始める?
チーム独自のワークフローである場合、外部の誰も持っていない社内知識が組み込まれている場合、または改善を繰り返すのが好きな場合は、自分で作りましょう。経理、SEO向けブリーフ、契約レビュー、サポート返信など、標準的な業務で、指示を書くより午後を作業に使いたい場合は、既製のSkillから始めましょう。Claude Skillsライブラリの既製Skillは19ドルで、出力例が付属し、開いて編集できるプレーンなMarkdownファイルなので、自分用のバージョンを作る際のテンプレートとしても使えます。
いずれにしても、次のステップは同じです。毎週繰り返しているタスクを1つ選び、ステップ1の2文を書いて、今日中に動くSkillを完成させましょう。