スキルの作成方法：主なステップ、制限事項、および事例

スキルとは、特定のタスクや分野において Claude の機能を拡張するカスタム指示です。

SKILL.md ファイルでスキルを作成する際、特定のシナリオをより効果的に処理する方法を Claude に教えます。スキルの真価は、組織の知見を体系化し、成果物を標準化し、複雑な多段階ワークフローを処理できる点にあります。これらがなければ、繰り返し説明を行う必要が生じたり、カスタムエージェント構築への投資が必要になったりします。

当社のスキル作成テンプレートまたは手動で、クロードを汎用アシスタントから特定のワークフローに特化した専門化へと変えるスキルの作成方法をご確認ください。（プロのヒント：簡単に作成するには、このテンプレートで SKILL.md ファイルを作成し、そこからカスタマイズすることをお勧めします）。

5つの手順でスキルを作成

この体系的なアプローチに従って、より確実にトリガーするスキルを構築します。

1. コア要件を理解

何か書く前に、そのスキルが解決する問題を明確にします。優れたスキルは、具体的なニーズに対して測定可能な成果をもたらします。「PDF から財務データを抽出し CSV 形式で出力してください」は「財務関連の作業を手伝ってほしい」よりも優れています。なぜなら、入力形式、操作内容、期待される出力が明確に指定されているからです。

まず自問してください。このスキルは具体的にどのようなタスクを達成するのか？どのようなトリガーで起動すべきか？成功とはどのような状態か？エッジケースや制限事項は何か？

2. 名前の記述

スキルには名前（明確な識別子）と説明（起動するタイミング）と指示（実行方法）の 3 つのコア要素が必要です。実際、名前と説明は SKILL.md ファイルの中でトリガーに影響を与える唯一の要素であり、言い換えれば Claude が専門的な知識やワークフローのためにスキルを呼び出す能力に関わります。

名前は簡潔で分かりやすいものにする必要があります。小文字とハイフンを使用します（pdf-editor、brand-guidelines など）。短く明確に保ちます。

3. 説明フィールドの記述

説明文はスキルを起動させるタイミングを決定するので、最も重要な要素になります。Claude の視点に立ち、トリガー、機能、ユースケースに焦点を当てて記述します。

効果的な説明文は、具体的な機能、明確なトリガー、関連コンテキスト、および制限事項など、いくつかの要素のバランスが取れています。

不十分な説明文の例：

このスキルは、PDF やドキュメントで役立ちます。

効果的な説明文の例：

テキストと表の抽出、新規 PDF 作成、ドキュメントの結合/分割、フォーム処理のための包括的な PDF 操作ツールキットです。 Claude が PDF フォームへの入力やプログラム処理を必要とする場合、PDF 文書を大規模に生成、分析します。 ドキュメントワークフローとバッチ操作に使用します。 単純な PDF 表示や基本的な変換向けではありません。

より効果的なバージョンでは、Claude に特定の動詞（抽出、作成、マージ）や具体的なユースケース（フォーム入力、バッチ操作）や明確な制限事項（単純な閲覧用ではない）など、複数のデータポイントを提供します。

4. 主要な指示の記述

指示は構造化され、さっと目を通すことができ、実行可能な内容にする必要があります。マークダウンヘッダー、選択肢には箇条書きを、例示にはコードブロックを使用します。

明確な階層構造：概要、前提条件、実行手順、例、エラー処理、制限事項。複雑なワークフローを、明確な入力と出力を持つ個別の段階に分割します。

正しい使用方法を示す具体的な例を含めます。誤用を防止し期待値を管理するためにスキルが実行できないことを明記します。SKILL.md ファイルに追加の参照ファイルやアセットを含めることもできます。これによりスキルが起動された際にエージェントに実行させる内容について、より明確な説明やガイダンスが提供されます。

5. スキルのアップロード 

構築する Claude のプラットフォームに応じて、以下のようにスキルをアップロードします。 

• Claude.ai（Claude アプリ）：設定に移動し、そこにカスタムスキルを追加します。カスタムスキルを使用するには、Pro、Max、Team、または Enterprise plan でコード実行が有効になっている必要があります ここにアップロードされたスキルは各ユーザーに固有のものであり、組織全体で共有されることはなく、管理者による一元的な管理もできません。
• Claude Code：プラグインまたはプロジェクトのルートディレクトリに skills/ ディレクトリを作成し、SKILL.md ファイルを含むスキルフォルダを追加します。Claude はプラグインがインストールされているときに自動的に検出し使用します。

• Claude Developer Platform： スキル API（/v1/skills エンドポイント）を介してスキルをアップロードします。以下の必要なベータ版ヘッダーを指定した POST リクエストを使用します。

curl -X POST 「https://api.anthropic.com/v1/skills」\
-H 「x-api-key：$ANTHROPIC_API_KEY」\
-H "anthropic-version：2023-06-01" \
-H 「人性化ベータ：スキル-2025-10-02」\
-F 「display_title=マイスキル名」\
-F 「files[]=@my-skill/SKILL.md;filename=my-skill/SKILL.md」

4. テストと検証

スキルをデプロイする前に現実的なシナリオでテストします。体系的なテストにより、指示の不足、説明の曖昧さおよび実際の使用時にのみ明らかになる、予期せぬエッジケースが明らかになります。

以下の 3 つのシナリオを網羅するテストマトリクスを作成します。

• 通常の動作：スキルが問題なく処理できる一般的なリクエストでテストします。財務分析スキルを構築した場合、「Microsoft の最新決算を分析してください」や「この 10-K 提出書類のデータパックを作成してください」などを試してください。これらの基本テストにより、指示が意図した通りに機能することを確認します。
• エッジケース：不完全または異常な入力でテストします。 データが欠落している場合。ファイル形式が想定外の場合。ユーザーが曖昧な指示を与えた場合。スキルはこれらのケースを適切に処理することが求められます。有用な出力を生成するか、または処理を進めるために必要な事項を説明するかのいずれかです。
• 範囲外のリクエスト：関連しているように見えるがスキルを起動させるべきでないタスクでテストします。NDA レビュースキルを構築した場合、「この雇用契約書をレビューしてください」や「この賃貸借契約を分析してください」といった要求を試してみます。スキルは待機状態を維持し、他のスキルや一般的な Claude 機能にリクエストを処理させます。

より深い検証のために、次のテストの実施を検討してみてください。

• トリガーテスト：期待通りにスキルは起動しますか？ 明示的なリクエスト（「この会社の財務データを分析するために財務データパックスキルを使用してください」）および自然なリクエスト（「この会社の財務状況を理解するのを手伝ってください」）の両方でテストします。関連性がない場合、非アクティブ状態を維持するか？適切に範囲設定されたスキルは、作動すべきでないタイミングを認識します。境界を検証するため、類似しているが明確に異なるリクエストをテストします。
• 機能テスト：これには出力の一貫性（類似した入力で複数回実行した場合、同等の結果が得られるか？）、ユーザビリティ（その分野に不慣れな方でも問題なく使用できるか？）、およびドキュメントの正確性（記載されている例が実際の動作と一致しているか？）が含まれます。

5. 使用状況に基づく反復的な改善

実際の使用環境におけるスキルの動作を監視します。トリガーに一貫性がない場合は説明文を修正します。出力が予期せずに変化する場合は指示を明確化します。プロンプトと同様に、優れたスキルは実用化を通じて進化します。

スキル作成における一般的なベストプラクティス

これらの原則は、理論上ではなく、維持管理が容易で再利用可能、かつ真に有用なスキルを作成するのに役立ちます。

ユースケースから始める

推測的にスキルを記述しないでください。実際に繰り返し発生するタスクがある場合に構築します。優れたスキルは日常的に直面する問題を解決します。

スキル作成前に自問してください。「このタスクを少なくとも 5 回は実行したか？今後少なくとも 10 回以上繰り返す予定はあるか？」と。もし「はい」なら、スキル作成は意味があります。

成功基準を定義し、スキルに含める

Claudeに「良い結果」のイメージを伝えます。財務報告書を作成する場合は、必須セクション、書式基準、検証チェック、品質しきい値を指定します。これらの基準を指示文に含めることで、Claude が自己チェックできるようになります。

「スキル作成」スキルを使用

「スキル作成」スキルは、分かりやすく構造化されたスキルの作成を支援します。明確化のための質問を行い、説明文の改善を提案し、指示文の適切なフォーマットを支援します。GitHub のスキルリポジトリおよび、Claude.aiを介して直接利用できます。特に最初の数スキル作成において非常に有用です。

スキルの制限と考慮事項

スキルの仕組みとその限界を理解することは、より効果的なスキル設計と適切な期待値の設定に役立ちます。

スキルのトリガー

Claude はリクエストに対してスキル記述を評価し、関連性を判断します。これはキーワードの一致ではなく、Claude が意味的な関係を理解するためです。ただし、曖昧な説明はトリガーの精度を低下させます。

複雑なタスクの異なる側面に対応する場合は、複数のスキルを同時に起動させることができます。過度に一般的な記述は不適切な起動を引き起こし、使用例が不足すると起動の機会を逃します。

適切なファイルサイズ

スキルを記述する際には、コンテキストウィンドウを不必要なコンテンツで肥大化させないように注意します。各情報が毎回読み込まれる必要があるか、条件付きで読み込まれるべきかを検討してください。

「メニュー」アプローチの採用：スキルが複数の異なるプロセスやオプションを網羅する場合は、SKILL.md は利用可能な スキル を記述し、各機能に対応する別ファイルを相対パスで参照します。その後 Claudeはユーザーのタスクに関連するファイルのみを読み込み、その会話では他のファイルは使用しません。

これらの個別のファイルは相互に排他的なパスを表す必要はありません。重要な原則は、コンテンツを適切なサイズに分割し、Claude が目の前のタスクに基づいて必要なものを選択できるようにすることです。

実世界のスキル例

スキル例 #1：docx 作成スキル

強みとなる点：タスクの種類に基づいて Claude を適切なワークフローに誘導する明確な意思決定ツリーを提供します。段階的開示を採用して主要ファイルを簡潔に維持しながら、必要な場合にのみ詳細な実装ファイルを参照します。また、変更履歴の追跡といった複雑なパターンの実装方法を具体的に示す、良い例と悪い例を具体的に含みます。

#---
名前：docx
説明：「包括的な文書作成、編集、分析であり、変更の追跡、コメント、書式保持、テキスト抽出をサポートします。 Claude が以下の目的で専門的な文書（.docx ファイル）を扱う必要がある場合：（1）新規文書作成、（2）コンテンツの修正または編集、（3）変更追跡処理、（4）コメント追加、その他のドキュメントタスク
ライセンス：プロプライエタリ。 LICENSE.txt には完全な条項が含まれている
---

# DOCX 作成、編集、分析

## 概要

ユーザーは、.docx ファイルのコンテンツの作成、編集、分析を指示することがあります。 .docx ファイルは本質的に XML ファイルやその他のリソースを含む ZIP アーカイブであり、これらのリソースは読み取りや編集が可能です。 異なるタスクで利用できるさまざまなツールとワークフローが用意されています。

## ワークフロー決定ツリー

### コンテンツの読み取り/分析
以下の「テキスト抽出」または「Raw XML アクセス」セクションを使用する

### 新規ドキュメントの作成
「新しい Word 文書を作成」ワークフローを使用する

### 既存ドキュメントの編集
- **独自のドキュメント + 簡単な変更**
「基本的な OOXML 編集」ワークフローを使用する

- **他のユーザーのドキュメント**
**「Redlining ワークフロー」**（推奨デフォルト）を使用する

- **法律、学術、ビジネス、政府機関の文書**
**「Redlining ワークフロー」**を使用する（必須）

## コンテンツの読み取りと分析

### テキスト抽出
ドキュメントのテキストコンテンツを読み取るだけが必要な場合は、pandoc を使用してドキュメントをマークダウンに変換する必要があります。 Pandoc は文書構造の維持に優れたサポートを提供し、追跡された変更を表示できます。

``bash
# 文書をマークダウンに変換し、変更を追跡する
pandoc --track-changes=all path-to-file.docx -o output.md
# オプション：--track-changes=accept/reject/all
```

### 未加工 XML アクセス
コメント、複雑なフォーマット、ドキュメント構造、埋め込みメディア、メタデータに対して生の XML アクセスが必要となります。 これらの機能のいずれかを使用するには、ドキュメントを解凍し、その生の XML コンテンツを読み込む必要があります。

#### ファイルの解凍
`python ooxml/scripts/unpack.py `

#### 主要なファイル構造
* `word/document.xml` - 主なドキュメントコンテンツ
* `word/comments.xml` - document.xml で参照されるコメント
* `word/media/` - 埋め込み画像とメディアファイル
* 追跡された変更は、「」タグ（挿入）と「」タグを使用する

## 新しい Word 文書の作成

新しい Word 文書をゼロから作成する場合は、**docx-js** を使用します。これにより、JavaScript/TypeScript を使用して Word 文書を作成できます。

### ワークフロー
1. **必須 - ファイル全体を読み取る**：[`docx-js.md`]（docx-js.md）（約500行）を最初から最後まで完全に読み込みます。 **このファイルを読み込む際は、決して範囲制限を設定しないでください。** 文書作成を進める前に、詳細な構文、重要な書式ルール、ベストプラクティスについてファイルコンテンツ全体を読みます。
2. Document、Paragraph、TextRun コンポーネントを使用して JavaScript/TypeScript ファイルを作成する（すべての依存関係がインストールされていると仮定できますが、インストールされていない場合は、以下の依存関係セクションを参照してください）
3. Packer.toBuffer（）を使用して .docx としてエクスポート

## 既存の Word 文書の編集

既存の Word 文書を編集する場合は、**ドキュメントライブラリ**（OOXML 操作のための Python ライブラリ）を使用します。 このライブラリは自動的にインフラストラクチャ設定を処理し、ドキュメント操作のための方法を提供します。 複雑なシナリオでは、ライブラリを介して直接基盤となる DOM にアクセスできます。

### ワークフロー
1. **必須 - ファイル全体を読み取る**：[`ooxml.md`]（ooxml.md）（~600 行）を最初から最後まで完全に読み込みます。 **このファイルを読み込む際は、決して範囲制限を設定しないでください。** Document ライブラリ API の完全なファイル内容と、ドキュメントファイルを直接編集するための XML パターンを読みます。
2. ドキュメントを展開します。「python ooxml/scripts/unpack.py 」
3. Document ライブラリを使用して Python スクリプトを作成し、実行する（ooxml.md の「ドキュメントライブラリ」セクションを参照）
4. 最終文書をパッケージ化：`python ooxml/scripts/pack.py `

Document ライブラリは、一般的な操作のための高レベルのメソッドと、複雑なシナリオのためのダイレクト DOM アクセスの両方を提供します。

スキル例 #2：ブランドガイドライン

強みとなる点：Claude が本来持っていない正確で実用的な情報（正確な 16 進数コード、フォント名、サイズのしきい値）を提供し、その機能と発動条件を Claude に明確に説明します。

強みとなる点：明確な境界線を持つ創造的機能、組み込み型著作権保護機能、非音楽家向けの技術的基盤、品質基準。

#name：ブランドガイドライン
説明：Anthropic の公式ブランドカラーとタイポグラフィを、Anthropic のルックアンドフィールを持つことで恩恵を受ける可能性のあるあらゆる種類のアーティファクトに適用します。 ブランドカラーやスタイルガイドライン、視覚的なフォーマット、企業のデザイン基準が適用される場合に使用します。
ライセンス：LICENSE.txt に条件を完了させる
---

# Anthropic ブランドスタイリング

## 概要

Anthropic の公式ブランドアイデンティティとスタイルリソースにアクセスするには、このスキルを使用します。

**キーワード**：ブランディング、コーポレートアイデンティティ、視覚アイデンティティ、後処理、スタイリング、ブランドカラー、タイポグラフィ、Anthropic ブランド、視覚フォーマット、視覚デザイン

## ブランドガイドライン

### 色

**メインカラー：**

- ダーク：｀#141413｀ - 主要テキストと暗い背景
- ライト：`#faf9f5` - 背景を明るくし、テキストを暗く表示
- ミッドグレー：`#b0aea5` - 二次要素
- ライトグレー：｀#e8e6dc｀ - 微妙な背景

**アクセント色：**

オレンジ（#d97757）- 一次アクセント
青（#6a9bcc）- 二次リアクセント
- 緑：｀#788c5d｀ - 三次アクセント

### タイポグラフィ

- **見出し**：ポップピン（Arial フォールバック付き）
- **本文テキスト**：Lora（ジョージア州フォールバック付き）
- **注**：最良の結果を得るためには、フォントを環境にプレインストールする必要があります

## 機能

### スマートフォントアプリケーション

- Poppins フォントを見出し（24pt 以上）に適用する
- Lora フォントを本文テキストに適用する
- カスタムフォントが利用できない場合、自動的に Arial/Georgia にフォールバックする
- すべてのシステムで可読性を維持する

#### テキストスタイリング

- 見出し（24pt+）：Poppins フォント
- 本文テキスト：Lora フォント
- 背景に基づくスマートな色選択
- テキスト階層と書式を維持する

### 図形とアクセント色

- 非テキスト図形はアクセント色を使用する
- オレンジ、青、緑のアクセントを循環させる
- ブランドを維持しながら、視覚的な興味を維持する

## 技術的な詳細

### フォント管理

- システムインストールの Poppins と Lora フォントが利用可能な場合に使用する
- Arial（見出し）と Georgia（本文）への自動フォールバックを提供する
- フォントのインストールは不要 - 既存のシステムフォントで動作する
- 最良の結果を得るには、Poppins と Lora フォントを環境にプレインストールします

### カラーアプリケーション

- 正確なブランド一致にRGB色値を使用する
- python-pptx の RGBColor クラスを介して適用される
- 異なるシステム間で色の忠実性を維持する

スキル例 #3：フロントエンドデザインスキル

強みとなる点：明確な境界線を持つ創造的機能、組み込み型著作権保護機能、非音楽家向けの技術的基盤、品質基準。

よくある質問

実際にトリガーする説明文はどのように書けばよいですか？

一般的なキーワードではなく、機能とシナリオに焦点を当てます。アクション動詞、具体的なファイル形式、明確なユースケースを含めます。「文書処理スキル」の代わりに「PDF から表を抽出し、データ分析ワークフロー用に CSV 形式に変換してください」と記述します。

Claude はどのスキルを起動するかをどのように判断しますか？

Claudeは意味理解を用いてスキル記述に対してリクエストを評価します。キーワードの一致ではなく、Claude はコンテキストの関連性を判断します。リクエストのさまざまな側面に対応する場合は、複数のスキルを有効化できます。

説明文の適切な詳細レベルは？

単一目的のスキルを目指します。「ブログ投稿の SEO 最適化」は、具体的な指示としては十分な焦点が当てられており、再利用性にも十分な広さがあります。広すぎる例：「コンテンツマーケティング支援」狭すぎる例：「メタ説明を追加してください」

組織全体でスキルを共有する方法は？

チームの規模にかかわらず、 スキル仕様を指定した共有ドキュメントリポジトリの作成をお勧めします。

小規模なチームの場合：名前、説明、指示、バージョン情報を含んだテンプレート形式を使用します。

中規模から大規模なチーム：スキルガバナンスのプロセスを確立します。

• 各領域（財務、法務、マーケティング）ごとにスキルオーナーを指定
• スキルライブラリとして一元化した Wiki または共有ドライブを維持
• 各スキルに使用例と一般的なトラブルシューティングを含める
• スキルをバージョン管理し、変更内容を変更履歴に記録
• 四半期ごとのレビューをスケジュールし、古くなったスキルを更新または廃止

あらゆる規模のチームにおけるベストプラクティス：

• スキルごとにビジネス目的を文書化
• メンテナンスと更新の責任者の明確な割り当て
• 新規メンバーが共有スキルを実装する方法を示すオンボーディング資料を作成
• メンテナンス作業の優先順位付けのため、最も価値を提供するスキルを追跡
• スキルを容易に見つけられるよう、一貫した命名規則を使用

エンタープライズのお客様は、Anthropic のカスタマーサクセスチームと連携して追加のデプロイメントオプションやガバナンスフレームワークを検討いただけます。

スキルのデバッグ方法は？

起動と実行を別々にテストします。スキルが有効にならない場合は、説明を広げてユースケースを追加します。結果が一貫していない場合は、指示に具体性を追加し、検証ステップを含めます。通常の使用状況、エッジケース、範囲外のリクエストを網羅したテストケースライブラリを作成します。

組織全体でスキルを共有する方法は？

Claude.aiでは現在、スキルは各ユーザーごとに個別に管理されていますが、組織全体の管理と共有機能が間もなく提供される予定です。それまでの間、チームの規模にかかわらず、スキル仕様を指定した共有ドキュメントリポジトリの作成をお勧めします。これにより、今後の機能提供に備えつつ、今日から適切なガバナンス慣行を確立できます。

利用開始する

スキルを活用した構築の準備はできましたか？ 以下の方法で開始できます。

Claude.aiユーザー：

• 設定→機能でスキルを有効にします
• claude.ai/projectsで最初のプロジェクトを作成します
• 次の分析タスクでは、プロジェクトのナレッジとスキルの組み合わせを試してみてください

API開発者：

• ドキュメント内のスキルのエンドポイントを確認します
• スキルクックブックを確認します

Claude Codeユーザー：

• プラグインマーケットプレイスを介してスキルをインストールします
• スキルクックブックを確認します