C
ClaudeSkills
Tutorial#tutorial#documentation#reference

SKILL.md ファイル形式完全ガイド

Claude Skills の SKILL.md 形式を習得。すべてのセクション、構文、プロフェッショナルスキル作成のベストプラクティスを学ぶ。

ClaudeSkills Team
•
•
10 分で読める

SKILL.md ファイル形式完全ガイド

SKILL.md ファイルはすべての Claude Skill の中心。プロフェッショナルで信頼性の高いスキルを作成するために形式を習得。

ファイル構造

公式 Anthropic Skills リポジトリ によると、SKILL.md ファイルは YAML フロントマターを使用：

markdown
1---
2name: my-skill-name
3description: このスキルが何をするか、いつ使用するかの明確な説明
4---
5
6# My Skill Name
7
8[このスキルがアクティブな時に Claude が従う指示をここに追加]
9
10## 例
11- 使用例 1
12- 使用例 2
13
14## ガイドライン
15- ガイドライン 1
16- ガイドライン 2

フロントマター（必須）

上部の YAML フロントマターには2つのフィールドのみが必要：

  • name: スキルの一意の識別子（小文字、スペースはハイフン）
  • description: スキルが何をするか、いつ使用するかの完全な説明

例:

yaml
---
name: pdf-extractor
description: PDF ドキュメントからテキスト、表、フォームデータを抽出し、分析・処理用
---

指示セクション

明確で実行可能なステップを記述：

markdown
1## 指示
2ドキュメントを処理する場合:
31. 入力形式を検証
42. コンテンツセクションを抽出
53. 変換を適用
64. 出力を検証
75. 構造化データを返す

ベストプラクティス:

  • シーケンスには番号付きリストを使用
  • 決定ポイントを含める（「X の場合、Y」）
  • 期待される入出力を定義
  • エラー条件を指定

使用例

具体的な例を提供：

markdown
1## 使用例
2
3### 例 1: 基本処理
4**入力**: document.pdf
5**出力**: {"text": "...", "pages": 5}
6
7### 例 2: オプション付き
8**入力**: document.pdf, {"extract_images": true}
9**出力**: {"text": "...", "images": [...]}

依存関係

すべての要件をリスト：

markdown
1## 依存関係
2- Python: >= 3.8
3- PyPDF2: >= 3.0.0
4- pdfplumber: >= 0.9.0
5
6インストール:
7```bash
8pip install PyPDF2 pdfplumber

## 高度な機能

### 条件付きロジック

```markdown
ドキュメントが暗号化されている場合:
1. パスワードを要求
2. コンテンツを復号
3. 抽出を続行
そうでない場合:
- 直接処理

マルチステップワークフロー

markdown
1フェーズ 1: 準備
2- 入力を検証
3- 環境をセットアップ
4
5フェーズ 2: 処理
6- メインロジックを実行
7- 結果を収集
8
9フェーズ 3: クリーンアップ
10- 一時ファイルを削除
11- 最終出力を返す

一般的な間違い

❌ 曖昧な指示: "ファイルを処理" ✅ 明確な指示: "ページ 1-10 からテキストを抽出"

❌ エラーハンドリングなし: 障害ケースなし ✅ 完全なエラーハンドリング: すべてのエラーシナリオを指定

❌ 例なし: 指示のみ ✅ 豊富な例: 複数のユースケースをデモ

検証チェックリスト

  • [ ] すべてのメタデータフィールドが存在
  • [ ] 指示が番号付けされ明確
  • [ ] 少なくとも 2 つの使用例を提供
  • [ ] バージョン付きの依存関係をリスト
  • [ ] エラーハンドリングを文書化
  • [ ] セキュリティ考慮事項に注意

リソース

読書時間: 4分

著者: ClaudeSkills Team
SKILL.md ファイル形式完全ガイド