Skill Creator

スキル作成ツール

スキル作成ツールは、ID8Labs の標準に従って、新しい Claude Code スキルを設計、構築、文書化するのに役立ちます。コンセプトから実装まで、スキル作成の全工程をガイドし、スキルが適切に構成され、正しく文書化され、Claude Code エコシステムにシームレスに統合されるようにします。

このスキルは、命名規則、ファイル構成、ワークフロー設計、ドキュメント作成に関するベストプラクティスを徹底しながら、スキル作成に必要な定型作業を自動化します。スキル設計に関する判断を整理し、適切な複雑さのレベルを見極め、明確なトリガーを定義し、スキルを使いやすく保守しやすくする包括的なドキュメントを作成するのに役立ちます。

繰り返し発生する問題を解決したり、複雑なタスクを自動化したりする、新しい再利用可能なワークフローで Claude Code の機能を拡張したいときは、いつでもこのスキルを使ってください。

主なワークフロー

ワークフロー 1：コンセプトから新しいスキルを設計する

1. スキルの目的を明確にします：
   • どのような問題を解決しますか？
   • 誰が使いますか？
   • 主なワークフローは何ですか？
2. スキルのメタデータを定義します：
   • 名前（明確で説明的なもの）
   • スラッグ（ケバブケース）
   • カテゴリ（開発、運用、メタなど）
   • 複雑さ（シンプル、複雑、マルチエージェント）
   • トリガー（自然言語のフレーズ）
   • タグ（検索用）
3. 主なワークフローを設計します：
   • 主なワークフローを 2～4 個特定します
   • 手順を順を追って整理します
   • 入力と出力を定義します
   • 依存関係（ツール、MCP、その他のスキル）を特定します
4. ドキュメントの構成を設計します：
   • 概要とユースケース
   • ワークフローの詳細
   • クイックリファレンス表
   • ベストプラクティス
   • 例
5. ドキュメントをすべて含むスキルファイルを作成します
6. スキルの統合をテストします
7. 使用状況に基づいて反復します

ワークフロー 2：テンプレートからスキルのひな形を作成する

1. 基本要件を収集します：
   • スキル名と目的
   • カテゴリ
   • 主なワークフロー
2. テンプレートから SKILL.md を生成します：
   • メタデータを含むフロントマター
   • 説明セクション
   • 主なワークフローセクション
   • クイックリファレンス表
   • ベストプラクティスのリスト
3. ディレクトリ構成を作成します：
   • /skills/[slug]/SKILL.md
   • 必要に応じて追加ファイル（例、テンプレート）
4. プレースホルダーの内容を入力します
5. 詳細を入力するようユーザーをガイドします

ワークフロー 3：既存のワークフローをスキルにリファクタリングする

1. 既存のワークフローを分析します：
   • どの手順が繰り返されていますか？
   • どのような知識が必要ですか？
   • 何を自動化できますか？
2. 再利用可能なパターンを抽出します
3. より幅広いユースケースに対応できるよう一般化します
4. 正式なスキルとして文書化します
5. 変動する要素をパラメーター化します
6. 元のユースケースとそのバリエーションでテストします
7. スキルディレクトリにデプロイします

ワークフロー 4：スキルの品質レビュー

1. メタデータが完全か確認します：
   • 必須のフロントマターフィールドがすべて存在する
   • トリガーが自然で見つけやすい
   • タグが適切で一貫している
2. ドキュメントをレビューします：
   • 目的が明確に説明されている
   • ワークフローが適切に定義されている
   • ベストプラクティスが実行可能である
   • 例が役に立つ
3. 構成を検証します：
   • 標準的な SKILL.md 形式に従っている
   • Markdown の書式が適切である
   • 構成に論理性がある
4. 機能をテストします：
   • トリガーが期待どおりに機能する
   • ワークフローを実行できる
   • 依存関係を利用できる
5. 改善点を提案します
6. 承認するか、修正を依頼します

クイックリファレンス

アクション	コマンド／トリガー
新しいスキルを作成する	「[目的] のスキルを作成して」
テンプレートからひな形を作成する	「[名前] というスキルのひな形を作成して」
既存のスキルをレビューする	「このスキルをレビューして：[パスまたは内容]」
ワークフローをスキルに変換する	「このワークフローをスキルにして：[ワークフロー]」
スキルのメタデータを生成する	「[スキルのコンセプト] のメタデータを生成して」
スキルのワークフローを設計する	「[スキルの目的] のワークフローを設計して」
スキルの構成を検証する	「このスキルファイルを検証して：[パス]」

ベストプラクティス

• わかりやすい名前を付ける：スキル名を見れば、すぐに内容が理解できるようにします

  • 良い例：「Database Designer」、「API Tester」、「Deployment Automation」
  • 悪い例：「Helper」、「Tool」、「Manager」

• 適切な複雑さを選ぶ：

  • シンプル：単一のワークフロー、最小限の依存関係、わかりやすい実行手順
  • 複雑：複数のワークフロー、外部ツール、条件分岐
  • マルチエージェント：ほかのスキルやエージェントを連携させるオーケストレーション層

• 自然なトリガーを定義する：ユーザーが実際に使いそうなフレーズを使用します

  • バリエーションを含めます：「コードをレビュー」、「コードレビュー」、「このコードをレビュー」
  • 過度に形式ばった表現は避けます
  • 可能であれば、実際のユーザーでテストします

• ワークフローを手順ごとに記述する：各ワークフローを実行可能なものにします

  • 手順に番号を付けます
  • 動作を表す動詞を使います
  • 入力と出力を具体的に記述します
  • 判断が必要な箇所を含めます

• クイックリファレンスを用意する：ユーザーがドキュメント全体を読む必要がないようにします

  • よく使う操作を表形式でまとめます
  • コピーして貼り付けられるコマンドを記載します
  • 明確で簡潔な説明を付けます

• 例を含める：実際の使用方法を示します

  • 使用前と使用後のシナリオ
  • よくあるユースケース
  • 関連する場合はエッジケース

• タグを慎重に選ぶ：ユーザーがスキルを見つけやすくします

  • 可能であれば、既存のカテゴリタグを使います
  • 具体的なタグを3～5個追加します
  • ユーザーが検索に使いそうな語句を検討します

• 適切にバージョン管理する：セマンティックバージョニングに従います

  • 初回リリースは1.0.0から開始します
  • バグ修正ではパッチバージョンを上げます
  • 新しいワークフローの追加ではマイナーバージョンを上げます
  • 互換性を損なう変更ではメジャーバージョンを上げます

スキルのメタデータリファレンス

必須のFrontmatterフィールド

name: Human-Readable Name
slug: kebab-case-identifier
description: One-line description (under 100 chars)
category: development | operations | meta | design | data | testing
complexity: simple | complex | multi-agent
version: "1.0.0"
author: "ID8Labs"
triggers:
  - "natural language trigger 1"
  - "natural language trigger 2"
tags:
  - relevant-tag-1
  - relevant-tag-2

任意のFrontmatterフィールド

dependencies:
  tools:
    - playwright
    - supabase
  mcps:
    - firecrawl
    - github
  skills:
    - other-skill-slug
requires_config:
  - ENV_VAR_NAME: "Description of what this is for"
examples_dir: "./examples"

スキルのカテゴリ

カテゴリ	目的	例
development	開発とコーディング	コードレビュー、スキャフォールディング、リファクタリング
operations	デプロイとインフラストラクチャ	CI/CD、モニタリング、デプロイ
meta	AI／スキルに関するスキル	プロンプトエンジニアリング、ワークフロー設計
design	UI/UXとクリエイティブ作業	コンポーネント設計、デザインシステム
data	データベースとデータのワークフロー	スキーマ設計、マイグレーション、クエリ
testing	品質保証	テスト生成、E2Eテスト
content	執筆とドキュメント作成	テクニカルライティング、マーケティングコピー

よくあるスキルパターン

シンプルなパターン：単一のアクション

## Core Workflows

### Workflow 1: Execute [Action]
1. Receive input
2. Process input
3. Return output

複雑なパターン：分岐を含む複数ステップ

## Core Workflows

### Workflow 1: [Primary Action]
1. Analyze input
2. **If** [condition]:
   - Path A
3. **Else**:
   - Path B
4. Synthesize results
5. Validate output

マルチエージェントパターン：オーケストレーション

## Core Workflows

### Workflow 1: Coordinate [Task]
1. Assess requirements
2. **Delegate** to Skill A for [subtask]
3. **Delegate** to Skill B for [subtask]
4. **Monitor** progress
5. **Integrate** results
6. Validate final output

スキルのテスト

スキルを完成と見なす前に、次の項目を確認します。

1. トリガーをテストする：フレーズによってスキルが起動することを確認します
2. ワークフローを実行する：各ワークフローを最後まで実行します
3. 依存関係を確認する：必要なツールがすべて利用可能であることを確認します
4. ドキュメントを検証する：ほかの人に読んでもらい、実際に使ってもらいます
5. エッジケースを確認する：特殊な入力や複雑な入力でテストします
6. 統合を確認する：関連するスキルと連携して動作することを確認します
7. パフォーマンスを確認する：ボトルネックが発生しないことを確認します

スキルのメンテナンス

スキルは使用状況に応じて進化させます。

• 問題を追跡する：ワークフローが失敗したり、ユーザーを混乱させたりした場合に記録します
• フィードバックを集める：不足している点や不明瞭な点をユーザーに尋ねます
• ドキュメントを更新する：例やベストプラクティスを最新の状態に保ちます
• 慎重に非推奨にする：置き換える場合は、移行ガイドを用意します
• バージョンを明確にする：互換性を損なう変更を記録します