Skill Creator

概要

スキルを作成・更新・プロンプト改善するためのメタスキル。 Script Firstの原則で決定論的処理を自動化し、Atomic Taskで細粒度のタスク分解を提供する。

設計原則

モード一覧

ワークフロー

Mode: create（新規作成）

Phase 1: 分析（LLM Task）
┌─────────────────────────────────────────────────────────┐
│ analyze-request → extract-purpose → define-boundary     │
└─────────────────────────────────────────────────────────┘
                            ↓
Phase 2: 設計（LLM Task + Script Validation）
┌─────────────────────────────────────────────────────────┐
│ select-anchors ─┐                                       │
│                 ├→ design-workflow → [validate-workflow]│
│ define-trigger ─┘                                       │
└─────────────────────────────────────────────────────────┘
                            ↓
Phase 3: 構造計画（LLM Task + Script Validation）
┌─────────────────────────────────────────────────────────┐
│ plan-structure → [validate-plan]                        │
└─────────────────────────────────────────────────────────┘
                            ↓
Phase 4: 生成（Script Task）
┌─────────────────────────────────────────────────────────┐
│ [init-skill] → [generate-skill-md] → [generate-agents]  │
└─────────────────────────────────────────────────────────┘
                            ↓
Phase 5: 検証（Script Task）
┌─────────────────────────────────────────────────────────┐
│ [validate-all] → [update-skill-list]                    │
└─────────────────────────────────────────────────────────┘

凡例: [script] = Script Task, 無印 = LLM Task

Mode: update（既存スキル更新）

Phase 1: 分析
[detect-mode] → design-update → [validate-schema]
                            ↓
Phase 2: 生成・適用（Script Task）
[apply-updates] → [validate-all] → [update-skill-list] → [log-usage]

Mode: improve-prompt（プロンプト改善）

Phase 1: 分析（Script Task）
[analyze-prompt] → 分析結果確認
                            ↓
Phase 2: 改善設計（LLM Task）
improve-prompt → [validate-schema]
                            ↓
Phase 3: 適用（Script Task）
[apply-updates] → [validate-all] → [update-skill-list] → [log-usage]

Task一覧

LLM Tasks（判断が必要）

詳細仕様: 各Taskの詳細は agents/ ディレクトリを参照

Script Tasks（決定論的実行）

詳細仕様: 各スクリプトは scripts/ ディレクトリを参照

実行例

create モード

# Phase 1-3: LLMがagents/を参照して実行
# 各TaskでJSONを生成し、スクリプトで検証

# Phase 4: スクリプトで生成
node scripts/init_skill.mjs my-skill --path .claude/skills
node scripts/generate_skill_md.mjs --plan .tmp/structure-plan.json

# Phase 5: スクリプトで検証・スキルリスト更新
node scripts/validate_all.mjs .claude/skills/my-skill
node scripts/update_skill_list.mjs --skill-path .claude/skills/my-skill

update モード

# モード判定
node scripts/detect_mode.mjs --request "スキルを更新" --skill-path .claude/skills/my-skill

# LLMがdesign-update.mdを参照して更新計画を生成

# 更新適用（dry-run）
node scripts/apply_updates.mjs --plan .tmp/update-plan.json --dry-run

# 更新適用（実行）
node scripts/apply_updates.mjs --plan .tmp/update-plan.json --backup

# 検証・スキルリスト更新
node scripts/validate_all.mjs .claude/skills/my-skill
node scripts/update_skill_list.mjs --skill-path .claude/skills/my-skill

improve-prompt モード

# プロンプト分析
node scripts/analyze_prompt.mjs --skill-path .claude/skills/my-skill --verbose

# LLMがimprove-prompt.mdを参照して改善計画を生成

# 更新適用
node scripts/apply_updates.mjs --plan .tmp/update-plan.json --backup

# 検証・スキルリスト更新
node scripts/validate_all.mjs .claude/skills/my-skill
node scripts/update_skill_list.mjs --skill-path .claude/skills/my-skill

ベストプラクティス

すべきこと

避けるべきこと

リソース参照

scripts/（決定論的処理）

agents/（LLM Task仕様）

schemas/（入出力スキーマ）

references/（詳細知識）

assets/（テンプレート）

変更履歴