スキル作成ガイド

新規スキルの作成方法

1. テンプレートをコピー

# 原子スキルの場合
cp -r skills/atomic/_template skills/atomic/{new-skill-name}

# 合成スキルの場合
cp -r skills/composite/_template skills/composite/{new-skill-name}

2. SKILL.md を編集

templates/atomic_skill.md または templates/composite_skill.md を参考に、SKILL.md をフル記述する。

3. 必須項目

YAML Front Matter

---
name: skill-name        # kebab-case
type: atomic | composite
description: 具体的な説明  # いつ使うか、何をするかを明確に
provider: claude | gemini | local_llm
token_estimate: low | medium | high
version: "1.0"
created: "YYYY-MM-DD"
created_by: manual | auto-learned
---

Description の書き方

悪い例: 「テキスト処理スキル」

良い例: 「PDFからテーブルを抽出しCSVに変換する。データ分析ワークフローで使用。」

Description は Claude がスキルを選択する際の判断材料。具体的なユースケースを明記する。

4. registry.yaml に登録

# skills/registry.yaml
atomic_skills:
  - name: "new-skill"
    path: "skills/atomic/new-skill/SKILL.md"
    provider: "claude"
    triggers:
      keywords: ["トリガーワード"]
      command: "/new-skill"
    token_weight: "low"
    status: "active"

5. CLAUDE.md のテーブルに追加

Atomic Skills テーブルに行を追加。

命名規則

• kebab-case: text-summarize, code-review
• 動詞+名詞 or 名詞+名詞
• 12文字以内を推奨
• 既存スキルと被らないこと