skill-creator

スキル作成ツール

AI エージェントのスキルを作成、改善、監査します。すべてのスキルは、実績のある14の構造パターンに従います。

対象範囲： スキルのみ。エージェントの作成（agent-conventions を使用）、MCP サーバーの構築（/mcp-creator）、既存のスキルの実行には使用しないでください。このリポジトリでは、SKILL.md 形式のファイルを skills/ に直接コミットします。

振り分け

$ARGUMENTS	アクション	例
create <name> / new <name>	開発（新規）	/skill-creator create my-analyzer
create <name> --from <source>	開発（既存の例を元に新規作成）	/skill-creator create my-analyzer --from wargame
improve <name> / improve <path>	開発（既存）	/skill-creator improve design
plan <name> / plan <path>	計画（既存）	/skill-creator plan review
plan --all / plan repo	計画（リポジトリ全体）	/skill-creator plan --all
audit <name>	監査	/skill-creator audit review
audit <name> --security	セキュリティ監査	/skill-creator audit review --security
audit --all	すべてを監査	/skill-creator audit --all
eval <name>	評価	/skill-creator eval review
benchmark <name>	ベンチマーク	/skill-creator benchmark review
compare <old> <new>	比較	/skill-creator compare review-v1 review-v2
optimize-description <name>	説明を最適化	/skill-creator optimize-description review
dashboard	ダッシュボード	/skill-creator dashboard
package <name> / package --all	パッケージ化	/skill-creator package wargame
example-blocks <name>	例のブロック	/skill-creator example-blocks review
自然言語によるスキルのアイデア	自動：開発（新規）	"Python の型安全性を監査するツール"
スキル名＋変更を表す動詞	自動：開発（既存）	"wargame スキルをリファクタリングする"
SKILL.md へのパス	自動：開発（既存）	skills/wargame/SKILL.md
"MCP server" / "agent" / "run"	拒否して誘導	—
空	ギャラリー	/skill-creator

自動検出のヒューリスティック

明示的なモードキーワードが指定されていない場合：

1. SKILL.md で終わるパス、または skills/ 配下のディレクトリ → 開発（既存）
2. 既存のスキル名＋変更を表す動詞（improve、refactor、enhance、update、fix、rewrite、optimize、polish、revise、change） → 開発（既存）
3. 引数に --from <source> が含まれる → 開発（既存の例を元に新規作成）
4. "benchmark"、"A/B"、"with skill"、"without skill"、"old skill"、"new skill" → ベンチマークまたは比較
5. "trigger"、"false positive"、"false negative"、"description fires" → 説明を最適化
6. "security"、"supply chain"、"malicious"、"unsafe"、"permission"、"hook" → セキュリティ監査
7. 新しい機能の説明（"I want to build..."、"tool that..."、"skill for..."） → 開発（新規） — 名前を導き出し、ひな形を作成する前に確認する
8. "MCP server"、"agent"、"run" → 丁寧に拒否して誘導する
9. 曖昧な場合 → 希望するモードをユーザーに尋ねる

クイックスタート

uv run python skills/skill-creator/scripts/scaffold_skill.py <name>  # Scaffold from template
uv run python scripts/check.py                                        # Validate from skill directory
uv run python skills/skill-creator/scripts/audit.py skills/<name>/    # Score quality
uv run python skills/skill-creator/scripts/package.py skills/<name>/ --dry-run  # Portability check

スキル開発

新しいスキルの作成と既存スキルの改善を統一したプロセスで行います。全手順については、references/workflow.md を読み込んでください。

ステップ	新しいスキル	既存のスキル
1. 理解	ユースケース、範囲、パターンを定義	ユーザーの意図を確認・理解
2. 計画	構成、説明、フロントマターを決定	ギャップ分析と改善計画（承認ゲート）
3. スキャフォールド	scaffold_skill.py <name>	スキップ
4. 構築	本文、リファレンス、スクリプト、テンプレート、評価を作成・編集	同じ
5. 検証	scripts/check.py + audit.py	同じ
6. 反復	テストし、問題を特定して、ステップ4に戻る	同じ

スケーリング戦略

エージェントの数を最大化するのではなく、検証済みの独立性を最大限に活用してください。グラフの仕様全体については、references/orchestration-graph.md を読み込んでください。

範囲	戦略	並列化
小規模	単一スキルの編集：インラインで順次編集・検証	リードのみ
中規模	単一スキルの複数箇所の編集：本文の契約を固めてから、リファレンス／評価／スクリプトを担当ファイルごとに分割	互いに重複しない2～5のレーン
大規模	スキルクラスターまたはリポジトリ全体の計画：棚卸し、優先順位付け、スキルまたは箇所ごとの分割、判定レーンの追加	担当する各シャードにワーカー1人
大規模	公開ワークフロー／スキーマ／ツール変更：まずOpenSpecを作成し、明示的な依存関係を設定してからワーカーを配置	仕様、実装、検証、ドキュメント管理の各レーン
大規模	行動評価／ベンチマークプログラム：まず静的ゲートを設け、その後、オプトイン式の評価ランナー／レポートの各レーンを設定	トリガー、出力、安全性、レポート、判定の各レーン

各レーンは、割り当てる前に入力、担当パス、出力成果物、検証コマンド、進捗管理状態を定義する必要があります。同じファイルの編集、生成ドキュメント、フック、パッケージングの仕様、スキーマの決定は、明示的なロック／調停プロトコルがない限り、順次処理してください。

リポジトリ全体／複数スキルの計画

既存スキルを編集せずに改善計画を作成するには plan <name> を、優先順位を付けたリポジトリ全体の計画を実施するには plan --all または plan repo を使用してください。

計画に必要な出力：

1. ベースライン監査の概要
2. 最も価値の高い調査結果
3. 明示的な対象ファイル
4. 予想されるスコアへの影響
5. 編集前の承認ゲート

リポジトリ全体の計画では、優先順位付きのキューと、採用された各スキルまたはスキルクラスターごとに独立した改善計画を作成してください。ユーザーが計画を承認するまでは、どのスキルも編集しないでください。

独立した改善計画パケットを作成する際は、references/refinement-plan.md を読み込んでください。

監査

決定論的な分析とAIレビューを組み合わせてスキルを評価します。references/audit-guide.md を読み込んでください。

セキュリティ監査

スキルを実行可能なサプライチェーン資産として監査します。references/security-governance.md を読み込んでください。

必要な出力：

1. セキュリティサーフェスの棚卸し
2. ソース／シンクの脅威モデル
3. 権限の状態
4. フック／スクリプト／テンプレート／リファレンスに関する調査結果
5. 敵対的評価の推奨事項
6. リスクレベル：low、medium、high、または blocked

セキュリティ監査は読み取り専用です。サードパーティ製スキルのインストール、信頼できないスクリプトの実行、監査対象スキルの変更は行わないでください。

すべて監査

リポジトリ内のすべてのスキルを比較して順位付けします。references/audit-guide.md § Audit All を読み込んでください。

Eval／Benchmark／Compare／Optimize Description の説明

動作上の証拠は、静的監査のスコアリングを補完します。references/evidence-and-benchmarking.md を読み込んでください。

モード	目的
Eval	トリガー、出力、リグレッション、安全性、移植性に関する評価ケースをレビューまたは作成します
Benchmark	スキルの有無による測定をオプトインで計画または実行します
Compare	改善のために旧スキルと新スキルを比較する測定をオプトインで計画または実行します
Optimize Description	トリガーと誤検知に近い負例クエリをテストし、証拠に基づいて説明を修正します

ユーザーがライブ評価の実行と対象ワークスペースを明示的に承認しない限り、読み取り専用の計画をデフォルトにしてください。動作実行の成果物は、コミット対象の skills/ ソースの外に保存してください。

ダッシュボード

ビジュアル作成プロセスモニターまたは監査品質ダッシュボードを表示します。references/audit-guide.md § Dashboard を読み込んでください。

データからモードを自動検出します。phases フィールドがある場合はプロセスモニター、skills 配列がある場合は監査の概要を表示します。

ギャラリー（引数なし）

スキルの一覧をスコアと利用可能なアクションとともに表示します。 uv run python scripts/audit.py --all --format table を実行して結果を表示し、モードメニューを提示します。

パッケージ化

Claude Code Desktop へのインポート用に、スキルを移植可能な ZIP ファイルにパッケージ化します。ZIP の構造、マニフェストのスキーマ、移植性チェック、エージェント間の互換性については、references/packaging-guide.md を読み込んでください。

uv run python skills/skill-creator/scripts/package.py skills/<name>/ --dry-run  # Check before emitting a ZIP
uv run python skills/skill-creator/scripts/package.py skills/<name>/            # Single skill → <name>-v<version>.skill.zip

サンプルブロック生成ツール

既存のディスパッチテーブルから、空の状態／ヘルプギャラリー用のサンプル箇条書きを生成します。

uv run python skills/skill-creator/scripts/generate_example_blocks.py <name>           # Preview block
uv run python skills/skill-creator/scripts/generate_example_blocks.py <name> --apply # Append when missing

ディスパッチテーブルが安定した後、スキルを公開する前にこのモードを使用してください。## Example Blocks セクションを重複して追加しないでください。

ランタイムフックの投影

この移植可能なスキルソースには、スキル単位の hooks フロントマターは埋め込まれていません。リポジトリが管理するフックポリシーは config/hook-registry.json にあり、リポジトリの同期／レンダリングワークフローによって、サポート対象のハーネス設定に投影されます。

このスキルに対するランタイム投影されたフックの適用では、次の動作を維持してください。

• SKILL.md の編集時に validate_skill.py を実行します
• evals/*.json の編集時に validate_evals.py を実行します
• フックを含むスキル／設定の編集時に validate_hooks.py を実行します
• Stop フックは終了前に、変更されたスキル定義、評価、フックの各対象領域を検証します
• Stop フックは、再帰ループを避けるため、フック入力に stop_hook_active: true が含まれている場合は直ちに終了します

パッケージ化されたスキルは、uv run python scripts/verify.py ... のようなリポジトリルートのコマンドに依存してはいけません。実行可能なフックコマンドは、移植可能なスキルのフロントマターではなく、ランタイム固有の設定に記述してください。

状態管理

作成の進行状況は ~/.{gemini|copilot|codex|claude}/skill-progress/<name>.json に保持されます。scripts/progress.py を介して読み書きします。セッションを再起動しても保持されます。デフォルトの保存先を上書きするには --state-dir を使用してください。

リファレンスファイル一覧

ファイル	内容	読むタイミング
references/workflow.md	新規および既存のスキルを対象とする、統一されたスキルのライフサイクルプロセス	開発（新規）、開発（既存）、評価、ベンチマーク
references/refinement-plan.md	既存スキルおよびリポジトリ全体の計画出力に関する、独立した改善計画の仕様	計画（既存）、計画（リポジトリ全体）
references/audit-guide.md	監査手順、すべてを監査、ダッシュボードのレンダリング、ギャラリー、グレードのしきい値	監査、すべてを監査、ダッシュボード、ギャラリー
references/proven-patterns.md	リポジトリ内のスキル例を用いた14種類の構造パターン	ステップ4（構築）、ギャップ分析
references/best-practices.md	Anthropic のガイド + superpowers の方法論 + エージェント間の相互認識	ステップ2（計画）、ステップ4（構築）、説明文の作成
references/frontmatter-spec.md	フィールド一覧、呼び出しマトリックス、判断ツリーの全容	ステップ3（スキャフォールド）、フロントマターの設定
references/packaging-guide.md	ZIP 構造、マニフェストスキーマ、移植性チェック、インポート手順	パッケージ化
references/evaluation-rubric.md	100点満点に正規化された13の重み付き評価軸、グレードのしきい値、負荷テスト	監査（負荷テスト）、スコア目標
references/evidence-and-benchmarking.md	ライフサイクルパケット、動作評価、ベンチマーク成果物、トリガーの最適化	評価、ベンチマーク、比較、説明文の最適化
references/security-governance.md	脅威モデル、サードパーティの受け入れ、権限の方針、フック／スクリプトの安全性	セキュリティ監査、ステップ2（計画）、パッケージ化
references/runtime-compatibility.md	移植可能なフィールドとランタイム固有のフィールド、インストール先、グレースフルデグラデーション	ステップ3（スキャフォールド）、パッケージ化、セキュリティ監査
references/orchestration-graph.md	並列レーンのグラフ、所有権、アカウンティング、ロック、判定レイヤー	スケーリング戦略、リポジトリ全体の計画

上記の「読むタイミング」列に示されているとおりに、リファレンスファイルを読んでください。内容を記憶や事前知識に頼らないでください。

基本原則

簡潔さは敬意です — コンテキストウィンドウは共有されています。すべての行がエージェントの作業メモリと競合します。すべての行に価値があることを示すか、削除してください。

段階的な開示 — フロントマターは発見用（約100トークン）、本文はディスパッチ用（5Kトークン未満）、リファレンスは深い知識用（必要に応じて）、スクリプト／テンプレートは実行用（読み込み禁止）です。

自らが手本となる — このスキルは、自らが教えるすべてのパターンに従います。判断に迷ったら、skill-creator がどのように適用しているかを確認してください。

検証契約

変更完了を宣言する前に、このスキルのディレクトリから実行してください。

uv run python scripts/check.py

完了条件：

1. uv run python scripts/check.py が終了コード0で終了すること。
2. このスキルのディレクトリ内に、ポータブル CLI に関する違反が残っていないこと。

重要なルール

1. スキルを完成と宣言する前に、対象のスキルディレクトリで uv run python scripts/check.py を実行してください
2. evals を変更した後、スキルを完成と宣言する前に、uv run python scripts/check.py を再実行してください
3. SKILL.md に大幅な変更を加えるたびに、uv run python scripts/audit.py を実行してください
4. ディスパッチテーブルなしでスキルを作成しないでください。これはルーティングの契約です
5. 空の引数を処理するハンドラーなしでディスパッチテーブルを作成しないでください。ルーティングされない入力はバグです
6. すべての参照ファイルを Reference File Index に記載してください。インデックスにない参照ファイルは認識されません
7. インデックスに記載したすべての参照ファイルがディスク上に存在することを確認してください。実在しない参照ファイルはエージェントのエラーを引き起こします
8. 本文は500行未満（frontmatter より下）にしてください。詳細は参照ファイルに移してください
9. Description には「Use when」のトリガーフレーズと「NOT for」の除外事項を含めてください
10. 名前は kebab-case とし、2〜64文字、連続したハイフンなし、予約語なしにしてください
11. スクリプトでは argparse と JSON を使って標準出力に出力してください。独自の出力形式は使用しないでください
12. テンプレートは外部依存のない、自己完結型の HTML にしてください
13. リポジトリ固有のドキュメント生成ツールを直接呼び出さないでください。docs-steward に委任してください
14. エージェントや MCP サーバーを作成しないでください。丁寧に断り、適切な案内先を提示してください
15. 既存のスキルを改善する場合は、変更を実装する前に改善計画を提示し、ユーザーの承認を得てください
16. Audit モードは読み取り専用です。監査対象のスキルを変更しないでください
17. ディスパッチの動作やモードを変更した場合は evals を更新してください。古くなった evals は見えないバグです
18. plan <name> と plan --all は読み取り専用の計画モードです。計画中に編集しないでください
19. リポジトリ全体または複数のスキルに関する依頼では、実装を始める前に、順位付けした計画と独立した改善計画の出力を提示してください
20. ランタイムで投影される Stop フックには stop_hook_active ガードを含めてください。再帰的なフックループは実装上のバグです
21. 新しいスキルは、実際のワークフローの根拠に基づいて作成してください。一般的なベストプラクティスの生成は、最初は needs-evidence としてください
22. 有意な変更を行った場合、動作が改善したと主張する前に、without_skill または old_skill と比較してベンチマークを実施してください
23. 静的品質スコアが A でも、セキュリティガバナンスに関する指摘によってリリースがブロックされることがあります
24. スクリプト、フック、ツール、ネットワーク、認証情報、書き込みを使用するすべてのスキルについて、明示的な権限設定を選択してください
25. 公開 eval スキーマ、検証動作、フックポリシー、パッケージングのセマンティクス、生成ドキュメントのワークフローを変更する前に、OpenSpec を使用してください
26. Plan、Audit、Security Audit モードでは、実際のインストール、実際の動作 eval、ブラウザーの起動、コマンドファイルのインジェクションを実行しないでください

標準用語（全体を通して以下をそのまま使用してください）：

• モード："Develop (new)"、"Develop (existing)"、"Plan (existing)"、"Plan (repo-wide)"、"Audit"、"Security Audit"、"Audit All"、"Eval"、"Benchmark"、"Compare"、"Optimize Description"、"Dashboard"、"Package"、"Gallery"
• 手順（開発）："Understand"、"Plan"、"Scaffold"、"Build"、"Validate"、"Iterate"
• 評価スケール："A"（90-100）、"B"（75-89）、"C"（60-74）、"D"（40-59）、"F"（<40）
• パターン："dispatch-table"、"reference-file-index"、"critical-rules"、"canonical-vocabulary"、"scope-boundaries"、"classification-gating"、"scaling-strategy"、"state-management"、"scripts"、"templates"、"hooks"、"progressive-disclosure"、"body-substitutions"、"stop-hooks"
• 監査の評価項目："frontmatter"、"description"、"dispatch-table"、"body-structure"、"pattern-coverage"、"reference-quality"、"critical-rules"、"script-quality"、"portability"、"conciseness"、"canonical-vocabulary"、"evaluation-coverage"、"validation-contract"、"security-governance"