スキルクリエイター

概要

専門的な知識、ワークフロー、ツールを通じて Claude の能力を拡張する効果的なスキルを作成します。スキルはモジュール化されたパッケージで、汎用エージェントとしての Claude を特定分野における手続き的な知識を持つ専門エージェントに変換します。

このスキルは自らの教えを実践しています。 進行的な情報開示を使用してエントリーポイントを簡潔に保ちながら、参考資料ファイルで詳細な内容を提供しています。

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

以下の場合に有効化してください：

• 新しいスキルを一から作成する場合
• 既存のスキルを更新または再構築する場合
• 単一の大規模なスキルに進行的な情報開示を追加する場合
• スキルの構造とベストプラクティスを理解する場合
• スキルコンポーネント（スクリプト、参考資料、アセット）を計画する場合
• 配布用のスキルをパッケージ化する場合

核心原則

1. 例駆動設計: 抽象的な概念ではなく、具体的な使用例から始める
2. 進行的な情報開示: エントリーポイントは 200 行以下（最適：140～160 行）に保ち、詳細な内容は参考資料に
3. 再利用可能なコンポーネント: 繰り返されるコードはスクリプトに、知識は参考資料に、テンプレートはアセットに抽出
4. 命令形の表現: 常に動詞から始まる指示を使用（二人称は避ける）
5. 目的に特化したリソース: 各コンポーネントは特定の反復的なニーズを解決する

スキルが提供する機能

4 つの主要な機能：

1. 専門的なワークフロー - 特定分野向けの複数ステップの手順
2. ツール統合 - ファイル形式または API との連携方法
3. ドメイン専門知識 - 企業固有の知識、スキーマ、ビジネスロジック
4. バンドルリソース - 複雑なタスク向けのスクリプト、参考資料、アセット

3 段階のロード方式：

1. メタデータ（名前 + 説明） - 常にコンテキストに含まれます（約 100 単語）
2. SKILL.md 本文 - スキルがトリガーされた時（200 行以下、最適：140～160 行）
3. バンドルリソース - Claude が必要に応じて（無制限）

クイックスタート

6 ステップの作成プロセス

ステップ 1: 具体例で理解する 3～5 つの現実的な使用例を集めます。「ユーザーはこのスキルをどのように呼び出すか」「どのようなタスクを達成すべきか」と問いかけてください → 完全ガイド

ステップ 2: 再利用可能なコンポーネントを計画する 例を分析して以下を特定します：スクリプト（繰り返されるコード）、参考資料（ドメイン知識）、アセット（テンプレート） → 計画ガイド

ステップ 3: スキルを初期化する scripts/init_skill.py <skill-name> --path <output-directory> を実行してテンプレート構造を生成します → 初期化の詳細

ステップ 4: スキルを編集する スクリプト/参考資料/アセットを実装してから、命令形を使用して SKILL.md を更新します。150 行を超える場合は進行的な情報開示を適用してください → 編集ガイド

ステップ 5: パッケージ化と検証 scripts/package_skill.py <path/to/skill-folder> を実行して検証し、配布可能な zip を作成します → パッケージングガイド

ステップ 6: 反復する 実際のタスクで使用し、問題を認識し、それに応じてスキルを更新してください → 反復ガイド

スキルの構成

skill-name/
├── SKILL.md (必須)               # フロントマター + Markdown を含むエントリーポイント
├── scripts/ (オプション)         # 実行可能なコード（Python/Bash）
├── references/ (オプション)      # 必要に応じてロードされるドキュメント
└── assets/ (オプション)          # 出力で使用されるテンプレート、画像、ファイル

コンポーネントガイドライン：

• スクリプト: 同じコードが繰り返し作成される場合、または確定的な実行が必要な場合
• 参考資料: 詳細な仕様、ワークフロー、スキーマ、API ドキュメント（150～500 行）
• アセット: 出力で使用されるテンプレート、ボイラープレート、画像、フォント
• エントリーポイント: コアワークフロー、ナビゲーション、リマインダー（最適：140～160 行）

→ 完全な構造ガイド

進行的な情報開示パターン

適用条件: 全体で 150 行を超えるスキル

実装方法：

1. フロントマターに progressive_disclosure 設定で summary、when_to_use、quick_start を追加
2. エントリーポイントを 140～160 行（コアワークフロー + ナビゲーション）に削減
3. 3～5 つの参考資料ファイルを作成（150～500 行ずつ）
4. 主題別に整理：構造、ワークフロー、ベストプラクティス、例
5. すべての参考資料へのリンクを含むナビゲーションセクションを追加

メリット：

• エントリーが必須コンテンツのみをロード
• 必要に応じて詳細な情報にアクセス可能
• より良い組織化と保守性
• エントリーポイントサイズが 20～30% 削減

→ 完全な進行的情報開示ガイド

メタ例: このスキルクリエイターは進行的な情報開示を実践しています：

• エントリー: 150 行（209 行から 28% 削減）
• 参考資料: 完全な実装詳細を含む 5 ファイル
• 最近最適化されたもの: mcp-builder（160 行）、testing-anti-patterns（140 行）

ナビゲーション

コアコンセプト

• 🏗️ スキル構造 - 構成、コンポーネント（スクリプト/参考資料/アセット）、進行的情報開示アーキテクチャ。スキルレイアウトを計画する際やリソースタイプを理解する際にロードしてください。

ステップバイステップの手順

• 🔄 作成ワークフロー - 例から反復までの完全な 6 ステップ。新しいスキルを作成する際や構造化されたワークフローに従う際にロードしてください。

デザインパターン

• 📊 進行的な情報開示 - 3 段階のロード、実装ガイド、アンチパターン、例。150 行を超えるスキルをリファクタリングしたりコンテキスト使用を最適化したりする際にロードしてください。

品質基準

• ✅ ベストプラクティス - 表記スタイル、メタデータの品質、コンテンツ組織、アンチパターン。スキルコンテンツを書く/レビューしたり品質を確保したりする際にロードしてください。

実世界の例

• 📚 例 - 完全なスキル例：mcp-builder、testing-anti-patterns、pdf-editor、brand-guidelines、database-builder、frontend-builder。新しいスキルを開始する際やパターンを探す際にロードしてください。

重要なリマインダー

• 例から始める - 設計前に 3～5 つの具体的な使用シナリオを用意する
• init スクリプトを使用 - scripts/init_skill.py は適切な構造を自動的に作成
• 命令形を使用 - 「X を達成するには Y を実行」（「X をすべき」ではなく）
• 進行的な情報開示 - エントリー 200 行未満、詳細は参考資料に（150 行を超えるスキルの場合）
• 重複を避ける - 情報は 1 つの場所に存在（エントリー要約、参考資料詳細）
• コンポーネントの明確性 - コード用スクリプト、知識用参考資料、テンプレート用アセット
• 共有前に検証 - scripts/package_skill.py で検証してからパッケージ化
• 継続的に反復 - 実際のタスクで使用し、問題に基づいて更新

危険信号 - 中止する

以下の場合は中止してください：

• 「すべての詳細を SKILL.md に書きます」→ 参考資料に移動（進行的情報開示）
• 「二人称を使用します」→ 命令形に切り替え
• 「エントリーと参考資料に同じ情報がある」→ 重複を削除
• 汎用的な説明を使用 → 起動条件について具体的に
• init スクリプトからの例ファイルを残す → 未使用リソースを削除
• 検証をスキップ → 共有前に常に package_skill.py を実行
• 例なしでスキルを作成 → 具体的な使用シナリオを集める
• エントリーポイント 200 行超 → 進行的情報開示パターンを適用

これらはすべて以下を意味します：中止する。原則と参考資料を確認してください。

他のスキルとの統合

メタスキル：

• skill-creator（このスキル） - 他のスキルを作成し、自らのパターンを実証

開発スキル：

• mcp-builder - 進行的情報開示実装の例
• testing-anti-patterns - 超簡潔なエントリーポイント（140 行）の例

ワークフロースキル：

• documentation - 明確で構造化されたコンテンツの作成
• verification-before-completion - パッケージ化前のスキルテスト

実世界での影響

スキル最適化の経験から：

• 進行的情報開示: エントリーポイントサイズが 20～30% 削減
• mcp-builder: 209 → 160 行（23% 削減、6 参考資料）
• testing-anti-patterns: → 140 行（4 参考資料を含む超簡潔版）
• skill-creator: 209 → 150 行（28% 削減、5 参考資料）
• コンテキスト効率: 必要な参考資料のみロード（50～80% コンテキスト節約）
• 保守性: エントリーポイントに触れずに特定の参考資料を更新可能
• 明確性: より良い組織化により発見可能性と理解が向上

---

注意: スキルはモジュール化されたパッケージで、Claude を専門エージェントに変換します。150 行を超えるスキルに進行的な情報開示を適用してください。このスキルは自らが教えるパターンを実践しています。