skill-creator完全ガイド - Claude Skills開発フレームワーク実践解説¶

この記事は2026年1月時点の情報です

Skills/Pluginのインストール方法やマーケットプレイスの仕様は更新されている場合があります。最新のSkills導入方法は SkillsMP（Agent Skills Marketplace）完全ガイド をご参照ください。

2026年3月更新: skill-creatorに評価パイプライン（eval/improve/benchmarkモード）が追加されました。新版の解説は skill-creator新版解説 - 評価パイプラインで変わるSkill開発 をご覧ください。

このガイドで分かること¶

skill-creatorとは何か - 対話形式でSkillを生成するツール
どうやって使うか - 2つのアプローチ（ゼロから作る / 会話から作る）
生成されたSkillをどう改善するか - 構造理解とカスタマイズ方法

skill-creatorの最大のメリット

あなたは「こういうSkillが欲しい」と伝えるだけ。 skill-creatorが対話形式でヒアリングし、SKILL.mdとディレクトリ構造を自動生成します。設計原則やフォーマットを事前に覚える必要はありません。

skill-creatorとは¶

skill-creatorは「対話でSkillを作るツール」です。

あなたがやること¶

「○○のスキルを作りたい」とClaude Codeに伝える
skill-creatorからの質問に答える
生成されたSkillをテスト・改善する

skill-creatorがやること¶

要件をヒアリングする（何を作りたいか、いつ発動するか等）
設計原則に基づいてSKILL.mdを自動生成
適切なディレクトリ構造（scripts/, references/, assets/）を作成
必要なスクリプトのテンプレートを生成

sequenceDiagram
    participant You as あなた
    participant SC as skill-creator
    participant Output as 生成物

    You->>SC: 「PDF処理のスキルを作って」
    SC->>You: 「どんな機能が必要ですか？」
    You->>SC: 「回転、テキスト抽出、結合」
    SC->>You: 「いつ発動すべきですか？」
    You->>SC: 「PDFを編集してと言われたとき」
    SC->>Output: SKILL.md + scripts/ を生成
    Output->>You: 完成したSkillを確認・テスト

初めて使う場合

「コア設計原則」や「Skillの構造」を事前に理解する必要はありません。skill-creatorが適切に生成してくれます。

これらの情報は、生成されたSkillを手直しするときに参照してください。

インストール¶

Claude Codeでの導入¶

# マーケットプレイスを追加
/plugin marketplace add anthropics/skills

# example-skillsをインストール（skill-creator含む）
/plugin install example-skills@anthropic-agent-skills

# オプション: document-skillsも追加（DOCX/PDF操作等）
/plugin install document-skills@anthropic-agent-skills

インストール後、Claude Codeを再起動し、/skillsコマンドでskill-creatorが表示されれば完了です。

ライセンスについて

example-skills: Apache 2.0（オープンソース、自由に改変・再配布可能）
document-skills: Source-available（参照・学習用、再配布制限あり）

使い方：2つのアプローチ¶

skill-creatorには2つの使い方があります。状況に応じて選んでください。

アプローチ1：ゼロから作る（対話形式）¶

新しいSkillを一から作りたいときに使います。

skill-creatorを使って、PDF処理のスキルを作って

skill-creatorが対話形式で質問します：

「どのような機能をサポートしますか？」
「いつこのSkillを発動させますか？」
「スクリプトは必要ですか？」

あなたは質問に答えるだけで、SKILL.mdとディレクトリ構造が自動生成されます。

対話例¶

あなた: skill-creatorを使って、コードレビューのスキルを作りたい

skill-creator: コードレビュースキルを作成しますね。いくつか質問させてください。

1. どのような観点でレビューしますか？
   （例：セキュリティ、パフォーマンス、可読性、テストカバレッジ等）

あなた: セキュリティとパフォーマンスを重視したい

skill-creator: 
2. このスキルはいつ発動すべきですか？
   （例：「コードレビューして」「PRを確認して」等）

あなた: 「レビューして」「コードチェックして」と言われたとき

skill-creator: 了解しました。以下の構造でSkillを生成します...
[SKILL.md と scripts/security_check.py を自動生成]

アプローチ2：会話から作る¶

AIとの対話でうまくいったパターンをSkill化したいときに使います。

（うまくいった会話の後に）
これまでの会話の流れをskill-creatorを使ってスキル化して

skill-creatorが自動的に：

会話パターンを分析
再利用可能なワークフローを抽出
SKILL.mdテンプレートを生成

活用シーン¶

シーン	例
複雑な分析フロー	データ分析→可視化→レポート生成の一連の流れ
トラブルシューティング	エラー解決までの対話パターン
コードレビュー	レビュー観点の抽出とチェックリスト化

会話からSkill化のメリット

観点	Skill化前	Skill化後
再現性	毎回同じ説明が必要	一貫したワークフロー
品質	対話によるばらつき	標準化された手順
共有	個人の暗黙知	チームで共有可能

生成後の流れ¶

Skillが生成されたら、以下の流れで使用・改善します。

Step 1: 生成されたSkillを確認¶

# 生成されたディレクトリ構造を確認
ls -la skills/my-new-skill/

# SKILL.mdの内容を確認
cat skills/my-new-skill/SKILL.md

Step 2: テストして使ってみる¶

実際のタスクでSkillを使用し、動作を確認します。

「PDFを回転して」（←Skillがトリガーされるはず）

Step 3: 必要に応じて改善¶

期待通りに動かない場合や改善したい場合は：

SKILL.mdを編集してトリガー条件や手順を調整
scripts/にスクリプトを追加・修正
references/に参照ドキュメントを追加

改善時に参照すべき情報

以下の「参照セクション」で、Skillの構造や設計原則を確認してください。

【参照】改善・カスタマイズ時に知っておくこと¶

このセクションの読み方

以下の内容は、skill-creatorが生成したSkillを手直しするときに参照してください。初回生成時はskill-creatorがこれらの原則を考慮して自動生成します。

Skillの構造¶

必須ファイル：SKILL.md¶

---
name: skill-name          # 必須：ハイフンケース識別子（64文字以下）
description: ...          # 必須：トリガー条件含む説明（200文字推奨、最大1024文字）
license: LICENSE.txt参照   # オプション
allowed-tools: [...]      # オプション：許可ツールリスト
metadata: {...}           # オプション：カスタムメタデータ
---

# Skill Name

## 概要
[Skillの機能を1-2文で説明]

## ワークフロー
[手順やガイダンス]

descriptionの重要性

descriptionはSkillのトリガー条件を決定する最重要要素です。「いつ使用するか」の情報は必ずここに含めてください。本文はトリガー後にロードされるため、本文の「使用場面」セクションはClaudeに届きません。

ディレクトリ構造¶

skill-name/
├── SKILL.md              # 必須：メタデータと指示
├── scripts/              # オプション：実行可能コード
├── references/           # オプション：参照ドキュメント
└── assets/               # オプション：出力用ファイル

scripts/references/assets/

実行可能コード（Python/Bash等）

決定論的信頼性が必要なコード
繰り返し使用するユーティリティ
例: rotate_pdf.py, extract_text.py

参照ドキュメント

作業中にClaudeが参照すべき情報
APIドキュメント、スキーマ定義等
例: schema.md, api_docs.md

出力用ファイル

Claudeの出力で使用するファイル
テンプレート、ロゴ、ボイラープレート
例: template.pptx, boilerplate/

コア設計原則¶

1. 簡潔さを最優先する¶

Claudeは既に非常に賢いため、Claudeが本来持っていない情報のみを追加します。

❌ 冗長な説明✅ 簡潔な例示

PDFファイルを回転させるには、まずPDFライブラリをインポートする
必要があります。Pythonには様々なPDFライブラリがありますが...

PDF回転: `scripts/rotate_pdf.py 90 input.pdf output.pdf`

2. 適切な自由度を設定する¶

自由度	使用場面	形式
高	複数アプローチが有効	テキストベース指示
中	推奨パターンあり	擬似コード
低	一貫性必須	具体的スクリプト

3. 決定論的処理はスクリプト化する¶

最も重要な設計原則の一つです。AIは賢いですが、同じ入力でも毎回微妙に異なる出力を返す可能性があります。

AI判断の揺らぎ

文字数カウント → 毎回計算方法が微妙に異なる可能性
ファイル検証 → チェック項目の抜け漏れ
フォーマット変換 → 出力形式のばらつき

100%同じ結果が必要な処理は、SKILL.mdのテキスト指示ではなく scripts/ にスクリプトとして実装します。

❌ テキスト指示（揺らぎあり）✅ スクリプト化（決定論的）

## 文字数チェック
記事の文字数を数えて、2000-3000文字の範囲か確認してください。

## 文字数チェック
`python scripts/check_article.py <file>` を実行

スクリプト化の判断基準:

処理タイプ	スクリプト化すべきか	理由
文字数・行数カウント	✅ 必須	毎回同じ結果が必要
構文チェック	✅ 必須	漏れなく全項目を検出
ファイル変換	✅ 推奨	出力形式の一貫性
文章推敲	❌ 不要	AI判断が適切
設計レビュー	❌ 不要	文脈理解が必要

4. 段階的情報開示¶

graph LR
    A[Level 1: メタデータ<br/>~100トークン・常時ロード] --> B[Level 2: SKILL.md本文<br/><5000トークン・トリガー時]
    B --> C[Level 3: バンドルリソース<br/>無制限・必要時]

    style A fill:#e1f5fe
    style B fill:#fff3e0
    style C fill:#e8f5e9

トークン消費に注意

Level 1のメタデータはSkill未使用時でも常にコンテキストに読み込まれます。1 Skillあたり約100トークンを消費するため、不要なSkillは定期的にアンインストールしてください。

開発ツール（手動操作用）¶

いつ使うか

skill-creatorを使う場合、これらのスクリプトは自動的に呼び出されます。以下のケースで手動実行が必要です：

skill-creatorを使わずゼロから作る場合
生成されたSkillを手動で検証・パッケージングする場合

init_skill.py - 初期化¶

python scripts/init_skill.py <skill-name> --path <output-directory>

quick_validate.py - 検証¶

python scripts/quick_validate.py <skill-directory>

検証項目:

項目	チェック内容
SKILL.md存在	ファイルが存在するか
YAMLフロントマター	正しい形式か
必須フィールド	`name`と`description`があるか
命名規則	ハイフンケース（小文字、数字、ハイフン）
予約語禁止	`name`に予約語（`anthropic`, `claude`）を含まない
文字数制限	name: 64文字以下、description: 200文字推奨/最大1024文字

公式ドキュメント間の矛盾

description文字数制限は、Help Center「200文字」、Docs「最大1024文字」と記載が異なります。200文字を目安に簡潔に書くのが安全です。

package_skill.py - パッケージング¶

python scripts/package_skill.py <skill-directory> [output-directory]

本文の構造パターン¶

ワークフローベースタスクベースリファレンスベース

シーケンシャルなプロセス向け：

## 概要 → ## 判断フロー → ## Step 1 → ## Step 2...

独立した操作群向け：

## 概要 → ## クイックスタート → ## タスク1 → ## タスク2...

標準・仕様向け：

## 概要 → ## ガイドライン → ## 仕様 → ## 使用例...

Progressive Disclosureパターン¶

SKILL.mdは5000トークン以下（約500行）を目標とし、詳細は分離します。

パターン1: ハイレベルガイド + リファレンス

## 高度な機能
- **フォーム入力**: [FORMS.md](FORMS.md)参照
- **APIリファレンス**: [REFERENCE.md](REFERENCE.md)参照

パターン2: ドメイン別構成

bigquery-skill/
├── SKILL.md
└── references/
    ├── finance.md
    ├── sales.md
    └── product.md

skill-creatorを使うべきか判断する¶

適しているケース（Fit）¶

ケース	理由
繰り返し発生するタスク	Skill化のコストを回収できる
手順が明確なワークフロー	SKILL.mdで手順化しやすい
コード実行を伴うタスク	scripts/ディレクトリで再利用可能
チーム内で共有したい知識	Skillとして配布・展開できる

適さないケース（Gap）¶

ケース	理由	代替案
一度きりのタスク	コストに見合わない	通常のプロンプト
頻繁に変わる要件	メンテナンスコストが高い	Memory / Projects
外部APIとの連携が主	MCPの方が適切	MCP
機密情報を含むタスク	セキュリティリスク	セキュアな方法を検討

判断基準

「このタスクを3回以上繰り返すか？」 がSkill化の目安です。

セキュリティに関する注意¶

Skillsはコード実行を伴うため、セキュリティには十分な注意が必要です。

信頼できるソースのみ使用

Anthropicは、自作したSkillまたはAnthropic公式のSkillのみを使用することを強く推奨しています。

セキュリティチェックリスト¶

APIキー・パスワード・シークレットをハードコードしていないか
外部ネットワークへの意図しない接続がないか
ファイルアクセスの範囲は適切か
第三者のSkillを使う場合、scripts/内のコードを監査したか

安全なシークレット管理¶

# ❌ 悪い例：ハードコード
API_KEY = "sk-1234567890abcdef"

# ✅ 良い例：環境変数から取得
import os
API_KEY = os.environ.get("API_KEY")

利用可能な公式Skills¶

カテゴリ	主なSkill	用途
Meta	skill-creator	Skill作成支援
Development	mcp-builder	MCPサーバー構築
Creative	algorithmic-art	ジェネレーティブアート
Document	docx, pdf, pptx, xlsx	ドキュメント操作

最新情報は公式ドキュメントで確認してください。

プラットフォーム間の差異¶

機能	Claude Code	Claude.ai	API
SKILL.md読み込み	✅ ローカル	✅ アップロード	✅ system prompt
scripts/ 実行	✅ 直接実行	⚠️ Code Execution有効時	⚠️ Code Execution tool併用時
references/ 参照	✅ 自動読込	⚠️ 手動添付	⚠️ 手動含める

APIでのSkills利用

APIではskill_idをcontainerパラメータで指定し、code execution toolと組み合わせることでscripts/の実行も可能です。

ベストプラクティスまとめ¶

カテゴリ	推奨事項
簡潔さ	Claudeが知らない情報のみ追加
トリガー	`description`に使用場面を明記（200文字推奨）
構造	SKILL.md 5000トークン以下、詳細は分離
フィールド	`name`は予約語（`anthropic`, `claude`）禁止
テスト	生成後は必ず動作確認