skill-creator

スキル作成ツール

高品質な Claude スキルを作成するための対話型ガイドです。

このスキルを使用する場面

以下の場合にこのスキルを使用してください：

• ユーザーが新しい Claude スキルを作成したい場合
• ユーザーが既存のスキルを更新または改善したい場合
• スキルの構成やベストプラクティスについてガイダンスが必要な場合
• 特定のワークフロー向けに Claude の機能を拡張したい場合

スキルの構成

すべてのスキルは、必須の SKILL.md ファイルと、任意で同梱するリソースで構成されます。

skill-name/
├── SKILL.md (required)
│   ├── YAML frontmatter metadata (required)
│   │   ├── name: (required)
│   │   └── description: (required)
│   └── Markdown instructions (required)
└── Bundled Resources (optional)
    ├── scripts/ - Executable code (Python/Bash/etc.)
    ├── references/ - Documentation loaded into context as needed
    └── assets/ - Files used in output (templates, icons, fonts, etc.)

必須コンポーネント

フロントマター（YAML）

---
name: my-skill-name
description: A clear, comprehensive description of what this skill does and when to use it
---

重要：description フィールドをもとに、Claude はそのスキルをいつ使用するかを判断します。以下について具体的かつ包括的に記述してください。

• スキルの機能
• 使用すべき場面
• スキルを呼び出すクエリの種類
• 生成する出力

本文（Markdown）

Markdown の内容には、以下を含めます。

• 指示：スキルの使用方法に関する手順
• 例：具体的な使用例
• ガイドライン：ベストプラクティスとルール
• ワークフロー：詳細な手順

任意で同梱するリソース

1. scripts/

含める場面：スキルで実行可能なコードが必要な場合

例：

• scripts/analyzer.py - Python によるデータ分析スクリプト
• scripts/formatter.sh - Bash によるフォーマット用ユーティリティ
• scripts/validator.js - JavaScript による検証ツール

ルール：

• 同梱する前にテストすること
• 十分なドキュメントを用意すること
• エラー処理を含めること

2. references/

含める場面：SKILL.md が冗長になるのを避けるため、詳細な参考資料が必要な場合

例：

• references/schema.md - データベーススキーマのドキュメント
• references/api-spec.md - API エンドポイントのリファレンス
• references/examples.md - 詳細な例

ルール：

• 詳細情報はここに移し、SKILL.md は簡潔に保つこと
• SKILL.md と references/ の間で重複を避けること
• スキーマ、仕様、詳細な例に使用すること

3. assets/

含める場面：スキルで出力に使用するファイルが必要な場合

例：

• assets/logo.png - ブランド素材
• assets/template.pptx - PowerPoint テンプレート
• assets/boilerplate/ - HTML/React のスターターコード
• assets/fonts/ - カスタムフォント

ルール：

• 最終出力で使用するファイルに限ること
• ドキュメントには使用しないこと（代わりに references/ を使用）
• テンプレート、画像、アイコン、ボイラープレートコードに使用すること

作成ワークフロー

ステップ 1：ユースケースを分析する

明確にするための質問をします。

1. このスキルで処理する具体的なタスクは何ですか？
2. ユーザーからのクエリの具体例を 3～5 個挙げてください。
3. このタスクが反復的、または専門的である理由は何ですか？
4. どのようなコンテキストや知識が必要ですか？
5. 統合できる既存のツールや API はありますか？

ステップ 2：再利用可能なリソースを特定する

具体例ごとに、以下を特定します。

• 役立つスクリプト
• 必要な参考ドキュメント
• 含めるテンプレートや素材

ステップ 3：構成を作成する

1. SKILL.md のフロントマターから始めます
2. 明確で包括的な説明を記述します
3. 指示のセクションを追加します
4. 必要に応じて scripts/ を作成します
5. 詳細なドキュメント用に references/ を追加します
6. テンプレート用に assets/ を含めます

ステップ 4：スキルをテストする

1. すべてのスクリプトをテストし、動作することを確認します
2. 参考資料に不足がないことを確認します
3. 素材が適切な形式であることを確認します
4. SKILL.md の指示が明確であることを確認します

ベストプラクティス

説明の書き方

✅ 良い説明： 「12 段階のパイプラインを使用して、Brevard County の抵当権実行競売を分析します。AcclaimWeb で先取特権を検索し、ARV の計算式で最高入札額を算出し、BID／REVIEW／SKIP の推奨を生成します。抵当権実行物件の分析、最高入札額の算出、競売レポートの作成に使用します。」

❌ 悪い説明： 「抵当権実行の分析を支援します」

指示の書き方

• 具体的で実行可能な内容にする
• 具体例を含める
• ワークフローを段階的に定義する
• 使用する場面と使用しない場面を説明する
• 成功基準を提示する

リソースの整理

• SKILL.md は手順に焦点を絞る
• 詳細なドキュメントは references/ に移す
• 同梱する前にすべてのスクリプトをテストする
• 素材を論理的に整理する

よくあるスキルのパターン

1. ドメインエキスパートスキル

焦点：特定分野の専門知識 リソース：分野のドキュメントや例を含む references/ 例：foreclosure-analysis、medical-coding

2. ワークフロー自動化スキル

焦点：繰り返し実行できる複数ステップのプロセス リソース：自動化用の scripts/、assets/ 内のテンプレート 例：git-workflow、deployment-checklist

3. インテグレーションスキル

焦点：外部 API／ツールの利用 リソース：API ドキュメントを含む references/、API 呼び出し用の scripts/ 例：stripe-integration、supabase-setup

4. テンプレート／ボイラープレートスキル

焦点：プロジェクトの出発点 リソース：テンプレートを含む assets/、ドキュメントを含む references/ 例：react-boilerplate、brand-guidelines

例

以下のスキルを参考にしてください。

• frontend-design：美的ガイドラインに沿ったクリエイティブなワークフロー
• mcp-builder：詳細な仕様を含む技術的なインテグレーション
• docx：スクリプトを使った複雑なファイル操作
• brand-guidelines：アセットとリファレンスの組み合わせ