name: skill-manager description: スキルの作成・更新・監査・統廃合を管理する。新規スキル作成時は必ずこのスキルを使う。自己拡張型スキルの作成、7原則に基づくスキル品質監査、既存スキルの改善・統合の判断を含む。「スキル作成」「スキル追加」「スキル監査」「スキルレビュー」「skill audit」「スキル品質チェック」「スキル改善」「新しいスキルを作って」などの作業に使う。 metadata: 自己拡張型: 必須既存確認: 必須

Skill Manager — スキル作成・管理の統括スキル

⚠️ 新規スキル作成前に必ずこのスキルを読むこと！

🎯 基本方針

0. Skill 設計 7 原則に従う

全スキルの作成・更新・監査時に適用する設計原則:

詳細 + 監査チェックリスト → references/design-principles.md

#	原則	要約
1	当たり前を書かない	Claude が知っている情報は省く
2	落とし穴セクション	`## ⚠️ よくある落とし穴` を全スキルに。使うたびに育てる
3	段階的開示	references/ と scripts/ に分離。SKILL.md は 200行以下
4	過度な制約を避ける	外しても間違えない制約は不要
5	セットアップフロー	ユーザー設定が必要なら仕組みを入れる（我々は大半不要）
6	description = トリガー条件	「いつ使うか」をトリガーワードで書く
7	記憶とデータ永続化	LEARNINGS.md 必須。実行ログの保存も検討

1. 自己拡張型が基本

全てのスキルは自己拡張型で作る。 タスク完了時に学びを蓄積し、次回以降の作業効率を向上させる。

必須構成:

skill-name/
├── SKILL.md           # メイン手順書
├── LEARNINGS.md       # 蓄積される学び（タスク完了時に追記）
└── (オプション)
    ├── PROJECT-CONTEXT.md  # プロジェクト固有情報
    ├── scripts/            # 実行スクリプト
    └── references/         # 参照ドキュメント

LEARNINGS.md テンプレート → references/template-learnings.md

2. 既存スキル確認が必須

スキル乱立を防ぐ！ 新規作成前に必ず既存スキルを確認する。

既存スキル検索スクリプト → scripts/check-existing-skills.sh 使い方: bash scripts/check-existing-skills.sh "キーワード"

3. 判断フロー

判断フロー図 → references/decision-flow.md

要約: 類似スキルが存在する → 改善で対応できるなら改善、できないなら統合して新スキル化。存在しない → 新規作成。

📋 作成手順

Phase 0: 既存スキル確認（必須）

scripts/check-existing-skills.sh を使って既存スキルを確認する。

判断:

完全に同じ目的 → 既存を改善
一部重複 → 統合を検討
全く新しい領域 → 新規作成

Phase 1: スキル設計

設計メモテンプレート → references/template-skill-design.md

名前(kebab-case、64文字以内)、目的、トリガー、自己拡張ポイント、既存スキルとの関係を整理する。

Phase 2: ディレクトリ作成

mkdir -p ~/.openclaw/skills/[スキル名]

Phase 3: ファイル作成

以下のテンプレートを使って必須ファイルを作成する:

SKILL.md (必須) → references/template-skill.md
LEARNINGS.md (必須) → references/template-learnings-init.md

Phase 4: 確認

ls -la ~/.openclaw/skills/[スキル名]/
cat ~/.openclaw/skills/[スキル名]/SKILL.md

🔄 統廃合の判断基準

統合すべきケース

目的が80%以上重複
同じツール/サービスを対象
片方が他方の部分集合

分離すべきケース

対象プロジェクトが異なる
ワークフローが大きく異なる
専門性が高く肥大化する

廃止すべきケース

6ヶ月以上使われていない
より良いスキルに置き換えられた
対象サービスが終了

📁 スキル配置場所

場所	用途	同期方法
`~/.openclaw/skills/`	正本（全スキルの実体）	—
`~/.claude/skills/`	Claude Code 用	symlink → openclaw
`~/.agents/skills/`	Codex CLI USER-level 用	symlink → openclaw
`/opt/homebrew/.../openclaw/skills/`	OpenClaw本体のスキル（編集しない）	—

Note: ~/.codex/skills/ は Codex CLI の公式読み込みパスではない（公式は ~/.agents/skills/）。同期対象外。

同期ルール:

新規スキルは必ず ~/.openclaw/skills/ に実体を作成
日次 cron skills-sync-check.sh が2消費先に自動でシンボリックリンクを作成
消費先に実体ディレクトリがある場合は自動で openclaw に移動+リンク化

🔍 スキル監査モード

既存スキルの品質を 7 原則で監査する場合:

references/design-principles.md の監査チェックリスト（10項目）で採点
不合格項目を特定し、改善案を提示
けいたの承認後に修正を実行

一括監査: bash scripts/check-existing-skills.sh で全スキルの一覧を取得し、順に監査。

🔗 参照

Skill 設計 7 原則: references/design-principles.md
OpenClaw本体の skill-creator: /opt/homebrew/lib/node_modules/openclaw/skills/skill-creator/
スキル管理方針: ~/clawd/TOOLS.md の「スキル管理方針」セクション
同期スクリプト: ~/.openclaw/scripts/skills-sync-check.sh

⚠️ よくある落とし穴

既存スキルを確認せずに新規作成する: スキル乱立の最大の原因。Phase 0（既存スキル確認）は必須。grep -r "キーワード" ~/.openclaw/skills/*/SKILL.md で類似スキルを検索してから判断する
LEARNINGS.md を省略する: 自己拡張型が基本方針。LEARNINGS.md がないスキルは学びが蓄積されず、同じ失敗を繰り返す。完了チェックリストの最後に「LEARNINGS.md に追記」を必ず入れる
description にトリガー条件を書かない: description はスキルの発火条件を決める。「クイズ作成」「問題追加」などの具体的なトリガーワードを含めないと、適切なタイミングでスキルが選択されない
スキルの実体を ~/.openclaw/skills/ 以外に作る: 正本は常に ~/.openclaw/skills/。~/.claude/skills/ や ~/.agents/skills/ は日次 cron でシンボリックリンクが作成される消費先であり、ここに実体を作ると同期が壊れる