スキルは、Free、Pro、Max、Team、Enterprise プランのユーザーが利用できます。この機能にはコード実行を有効にすることが必要です。スキルはまた、Claude Code ユーザーおよびコード実行ツールを使用するすべての 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 は Cowork タスクを開始して記録をレビューし、スキルを提案します。見つかった内容に応じて、次の 2 つのいずれかが表示されます：
新しいスキルは、提案カードに新規とマークされています。「保存」をクリックして保持するか、「破棄」をクリックして提案を破棄してください。
既存のスキルへの更新。記録が既に持っているスキルと重複する場合、Claude はそのスキルへの変更を提案します。カードは提案の基となるスキルを示します。「更新」をクリックして変更を適用するか、「破棄」をクリックして破棄してください。
提案カードのコンテンツを展開して、決定する前にスキルを読んでください。
記録から保存したスキルはカスタマイズ > スキルに表示され、他のスキルと同じように機能します。同じ条件で編集、共有、削除できます。
記録から保持されるもの
記録のビデオとオーディオは保持されません。記録を Claude に送信した後、Claude は記録をレビューしてスキルを構築します。その後保存されるのは、セッションからのスクリーンショットのセットです。これは、タスクの記録されたデモンストレーションステップを展開することで表示できます。
これらのスクリーンショットは Cowork タスクに存在するため、タスクを削除するとそれらが削除されます。タスクの削除と保持の仕組みについては、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 が知るのに十分な情報を提供します。
マークダウン本文
マークダウン本文はメタデータの後の詳細の 2 番目のレベルであるため、Claude はメタデータを読んだ後、必要に応じてこれにアクセスします。タスクに応じて、Claude は skill.md ファイルにアクセスしてスキルを使用できます。
スキル例.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回のパスで適用します。アーティファクトの編集について詳しく学びます。
TeamおよびEnterpriseプランのご注意：スキルを組織内のすべてのユーザーが利用できるようにするには、組織のスキルをプロビジョニングおよび管理を参照してください。
ベストプラクティス
焦点を絞る：異なるワークフロー用に個別のスキルを作成します。複数の焦点を絞ったスキルは、1つの大きなスキルよりも構成が優れています。
明確な説明を書く：Claudeは説明を使用してスキルを呼び出すかどうかを決定します。それが適用される時期について具体的に説明してください。
シンプルに始める：複雑なスクリプトを追加する前に、Markdownの基本的な指示から始めます。後でスキルを拡張することはいつでもできます。
例を使用する：skill.mdファイルに入力と出力の例を含めて、Claudeが成功がどのようなものかを理解するのに役立てます。
段階的にテストする：複雑なスキルを一度にすべて構築するのではなく、重大な変更の後にテストします。
スキルは相互に構築できます：スキルは他のスキルを明示的に参照することはできませんが、Claudeは複数のスキルを自動的に一緒に使用できます。この構成可能性はスキル機能の最も強力な部分の1つです。
オープンエージェントスキル仕様を確認：agentskills.ioのガイドラインに従って、作成するスキルが標準を採用するプラットフォーム全体で機能するようにします。
スキル作成のより詳細なガイドについては、Claude Docsのスキル作成のベストプラクティスを参照してください。
セキュリティに関する考慮事項
skill.mdファイルにスクリプトを追加する場合は注意してください。
機密情報（APIキー、パスワード）をハードコードしないでください。
ダウンロードしたスキルを有効にする前に確認してください。
外部サービスアクセスには適切なMCP接続を使用してください。
参照するスキルの例
テンプレートとして使用できるスキルの例については、GitHub上のリポジトリをご覧ください：https://github.com/anthropics/skills/tree/main/skills。