skill-creator - スキル作成

​

いつ起動するか

• ユーザーが URL やリモートリポジトリからスキルをインストールしたいとき
• ユーザーが新しいスキルをゼロから作成したいとき
• 既存のスキルをアップグレード・リファクタリングする必要があるとき

​

スキルとは

1. 専門ワークフロー — ある種のタスクの完全な手順
2. ツールの使い方 — 特定の API やファイル形式の処理方法
3. ドメイン知識 — チームの規約、ビジネスルール、データ構造など
4. 付属リソース — スクリプト、参考ドキュメント、テンプレートなど

​

ディレクトリ構成

skill-name/
├── SKILL.md            # 必須：スキル定義
│   ├── YAML frontmatter（name / description は必須）
│   └── Markdown 本文（説明 + 例）
└── オプションリソース
    ├── scripts/        # 実行可能スクリプト（Python / Bash など）
    ├── references/     # 分量が多い参考ドキュメント（Agent が必要時に読む）
    └── assets/         # テンプレート、アイコンなど（出力に直接使われるもの）

​

SKILL.md 仕様

metadata:
  cowagent:
    requires:
      env: ["MYAPI_KEY"]            # 必須

metadata:
  cowagent:
    requires:
      anyEnv: ["OPENAI_API_KEY", "LINKAI_API_KEY"]   # いずれか 1 つ

​

リソースディレクトリの使い方

​

外部スキルのインストール

1. SKILL.md を見つける（アーカイブのルートまたはサブディレクトリにある場合がある）
2. frontmatter から name を読み取る
3. スキルディレクトリ全体（SKILL.md、scripts/、assets/ など）を <workspace>/skills/<name>/ にコピー
4. アーカイブに INSTALL.md などのセットアップスクリプトがあれば実行するが、最終的に <workspace>/skills/<name>/ に収まっている必要がある

​

スキルをゼロから作成

1. 要件を明確にする — ユーザーに具体的なユースケースをいくつか挙げてもらう（一度に多く聞きすぎない）
2. 構成を計画する — スクリプトは必要か？参考ドキュメントは？テンプレートは？
3. スキャフォールド — 初期化スクリプトを使用：
   scripts/init_skill.py <skill-name> --path <workspace>/skills [--resources scripts,references,assets] [--examples]
   
4. 内容を埋める — SKILL.md を書き、スクリプトとリソースを追加。スクリプトは必ず実行テストする
5. バリデーション（任意）：
   scripts/quick_validate.py <workspace>/skills/<skill-name>
   
6. イテレーション — 実際の使用フィードバックに基づいて継続的に改善

​

命名規則

• 小文字、数字、ハイフンのみ使用。ユーザーの入力は正規化する（例: Plan Mode → plan-mode）
• 64 文字以内
• 短く、動詞で始め、一目で何をするか分かるように
• 必要に応じてツール名をプレフィックスにする（例: gh-address-comments、linear-address-issue）
• ディレクトリ名と name フィールドは完全に一致させる

​

3 段階ローディング

1. メタ情報（name + description） — 常にコンテキスト内（約 100 語）。Agent がスキルを使うかどうかの判断に使用
2. SKILL.md 本文 — スキルが有効化されたときだけロード。500 行以内を推奨
3. リソースファイル — Agent が必要なときに読み込む

cloud-deploy/
├── SKILL.md             # メインワークフローとプロバイダー選択ロジック
└── references/
    ├── aws.md
    ├── gcp.md
    └── azure.md

​

よくあるデザインパターン

1. フォーム構造を分析（analyze_form.py を実行）
2. フィールドマッピングを生成（fields.json を編集）
3. フォームを自動入力（fill_form.py を実行）

1. 操作タイプを判定：
   **新規作成？** → 「作成フロー」へ
   **既存の編集？** → 「編集フロー」へ