name: skill-evolution-workflow description: "スキル探索 → 試行 → 自作 → 改善 → ドラフト記事化の一連のワークフロー。「スキルを探して」「スキルを作りたい」「新しいスキルを開発して記事にする」などで発火。"

Skill Evolution Workflow

スキル探索 → 試行 → 自作 → 改善 → ドラフト記事化の一連のワークフロー。

トリガー

「スキルを探して」「○○するスキルを作りたい」
「新しいスキルを開発して記事にする」
既存スキルで課題にぶつかった時

ワークフロー

Phase 1: スキル検索
    ↓
Phase 2: まず試す（既存機能）
    ↓
Phase 3: 評価する
    ↓ 不十分なら
Phase 4: 自作する
    ↓
Phase 5: さらに改善（ドメイン知識深掘り）
    ↓
Phase 6: 元のスキルから学ぶ
    ↓
Phase 7: 共有する（登録 + 記事化）

Phase 1: スキル検索

1.1 Agent Skill Searchで検索

ブラウザ: https://agent-skill-search.craftgarden.studio
MCP: mcp call agent-skill-search search_skills '{"query": "キーワード"}'

1.2 候補を評価

評価軸	確認ポイント
機能	やりたいことができるか
依存	外部API依存は許容できるか
カスタマイズ性	要件に合わせて調整できるか

Phase 2: まず試す

重要: いきなり自作せず、既存機能を試す！

2.1 スキルをインストール

# OpenClaw skills
cp -r <skill-path> ~/.openclaw/skills/

# または Claude Code skills
cp -r <skill-path> ~/.claude/skills/

2.2 実際に使ってみる

基本機能を試す
エッジケースを確認
出力品質を評価

2.3 結果を記録

試行結果テンプレート → references/template-trial-result.md

Phase 3: 評価する

判断基準

状況	判断
要件を満たす	→ 採用（Phase 7へ）
微調整で対応可能	→ フォーク or 拡張
根本的に機能が足りない	→ 自作（Phase 4へ）
ブランド/独自性が必要	→ 自作（Phase 4へ）

Phase 4: 自作する

4.1 スキルディレクトリ作成

mkdir -p ~/.openclaw/skills/<skill-name>/scripts

4.2 必須ファイル

<skill-name>/
├── SKILL.md       # 手順書（このファイルのようなもの）
├── LEARNINGS.md   # 学びの蓄積（自己拡張）
└── scripts/       # 実行スクリプト

4.3 実装 → テスト → デプロイ

コア機能を実装
ローカルでテスト
本番環境にデプロイ
動作確認

Phase 5: さらに改善

5.1 ドメイン知識を深掘り

例: アプリアイコン作成の場合

Apple HIG（Human Interface Guidelines）
Liquid Glass デザインシステム（WWDC 2025）
プラットフォーム別要件

5.2 改善を実装

v1 → v2 の差分を明確に
Before/After を記録
画像として保存

Phase 6: 元のスキルから学ぶ

自作した後、改めて元のスキルを分析！

6.1 見落としていた機能を特定

機能	取り込み
バリデーション	✅ / ❌
追加出力形式	✅ / ❌
自動化機能	✅ / ❌

6.2 良い機能を自作スキルに取り込む

Phase 7: 共有する

7.1 Agent Skill Searchに登録

スキル登録スクリプト → scripts/register-skill.sh

# 使い方
./scripts/register-skill.sh "<スキル名>" "<slug>" "<説明>" ["<関連スキルslug>"]

7.2 Content Studioにドラフト作成

ドラフトテンプレート → references/template-draft.md

テンプレートを元に ~/Dev/content-studio/drafts/YYYY-MM-DD-<slug>.md を作成する。

7.3 画像配置 & デプロイ

公開スクリプト → scripts/publish-draft.sh

# 使い方
./scripts/publish-draft.sh "<slug>" [<image-dir>]

注意: 画像は drafts/images/ と web/public/draft-images/ の2箇所に配置が必要（スクリプトが自動処理）。

7.4 URLで確認

https://content-studio.craftgarden.studio/draft/<slug>

チェックリスト

ワークフロー完了確認

Phase 1: スキル検索した
Phase 2: 既存機能を試した
Phase 3: 評価して判断した
Phase 4: 自作した（必要な場合）
Phase 5: ドメイン知識で改善した
Phase 6: 元のスキルから学んだ
Phase 7: 共有した

成果物確認

スキルが ~/.openclaw/skills/ に存在
SKILL.md が完成
LEARNINGS.md が存在
Agent Skill Search に登録済み
関連スキルが紐付け済み
Content Studio にドラフト作成済み
画像が表示される
LEARNINGS.md に今回の学びを追記した

参考

⚠️ よくある落とし穴

いきなり自作してしまう: 既存スキルを試さずに自作を始めるのは最大の落とし穴。ワークフローの順序（探す → 試す → 評価 → 自作）を守る。試してから「足りない」と判断しても遅くない
デプロイ前に「動いた」と報告する: ローカルで動作確認しただけで完了報告してしまうケース。必ず本番URLで確認してから報告する
画像を1箇所にしか配置しない: Content Studio で記事化する際、画像は drafts/images/ と web/public/draft-images/ の2箇所に配置する必要がある。片方だけだと本番で画像が表示されない
LEARNINGS.md への追記を忘れる: ワークフロー完了時に学びを記録しないと、自己拡張型の価値がなくなる。完了チェックリストの最終項目として必ず追記する