スキルは、Free、Pro、Max、Team、およびEnterpriseプランのユーザーが利用できます。この機能にはコード実行を有効にすることが必要です。スキルはClaudeコードユーザーおよびコード実行ツールを使用するすべてのAPIユーザーのベータ版でも利用可能です。
カスタムスキルを使用すると、組織または個人の作業スタイルに固有の専門知識とワークフローでClaudeを強化できます。この記事では、独自のスキルを作成、構成、テストする方法について説明します。
スキルは数行の指示のようにシンプルなものから、実行可能なコードを含む複数ファイルパッケージのように複雑なものまで様々です。最高のスキルは以下の特徴があります：
特定の反復可能なタスクを解決する
Claudeが従うことができる明確な指示を持つ
役立つ場合は例を含める
使用すべき時期を定義する
すべてを行おうとするのではなく、1つのワークフローに焦点を当てている
スキルを記録する
スキルの記録はPro、Max、およびTeamプランで利用可能で、Claude for MacのCoworkで使用できます。チャット、Windows、またはFreeおよびEnterpriseプランでは利用できません。
スキルを手作業で作成する代わりに、タスクを実行している様子を記録して、Claudeが観察したものからスキルを構築させることができます。画面、クリック、入力、音声のビデオをClaudeに送信すると、Claudeは保存する前に確認するスキルを提案します。
記録する前に
Claude for Macを最新バージョンに更新してください。
初めて記録するときにClaudeが要求するmacOSの権限を付与してください：マウスとキーボード追跡用のアクセシビリティ、および画面表示用のスクリーン記録。macOSはClaudeの再起動を要求する場合があります。
キャプチャしたくないファイル、アプリ、または会話を閉じてください。
警告：記録中にパスワードやシークレット、機密情報、またはプライベートな会話を入力したり表示したりしないでください。セッション中、画面上のすべてのものと、あなたが言ったことがすべてキャプチャされます。
ワークフローを記録する
Claude for MacのCoworkを開いてください。
次の2つの方法のいずれかで記録を開始してください：
コンポーザーの「+」ボタンをクリックして、「スキルを記録する」を選択してください。
「カスタマイズ > スキル」に移動し、「追加」をクリックして、「画面を記録する」を選択してください。
「記録を開始」をクリックしてください。作業中にナレーションを行う場合は、マイクをオンのままにしてください。マイクコントロールを使用してミュートするか、別の入力を選択してください。
通常の方法でタスクを実行してください。キャプチャバーは記録が進行中であることを示し、キャプチャしたステップをカウントします。
完了したら「完了」をクリックするか、「破棄」をクリックして記録を削除してください。
記録は約10分間実行できます。残り時間が約1分になるとカウントダウンがキャプチャバーに表示されます。ゼロに達すると、記録が停止し、キャプチャしたすべてのものがClaudeに送信されます。これは「完了」をクリックした場合と同じです。
ヒント：記録中に実行していることについて説明してください。ナレーションはClaudeに画面だけからは得られないコンテキスト（ステップをスキップする理由や2つのオプション間で選択する方法など）を提供します。
「完了」をクリックした後の動作
Claudeはコワークタスクを開始して記録をレビューし、スキルを提案します。見つかったものに応じて、次の2つのいずれかが表示されます：
新しいスキルは提案カードに新規とマークされています。「保存」をクリックして保持するか、「破棄」をクリックして提案を破棄してください。
既存のスキルへの更新。記録が既に持っているスキルと重複する場合、Claudeはそのスキルへの変更を提案します。カードは提案の基となるスキルを示します。「更新」をクリックして変更を適用するか、「破棄」をクリックして破棄してください。
提案カードのコンテンツを展開して、決定する前にスキルを読んでください。
記録から保存したスキルはカスタマイズ > スキルに表示され、他のスキルと同じように機能します。同じ条件で編集、共有、削除できます。
記録から保持されるもの
記録のビデオとオーディオは保持されません。記録をClaudeに送信した後、Claudeは記録をレビューしてスキルを構築します。その後保存されるのはセッションからのスクリーンショットのセットで、タスクの記録されたデモンストレーションステップを展開して表示できます。
これらのスクリーンショットはコワークタスクに存在するため、タスクを削除するとそれらが削除されます。タスクの削除と保持の仕組みについては、Claude Coworkの開始を参照してください。
skill.mdファイルを作成する
すべてのスキルは、最小限でもskill.mdファイルを含むディレクトリで構成されます。これはスキルのコアです。このファイルは、必須メタデータを保持する名前と説明フィールドを含むYAMLフロントマターで始まる必要があります。また、追加のメタデータ、Claudeの指示またはリファレンスファイル、実行可能スクリプト、またはツールを含めることもできます。
必須メタデータフィールド
name:スキルの人間にわかりやすい名前（最大64文字）
例：ブランドガイドライン
description:スキルが何をするか、いつ使用するかについての明確な説明。
これは重要です。Claudeはこれを使用してスキルを呼び出すかどうかを判断します（最大200文字）。
例：プレゼンテーションとドキュメントにAcme Corpブランドガイドラインを適用します。公式の色、フォント、ロゴの使用法を含みます。
オプションのメタデータフィールド
dependencies:スキルに必要なソフトウェアパッケージ。
例：python>=3.8、pandas>=1.5.0
skill.mdファイルのメタデータは、段階的な情報開示システムの最初のレベルとして機能し、すべてのコンテンツを読み込まなくても、スキルをいつ使用すべきかをClaudeが知るのに十分な情報を提供します。
マークダウン本文
マークダウン本体はメタデータの次のレベルの詳細であり、Claudeはメタデータを読んだ後、必要に応じてこれにアクセスします。タスクによっては、Claudeはskill.mdファイルにアクセスしてスキルを使用できます。
スキル例skill.md
ブランドガイドラインスキル
## Metadata
name: Brand Guidelines
description: Apply Acme Corp brand guidelines to all presentations and documents
## Overview
This skill provides Acme Corp's official brand guidelines for creating consistent, professional materials. When creating presentations, documents, or marketing materials, apply these standards to ensure all outputs match Acme's visual identity. Claude should reference these guidelines whenever creating external-facing materials or documents that represent Acme Corp.
## Brand Colors
Our official brand colors are:
- Primary: #FF6B35 (Coral)
- Secondary: #004E89 (Navy Blue)
- Accent: #F7B801 (Gold)
- Neutral: #2E2E2E (Charcoal)
## Typography
Headers: Montserrat Bold
Body text: Open Sans Regular
Size guidelines:
- H1: 32pt
- H2: 24pt
- Body: 11pt
## Logo Usage
Always use the full-color logo on light backgrounds. Use the white logo on dark backgrounds. Maintain minimum spacing of 0.5 inches around the logo.
## When to Apply
Apply these guidelines whenever creating:
- PowerPoint presentations
- Word documents for external sharing
- Marketing materials
- Reports for clients
## Resources
See the resources folder for logo files and font downloads.
リソースを追加
単一のskill.mdファイルに追加する情報が多すぎる場合（例えば、特定のシナリオにのみ適用されるセクション）、スキルディレクトリ内にファイルを追加することで、より多くのコンテンツを追加できます。例えば、補足情報とリファレンス情報を含むREFERENCE.mdファイルをスキルディレクトリに追加します。skill.mdでそれを参照することで、Claudeがスキルを実行する際にそのリソースにアクセスする必要があるかどうかを判断するのに役立ちます。
スクリプトを追加
より高度なスキルの場合、実行可能なコードファイルをskill.mdに添付して、Claudeがコードを実行できるようにします。例えば、ドキュメントスキルは以下のプログラミング言語とパッケージを使用します。
Python（pandas、numpy、matplotlib）
JavaScript/Node.js
ファイル編集を支援するパッケージ
ビジュアライゼーションツール
注：ClaudeとClaude Codeは、スキルを読み込む際に標準リポジトリ（Python PyPI、JavaScript npm）からパッケージをインストールできます。API Skillsではランタイムに追加パッケージをインストールすることはできません。すべての依存関係はコンテナに事前インストールされている必要があります。
スキルをパッケージ化
スキルフォルダが完成したら：
フォルダ名がスキルの名前と一致することを確認します。
フォルダのZIPファイルを作成します。
ZIPはスキルフォルダをルートとして含める必要があります（サブフォルダではなく）。
正しい構造：
my-skill.zip
└── my-skill/
├── skill.md
└── resources/
不正な構造：
my-skill.zip
└── （ZIPルートに直接ファイル）
スキルをテスト
アップロード前
1. skill.mdの明確性を確認します。
2. 説明がClaudeがスキルを使用すべき時期を正確に反映していることを確認します。
3. 参照されているすべてのファイルが正しい場所に存在することを確認します。
4. 例のプロンプトでテストして、Claudeが適切に呼び出すことを確認します。
Claudeにアップロード後
1. カスタマイズ > スキルでスキルを有効にします。
2. それをトリガーすべき複数の異なるプロンプトを試します。
3. Claudeの思考を確認して、スキルが読み込まれていることを確認します。
4. Claudeが予期したときに使用していない場合は、説明を繰り返します。
Claudeとチャットでスキルを反復処理する場合、スキルファイルを会話の横に開いている場所で直接編集できます。変更したいテキストをハイライトして、「Claudeで編集」をクリックし、リクエストを入力します。複数のファイルを持つスキルの場合、ファイル全体に編集リクエストを残して一緒に送信すると、Claudeが1回のパスで適用します。アーティファクトの編集について詳しく学びます。
チームおよびエンタープライズプランの注：組織内のすべてのユーザーがスキルを利用できるようにするには、組織のスキルをプロビジョニングおよび管理を参照してください。
ベストプラクティス
焦点を絞る：異なるワークフロー用に個別のスキルを作成します。複数の焦点を絞ったスキルは1つの大きなスキルより構成が良くなります。
明確な説明を書く：Claudeは説明を使用してスキルを呼び出すかどうかを決定します。それがいつ適用されるかについて具体的に説明してください。
シンプルに始める：複雑なスクリプトを追加する前に、マークダウンの基本的な指示から始めます。後でスキルを拡張できます。
例を使用する：skill.mdファイルに入力と出力の例を含めて、Claudeが成功の様子を理解するのに役立てます。
段階的にテストする：複雑なスキルを一度にすべて構築するのではなく、重大な変更後にテストします。
スキルは相互に構築できます：スキルは明示的に他のスキルを参照することはできませんが、Claudeは複数のスキルを自動的に一緒に使用できます。この構成可能性はスキル機能の最も強力な部分の1つです。
オープンエージェントスキル仕様を確認：agentskills.ioのガイドラインに従って、作成したスキルが標準を採用するプラットフォーム全体で機能するようにします。
スキル作成のより詳細なガイドについては、Claude Docsのスキル作成のベストプラクティスを参照してください。
セキュリティに関する考慮事項
skill.mdファイルにスクリプトを追加する場合は注意してください。
機密情報（APIキー、パスワード）をハードコードしないでください。
ダウンロードしたスキルを有効にする前に確認してください。
外部サービスへのアクセスには適切なMCP接続を使用してください。
参照するスキルの例
GitHubのリポジトリにアクセスして、テンプレートとして使用できるスキルの例を確認してください：https://github.com/anthropics/skills/tree/main/skills。