skill-creator

モード：スクリプト優先 - 新しいスキルを作成する際は、正規の手順として scripts/create.cjs を使用し、その後、このガイドを使って調査、レビュー、統合作業を進めます。

スキルクリエーター

ルーティング、カタログ、レジストリへの統合を省略せずに、マルチエージェントエコシステム向けのスキルを作成、検証、インストール、変換します。

目的

このスキルは、以下の用途に使用します。

1. 新しいスキルをゼロから作成する。
2. MCP サーバーや外部コードベースをスキルに変換する。
3. GitHub からスキルをインストールする。
4. 既存のスキル定義を検証する。
5. 関連するフック、スキーマ、付属アーティファクトを割り当てる、または登録する。

参考ドキュメント

• 調査ゲートの詳細 - 保持されている調査ゲート、セキュリティスキャン、エビデンス品質、型付きアーティファクト検索に関するガイダンスです。
• エンタープライズバンドルの詳細 - 保持されているスキャフォールドの既定値、アクションのリファレンス、ディレクトリとレイアウトに関するガイダンスです。
• 統合リファレンス - 保持されている作成前後のワークフロー、カタログ／ルーティング／インデックスの更新、クリエーターエコシステム間の相互参照です。
• 例と評価 - 保持されている参考スキルの注記、実例、システム影響チェックリスト、任意の評価資料です。

アクション

アクション	使用する状況	主なコマンド
create	新しいスキルを作成するとき	node .claude/skills/skill-creator/scripts/create.cjs --name <skill-name> --description "<summary>"
convert	MCP サーバーをスキルに変換するとき	node .claude/skills/skill-creator/scripts/convert.cjs --source <package-or-url>
validate	既存のスキル定義を確認するとき	node .claude/tools/cli/validate-integration.cjs .claude/skills/<skill-name>/SKILL.md
install	GitHub からスキルをインポートするとき	エンタープライズバンドルの詳細にある保持済みのインストール手順に従ってください
convert-codebase	外部のツールやコードベースをスキルに変換するとき	エンタープライズバンドルの詳細にある保持済みの変換メモに従ってください
consolidate	多数の限定的なスキルをドメインエキスパートに統合するとき	エンタープライズバンドルの詳細にある保持済みの統合リファレンスを使用してください
convert-rules	レガシールールをスキルに移行するとき	エンタープライズバンドルの詳細にある保持済みのルール変換リファレンスを使用してください
assign	1 つ以上のエージェントにスキルを割り当てるとき	以下のチェックリストと、統合リファレンスの詳細なマトリックスを使用してください
register-hooks / register-schemas	既存のアセットをスキルに接続するとき	エンタープライズバンドルの詳細にある保持済みのアクションメモを使用してください
show-structure	想定されるフォルダーレイアウトを確認するとき	以下のテンプレートとディレクトリーのガイダンスを使用してください

コア作成ワークフロー

ステップ 0：存在確認とアップデーターへの委任

スキルファイルを作成する前に、スキルがすでに存在するかどうかを確認してください。

test -f .claude/skills/<skill-name>/SKILL.md && echo "EXISTS" || echo "NEW"

• スキルが存在する場合は、作成を中止し、artifact-updater に委任してください。
• 新規スキルの場合は、ステップ 0.1 に進んでください。
• 直接書き込んでこのステップを回避しないでください。unified-creator-guard.cjs が安全でない作成経路をブロックする想定です。

ステップ 0.1：スマート重複検出

先に進む前に、重複検出器を実行してください。

const { checkDuplicate } = require('.claude/lib/creation/duplicate-detector.cjs');
const result = checkDuplicate({
  artifactType: 'skill',
  name: proposedName,
  description: proposedDescription,
  keywords: proposedKeywords || [],
});

結果はこれまでと同じ方法で処理してください。

• EXACT_MATCH → 中止し、skill-updater に引き継ぐ
• REGISTRY_MATCH → 作成前にレジストリとファイルの不整合を調査する
• SIMILAR_FOUND → 候補を確認し、作成するか更新するかを判断する
• NO_MATCH → ステップ 0.5 に進む

ステップ 0.5：関連アーティファクトの確認

作成前に、関連アーティファクトを確認してください。

1. .claude/lib/creators/companion-check.cjs を読み込みます。
2. checkCompanions("skill", "{skill-name}") を呼び出します。
3. 必須および推奨される関連アーティファクトを記録します。
4. 作成後のメモに、スキップした関連アーティファクトを記録します。

スキルに、明示的に呼び出さなくても適用されるべき動作指針が含まれる場合は、.claude/rules/<skill-name>.md も必要かどうかを確認してください。

ステップ 1：適切なアクションを選ぶ

リクエストに合致する、最も範囲の狭いアクションを選んでください。

• 新しいスキルを作成する場合は create
• MCP サーバーを変換する場合は convert
• GitHub のスキルをインポートする場合は install
• 外部ツールまたはコードベースをスキルに取り込む場合は convert-codebase
• アーティファクトがすでに存在し、検証のみが必要な場合は validate

ステップ 2：コンテンツを確定する前に調査ゲートを実行する

スキル本文を確定する前に、調査ゲートの詳細に記載されている保持済みの調査ワークフローを完了してください。この資料には、元の VoltAgent、Exa、arXiv、typed-artifact-search、エビデンスの品質、および外部コンテンツの安全性に関する内容が保持されています。

ステップ 3：標準の作成スクリプトを実行する

新しいスキルを作成する場合は、管理対象のスキャフォールドから始めてください。

node .claude/skills/skill-creator/scripts/create.cjs --name <skill-name> --description "<summary>"

以下のテンプレートを、生成される SKILL.md が満たすべき仕様として使用してください。詳細な形式の説明、アクション例、レイアウトの指針は、エンタープライズバンドルの詳細に保持されています。

ステップ 4：リクエストされたスキャフォールドを確認する

エンタープライズバンドルは現在、オプトインです。デフォルトでは最小限のスキャフォールドから始め、リクエストで --enterprise が明示的に指定された場合、または機能上どうしても必要な場合にのみ、エンタープライズ向けファイルを追加してください。最低限、スキルに次のどれが必要かを判断してください。

• 実行可能なヘルパー用の scripts/
• 実行前後の適用を強制する hooks/
• 型付きインターフェース用の schemas/
• 再利用可能な作成資料用の templates/ または references/
• .claude/tools/<skill-name>/ 内の関連ツール
• .claude/workflows/ 内のワークフロー

元のバンドルの内訳と受け入れチェックリストは、エンタープライズバンドルの詳細に保持されています。

ステップ 5：検証と統合

完了する前に、次の作業を行ってください。

1. 以下の作成後チェックリストを実行します。
2. node .claude/tools/cli/validate-integration.cjs .claude/skills/<skill-name>/SKILL.md を実行します。
3. アーティファクトが新規作成された場合、または大幅に変更された場合は、スキルインデックスを再生成します。
4. 変更した対象に必要な、対象を絞ったバリデーターを再実行します。
5. 新しいスキルによって、別のクリエーターが扱う関連アーティファクトの作業が必要になった場合は、このフロー内から別のクリエーターを呼び出さず、Follow-Up 項目として記録します。

ルーターの欠落検出

スキルのスキャフォールド作成または更新後に、ルーティングレイヤーが引き続きそのスキルを検出できることを確認してください。no matching agent/skill という結果は、引き継ぎ前に解決が必要なルーティング上の欠落として扱ってください。

• スキルに新規または更新されたエージェント割り当てが必要かどうかを確認します。
• 検出用メタデータが変更された場合は、インデックスとレジストリを再生成します。
• 未解決のルーティングに関するフォローアップは明示的に記録し、別のクリエーターが推測して対応すると決めつけないでください。

テンプレートのリファレンス

SKILL.md では、次の基本構造を使用します。

---
name: skill-name
description: What the skill does
version: 1.0.0
model: sonnet
invoked_by: user | agent | both
user_invocable: true | false
tools: [Read, Write, Bash]
args: "<required> [optional]"
agents: [developer, qa]
category: "Validation & Quality"
tags: [testing, validation]
frontmatter:
  triggers:
    - <pattern or trigger phrase that should invoke this skill>
  token_budget: 10000  # estimated token cost for invoking this skill
  # output_schema_ref: (set if a skill-*-output.schema.json exists for this skill)
  # requires_skills: []  # list dependent skill names here
---

# Skill Name

## Purpose
What this skill accomplishes.

## Usage
How the skill is invoked and applied.

## Examples
Concrete invocation or workflow examples.

明示する必要がある必須のフロントマター項目：name、description、version、agents、category、tags、tools、invoked_by、user_invocable。

v3.1.0 スキーマの追加：frontmatter ブロック

frontmatter オブジェクトは、v3.1.0 で導入された任意の、機械解析可能なメタデータブロックです。エージェントは、本文全体を解析せずにこのブロックを調べられます。create アクションでは、すべての新しい SKILL.md ファイルにデフォルトでこのブロックが出力されます。

項目	型	必須	用途
triggers	string[]	いいえ	スキルを呼び出すきっかけとなるパターン
token_budget	integer	いいえ	推定トークンコスト（最小 1000）。プランナーが予算を管理するために使用します
output_schema_ref	string	いいえ	スキルの出力スキーマへのパス（例：skill-foo-output.schema.json）
requires_skills	string[]	いいえ	このスキルが依存するスキルの名前（スキルインデックスで解決されます）

frontmatter のすべての項目は任意です。frontmatter ブロックがない既存の SKILL.md ファイルも引き続き有効です。スキーマではルートレベルで additionalProperties: true が設定されており、frontmatter プロパティは required に含まれていないためです。無関係な更新の際に、既存のスキルへ frontmatter を追加しないでください。スキルを意図的に更新または検証する場合にのみ追加してください。

作成後のチェックリスト

• 適切なアクションパス（create、convert、install、validate、またはその他のサポートされているアクション）を使用しました。
• リサーチゲートを完了したか、証拠を保持したうえで明示的に記録しました。
• スキルファイルが .claude/skills/<skill-name>/SKILL.md にあります。
• 必須のフロントマター項目、特に agents、category、tags が含まれています。
• 少なくとも 1 つの関連エージェントの割り当てを確認しました。
• 必要に応じて、CLAUDE.md、ルーティングノート、スキルカタログを更新しました。
• node .claude/tools/cli/validate-integration.cjs .claude/skills/<skill-name>/SKILL.md が成功します。
• 発見可能性に関するメタデータを変更した場合は、node .claude/tools/cli/generate-skill-index.cjs を実行しました。
• 新規スキルまたは再登録したスキルについて、npm run gen:all-registries を実行しました。
• 作成フローで必要な場合は、README の記載またはカタログを更新しました。
• 関連成果物、メモリノート、フォローアップ項目を記録しました。

エコシステム連携契約（必須）

この作成スキルでは、新規または更新するすべてのスキルを、より広範な作成エコシステムに適合させる必要があります。

• 所有権と実行パスには agent-creator
• 実行可能なヘルパーには tool-creator
• 適用とガードレールには hook-creator
• ポリシーの適用範囲には rule-creator と semgrep-rule-creator
• 再利用可能なひな形には template-creator
• オーケストレーションには workflow-creator
• ユーザー向けのショートカットには command-creator

作成者間の引き継ぎ（必須）

引き継ぎの前に、関連するエコシステムの更新を確認してください。

1. 必要なルーティングと発見用メタデータを更新しました。
2. 関連するエージェント、フック、ツール、テンプレート、ルール、ワークフローを作成したか、明示的に対象外としました。
3. スキル成果物に対して validate-integration.cjs が成功します。
4. メタデータを変更した場合は、スキルインデックスとレジストリを再生成しました。
5. 未解決のエコシステム上の不足点は、フォローアップ作業として記録しました。

調査ゲート（Exa + arXiv — 両方必須）

新しいスキルパターン、パッケージ化のアプローチ、または AI 関連の方法論については、以下を実施します。

1. Exa を使用して、現在のエコシステムのパターンと実装例を確認します。
2. AI エージェント、評価、オーケストレーション、メモリ／RAG、セキュリティ、その他の新しい手法に関わるトピックでは、arXiv を検索します。
3. スキルの契約を形作った決定事項、制約、対象外事項を記録します。
4. リクエストを満たす、検証済みの最小限の変更を優先します。

リグレッションに配慮した成果物の提供

• 動作を変更する場合は RED -> GREEN -> REFACTOR に従います。
• 変更したスキルと作成者向けの箇所を対象にテストを実行します。
• 引き渡し前に、必須のフォーマットおよび検証コマンドを実行します。
• 無関係な整理をまとめて行わず、失敗した契約に変更範囲を限定します。

備考

• 作成フロー以外で直接作成すると、スキルが認識されず、レジストリの状態が壊れるおそれがあります。
• 新しいスキルに新しいエージェントやその他の関連成果物が必要となる場合は、作成者のワークフローをインラインで連鎖させず、次回の作成者ワークフローに向けたフォローアップとして記録します。
• 維持されている詳細な Step 6-13 のガイダンスについては、統合リファレンスを使用します。
• 維持されている参照スキル、スキル作成の例を使った手順、任意の評価追加項目については、例と評価を使用します。