name: skill-manager
⚠️ 新規スキル作成前に必ずこのスキルを読むこと!
全スキルの作成・更新・監査時に適用する設計原則:
詳細 + 監査チェックリスト →
references/design-principles.md
| # | 原則 | 要約 |
|---|---|---|
| 1 | 当たり前を書かない | Claude が知っている情報は省く |
| 2 | 落とし穴セクション | ## ⚠️ よくある落とし穴 を全スキルに。使うたびに育てる |
| 3 | 段階的開示 | references/ と scripts/ に分離。SKILL.md は 200行以下 |
| 4 | 過度な制約を避ける | 外しても間違えない制約は不要 |
| 5 | セットアップフロー | ユーザー設定が必要なら仕組みを入れる(我々は大半不要) |
| 6 | description = トリガー条件 | 「いつ使うか」をトリガーワードで書く |
| 7 | 記憶とデータ永続化 | LEARNINGS.md 必須。実行ログの保存も検討 |
全てのスキルは自己拡張型で作る。 タスク完了時に学びを蓄積し、次回以降の作業効率を向上させる。
必須構成:
skill-name/
├── SKILL.md # メイン手順書
├── LEARNINGS.md # 蓄積される学び(タスク完了時に追記)
└── (オプション)
├── PROJECT-CONTEXT.md # プロジェクト固有情報
├── scripts/ # 実行スクリプト
└── references/ # 参照ドキュメント
LEARNINGS.md テンプレート →
references/template-learnings.md
スキル乱立を防ぐ! 新規作成前に必ず既存スキルを確認する。
既存スキル検索スクリプト →
scripts/check-existing-skills.sh使い方:bash scripts/check-existing-skills.sh "キーワード"
判断フロー図 →
references/decision-flow.md
要約: 類似スキルが存在する → 改善で対応できるなら改善、できないなら統合して新スキル化。存在しない → 新規作成。
scripts/check-existing-skills.sh を使って既存スキルを確認する。
判断:
設計メモテンプレート →
references/template-skill-design.md
名前(kebab-case、64文字以内)、目的、トリガー、自己拡張ポイント、既存スキルとの関係を整理する。
mkdir -p ~/.openclaw/skills/[スキル名]
以下のテンプレートを使って必須ファイルを作成する:
references/template-skill.mdreferences/template-learnings-init.mdls -la ~/.openclaw/skills/[スキル名]/
cat ~/.openclaw/skills/[スキル名]/SKILL.md
| 場所 | 用途 | 同期方法 |
|---|---|---|
~/.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/ に実体を作成skills-sync-check.sh が2消費先に自動でシンボリックリンクを作成既存スキルの品質を 7 原則で監査する場合:
references/design-principles.md の監査チェックリスト(10項目)で採点一括監査: bash scripts/check-existing-skills.sh で全スキルの一覧を取得し、順に監査。
references/design-principles.md/opt/homebrew/lib/node_modules/openclaw/skills/skill-creator/~/clawd/TOOLS.md の「スキル管理方針」セクション~/.openclaw/scripts/skills-sync-check.shgrep -r "キーワード" ~/.openclaw/skills/*/SKILL.md で類似スキルを検索してから判断する~/.openclaw/skills/ 以外に作る: 正本は常に ~/.openclaw/skills/。~/.claude/skills/ や ~/.agents/skills/ は日次 cron でシンボリックリンクが作成される消費先であり、ここに実体を作ると同期が壊れる