---

name: meta-skill-creator description: | スキルを作成・更新・プロンプト改善するためのメタスキル。 collaborativeモードでユーザーと対話しながら共創し、 抽象的なアイデアから具体的な実装まで柔軟に対応する。 orchestrateモードでタスクの実行エンジン（Claude Code / Codex / 連携）を選択。

Anchors: • Continuous Delivery (Jez Humble) / 適用: 自動化パイプライン / 目的: 決定論的実行 • The Lean Startup (Eric Ries) / 適用: Build-Measure-Learn / 目的: 反復改善 • Domain-Driven Design (Eric Evans) / 適用: ユビキタス言語 / 目的: 一貫した語彙 • Design Thinking (IDEO) / 適用: ユーザー中心設計 / 目的: 共感と共創 • Microservices Patterns (Richardson) / 適用: サービス委譲 / 目的: 疎結合な連携

Trigger: 新規スキルの作成、既存スキルの更新、プロンプト改善を行う場合に使用。 スキル作成, スキル更新, プロンプト改善, skill creation, skill update, improve prompt, Codexに任せて, assign codex, Codexで実行, GPTに依頼, 実行モード選択, どのAIを使う allowed-tools:

• Read
• Write
• Edit
• Bash
• Glob
• Grep
• Task
• AskUserQuestion

---

Skill Creator

概要

スキルを作成・更新・プロンプト改善するためのメタスキル。 Collaborative Firstでユーザーと対話しながら共創、Script Firstで決定論的処理を自動化、Progressive Disclosureで必要なリソースのみを読み込む。

設計原則

| 原則 | 説明 | |------|------| | Collaborative First | ユーザーとの対話を通じて要件を明確化 | | Script First | 決定論的処理はスクリプトで実行（100%精度） | | Progressive Disclosure | 必要な時に必要なリソースのみ読み込み | | Custom Script Support | 24タイプに収まらない独自スクリプトも生成 | | Self-Contained Skills | 各スキルは独自のnode_modules・依存関係を持つ |

モード一覧

| モード | 用途 | 開始方法 | |--------|------|----------| | collaborative | ユーザー対話型スキル共創（推奨） | AskUserQuestionでインタビュー開始 | | orchestrate | 実行エンジン選択（Claude/Codex/連携） | AskUserQuestionでヒアリング開始 | | create | 要件が明確な場合の新規作成 | .claude/skills/meta-skill-creator/scripts/detect_mode.js --request "新規スキル" | | update | 既存スキル更新 | .claude/skills/meta-skill-creator/scripts/detect_mode.js --request "更新" --skill-path <path> | | improve-prompt | プロンプト改善 | .claude/skills/meta-skill-creator/scripts/analyze_prompt.js --skill-path <path> |

実行エンジン（orchestrateモード）

| エンジン | 説明 | 適用場面 | |----------|------|----------| | claude | Claude Code単独実行 | ファイル編集、Git操作、コードベース深い理解 | | codex | Codex (GPT-5.2) 単独実行 | 独立したタスク、別視点での分析 | | claude-to-codex | Claude → Codex連携 | コンテキスト共有が必要な複合タスク |

抽象度レベル

| レベル | 説明 | 例 | |--------|------|-----| | L1: Concept | アイデア・課題レベル | 「開発効率を上げたい」 | | L2: Capability | 機能・能力レベル | 「PRを自動作成したい」 | | L3: Implementation | 実装・詳細レベル | 「GitHub APIでPR作成」 |

抽象度が高いほど、インタビューを通じて具体化する。 📖 詳細: references/abstraction-levels.md

---

Part 0: Collaborative モード（推奨）

ユーザーと対話しながらスキルを共創するモード。

ワークフロー

Phase 0-1: 初期ヒアリング
  Q1: 何を実現したいですか？ → 抽象度レベル判定
  Q2: 対象は何ですか？ → コンテキスト特定
  Q3: 頻度・規模は？ → 複雑さ判定
      ↓
Phase 0-2: 機能ヒアリング
  Q4: 必要な機能は？
  Q5: 外部連携は？
  Q6: スクリプトは？
      ↓
Phase 0-3: 構成ヒアリング
  Q7: 構成タイプは？（シンプル/標準/フル）
  Q8: 優先事項は？
      ↓
Phase 0-4: 要件確認
  → ユーザー確認後、Phase 1へ

📖 詳細: agents/interview-user.md

---

Part 0.5: Orchestrate モード（実行エンジン選択）

スキル作成プロセス内で、特定のサブタスクを最適な実行エンジンに委譲するモード。

skill-creator実行中 → 特定タスクでCodex使用 → Claude Code継続

ワークフロー

Phase 1-2: ヒアリング
  → .claude/skills/meta-skill-creator/agents/interview-execution-mode.md
  タスク内容・コンテキスト判定 → モード推奨・選択
      ↓
Phase 3: 実行（モード別分岐）
  claude: 直接実行
  codex: .claude/skills/meta-skill-creator/scripts/assign_codex.js
  claude-to-codex: コンテキスト収集 → Codex
      ↓
Phase 4: 結果確認・統合

📖 モード選択基準・詳細フローチャート: references/execution-mode-guide.md

関連リソース

| リソース | 読み込み条件 | |----------|-------------| | interview-execution-mode.md | Phase 1-2 | | delegate-to-codex.md | Codex実行時 | | execution-mode-guide.md | 判断に迷った時 |

---

Part 1: スキル作成ワークフロー（createモード）

Phase 1: 分析（LLM）
  .claude/skills/meta-skill-creator/agents/analyze-request.md
  → .claude/skills/meta-skill-creator/agents/extract-purpose.md
  → .claude/skills/meta-skill-creator/agents/define-boundary.md
      ↓
Phase 2: 設計（LLM + Script検証）
  .claude/skills/meta-skill-creator/agents/select-anchors.md ─┐
  .claude/skills/meta-skill-creator/agents/define-trigger.md ─┤
      → .claude/skills/meta-skill-creator/agents/design-workflow.md
      → .claude/skills/meta-skill-creator/scripts/validate_workflow.js
      ↓
Phase 3: 構造計画（LLM + Script検証）
  .claude/skills/meta-skill-creator/agents/plan-structure.md
  → .claude/skills/meta-skill-creator/scripts/validate_plan.js
      ↓
Phase 4: 生成（Script）
  .claude/skills/meta-skill-creator/scripts/init_skill.js
  → .claude/skills/meta-skill-creator/scripts/generate_skill_md.js
  → .claude/skills/meta-skill-creator/scripts/generate_agent.js
      ↓
Phase 5: フィードバック機構生成（Script）
  → LOGS.md, EVALS.json, references/patterns.md を生成
      ↓
Phase 6: 検証（Script）
  .claude/skills/meta-skill-creator/scripts/validate_all.js
  → .claude/skills/meta-skill-creator/scripts/log_usage.js

---

Part 2: スクリプト生成ワークフロー

24種類のスクリプトタイプ

| カテゴリ | タイプ | |----------|--------| | API関連 | api-client, webhook, scraper, notification | | データ処理 | parser, transformer, aggregator, file-processor | | ストレージ | database, cache, queue | | 開発ツール | git-ops, test-runner, linter, formatter, builder | | インフラ | deployer, docker, cloud, monitor | | 統合 | ai-tool, mcp-bridge, shell | | 汎用 | universal |

📖 詳細: references/script-types-catalog.md

生成ワークフロー

Phase 1: 要件分析（LLM）→ script-requirement.json
Phase 2: ランタイム判定（Script）→ runtime-config.json
Phase 3: 設計（LLM）→ script-design.json
Phase 4: 変数設計（LLM）→ variables.json
Phase 5: コード生成（LLM）→ script-template.{ext}
Phase 6: コード展開（Script）→ 実行可能スクリプト
Phase 7: 検証（Script）

📖 カスタムスクリプト: agents/design-custom-script.md

---

Part 3: フィードバック＆自己改善ワークフロー

3.1 毎回実行後（必須）

スキル実行後は必ずフィードバックを記録する：

# 成功時
node .claude/skills/meta-skill-creator/scripts/log_usage.js --result success --phase "Phase 4" --notes "完了"

# 失敗時
node .claude/skills/meta-skill-creator/scripts/log_usage.js --result failure --phase "Phase 3" --error "ValidationError" --notes "理由"

記録先: | ファイル | 更新内容 | |----------|----------| | LOGS.md | 実行ログ（日時、結果、フェーズ、メモ） | | EVALS.json | メトリクス（成功率、実行回数、平均時間） |

3.2 パターン発見時

成功/失敗パターンを発見したら記録する：

.claude/skills/meta-skill-creator/agents/analyze-feedback.md → パターン検出
     ↓
.claude/skills/meta-skill-creator/agents/save-patterns.md
     → .claude/skills/meta-skill-creator/references/patterns.md 更新

パターン形式:

• 成功パターン: 状況 → アプローチ → 結果 → 適用条件
• 失敗パターン: 状況 → 問題 → 原因 → 教訓

3.3 改善サイクル

定期的（10回実行ごと、またはエラー率閾値超過時）に改善を検討：

.claude/skills/meta-skill-creator/scripts/collect_feedback.js → feedback-data.json出力
     ↓
.claude/skills/meta-skill-creator/agents/analyze-feedback.md → パターン分析・改善提案生成
     ├─ patterns[] あり → .claude/skills/meta-skill-creator/agents/save-patterns.md
     │                  → .claude/skills/meta-skill-creator/references/patterns.md更新
     └─ suggestions[] あり → .claude/skills/meta-skill-creator/agents/design-self-improvement.md
     ↓
.claude/skills/meta-skill-creator/scripts/apply_self_improvement.js → 改善適用
  --dry-run: 事前確認（推奨）
  --backup: バックアップ作成
  --auto-only: 自動適用可能なもののみ

📖 詳細: references/self-improvement-cycle.md

3.4 フィードバック対象ファイル

| ファイル | 用途 | 更新タイミング | スクリプト/エージェント | |----------|------|----------------|------------------------| | LOGS.md | 実行ログ | 毎回実行後 | scripts/log_usage.js | | EVALS.json | メトリクス | 毎回実行後 | scripts/log_usage.js | | references/patterns.md | 成功/失敗パターン | パターン発見時 | agents/save-patterns.md |

---

Part 4: ライブラリ管理（Self-Contained Skills）

スキルは自己完結型。依存関係はスキルディレクトリ内で管理し、PNPMを使用する。

4.1 設計思想

| 原則 | 説明 | |------|------| | 自己完結 | 各スキルが独自のnode_modules・package.jsonを持つ | | 分離 | プロジェクト本体の依存関係と干渉しない | | 再現性 | pnpm-lock.yamlで依存関係を固定 |

4.2 依存関係管理コマンド

# スキルの依存関係をインストール
node .claude/skills/meta-skill-creator/scripts/install_deps.js

# パッケージを追加
node .claude/skills/meta-skill-creator/scripts/add_dependency.js axios

# 開発依存関係として追加
node .claude/skills/meta-skill-creator/scripts/add_dependency.js typescript --dev

# 他のスキルに対して実行
node .claude/skills/meta-skill-creator/scripts/install_deps.js --skill-path .claude/skills/my-skill

4.3 スキル構造（依存関係あり）

.claude/skills/my-skill/
├── package.json       # 依存関係定義
├── pnpm-lock.yaml     # 依存関係ロック（自動生成）
├── node_modules/      # 依存関係（スキル内に配置）
├── SKILL.md
├── scripts/
│   └── my-script.js   # import from 'axios' 等が使用可能
└── ...

📖 詳細: references/library-management.md

---

Part 5: Progressive Disclosure リソースマップ

リソースは必要な時のみ読み込む。詳細は resource-map.md を参照。

リソース概要

| カテゴリ | 数 | 主な読み込み条件 | |----------|-----|-----------------| | agents/ | 20 | モード・Phase別に必要時のみ | | references/ | 23 | 設計・判断・詳細確認時 | | scripts/ | 25 | 決定論的処理実行時（utils.js共通） | | assets/ | 17 | 生成・テンプレート展開時 | | schemas/ | 23 | JSON検証時 |

主要リソース（高頻度）

| リソース | 読み込み条件 | |----------|-------------| | agents/interview-user.md | collaborativeモード | | agents/analyze-request.md | createモード | | scripts/utils.js | 全スクリプト共通 | | scripts/init_skill.js | スキル初期化 | | scripts/log_usage.js | 毎回実行後 | | references/script-commands.md | スクリプト実行時 | | references/resource-map.md | 全リソース詳細 |

📖 全リソース詳細: references/resource-map.md

---

ベストプラクティス

| すべきこと | 避けるべきこと | |-----------|---------------| | Script優先（決定論的処理） | 全リソースを一度に読み込む | | LLMは判断・創造のみ | Script可能な処理をLLMに任せる | | Progressive Disclosure | 具体例をテンプレートに書く | | 中間出力は.tmp/に保存 | 中間ファイルを省略 |

---

変更履歴

| Version | Date | Changes | |---------|------|---------| | 5.7.0 | 2026-01-21 | SKILL.md最適化: Part 5をresource-map.mdに分離（485→375行、23%削減）、スクリプトutils.js統合完了 | | 5.6.1 | 2026-01-21 | DRYリファクタリング: utils.js共通モジュール作成、約270行の重複コード排除 | | 5.6.0 | 2026-01-21 | Self-Contained Skills: PNPM依存関係管理、package.json自動生成、install_deps.js/add_dependency.js追加 | | 5.5.2 | 2026-01-20 | 参照パス完全統一: ワークフロー図・コマンド例・テーブル内のすべての参照を完全パス化（105参照） | | 5.5.1 | 2026-01-20 | 参照パス統一: Markdownリンクをリポジトリルートからの相対パスに統一 | | 5.5.0 | 2026-01-20 | 最適化: SKILL.md 521→420行に削減、Part 0.5詳細をexecution-mode-guide.mdへ移動 | | 5.4.0 | 2026-01-20 | フィードバック機構強化: Part 3をフィードバック＆自己改善に拡張、save-patterns.mdエージェント追加 | | 5.3.0 | 2026-01-15 | Progressive Disclosure完全化: 全ファイル（19 refs, 23 schemas, 34 assets, 22 scripts）に読み込み条件追加 | | 5.2.1 | 2026-01-15 | Codex連携の目的明確化: スキル作成内サブタスク委譲用、Claude Code⇄Codexラウンドトリップパターン | | 5.2.0 | 2026-01-15 | Orchestrateモード追加: Codex連携機能、実行エンジン選択（claude/codex/claude-to-codex） | | 5.1.0 | 2026-01-15 | リファクタリング: SKILL.md簡素化、agents/フォーマット統一、workflow-patterns.md統合 | | 5.0.0 | 2026-01-15 | Collaborative First追加、抽象度レベル対応、カスタムスクリプト対応 | | 4.0.0 | 2026-01-13 | スクリプト生成ワークフロー追加、自己改善サイクル追加 | | 3.0.0 | 2026-01-06 | 3モード対応（create/update/improve-prompt） |