skill-improver について
skill-improver は、実行時の成果物を分析し、Skills と Workflows の改善案を提案します。失敗、時間のボトルネック、確認手順の問題、成果物契約の不足を特定し、優先順位付きの提案と任意の最小パッチを出力します。
主な機能
- 01実行ログと状態の分析
- 02失敗と時間のボトルネックの検出
- 03成果物の命名と保存の確認
- 04優先順位付き改善案
- 05最小限のスキルパッチの作成
活用シーン
- 01実行後のワークフロー改善
- 02繰り返す失敗や非効率な手順の特定
- 03ワークフロー成果物の一貫性確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/skill-improverを入力して読み込まれたか確認します。
詳細
スキル改善ツール
実行時に生成された成果物をもとにスキル／ワークフローを振り返って改善し、使用を重ねることでスキルチェーンをより安定させます。
入力（パスのみを渡す）
run_dir：runs/<workflow>/active/<run_id>/（またはopenspec/changes/<change-id>/）
出力
improvements.md：改善提案（変更タスクに直接変換できます）- 任意：該当する
SKILL.mdへの最小限のパッチ（必要な箇所のみ変更）
プロセス
logs/state.jsonとlogs/events.jsonlを読み、以下を抽出します。- 失敗箇所（エラーの種類、頻度、コンテキスト不足）
- 時間のボトルネック（繰り返し行う手順、効果のない検索、過剰なコンテキスト）
- 手動確認のタイミング（早すぎる／遅すぎる／実施されていないか）
- 成果物の契約を確認します。
- 各ステップで出力が永続化されているか
- コンテンツではなくパスだけが渡されているか
- 名前やパスに一貫性がないか
- 改善提案を効果の高い順に出力します。
- プロンプト／トリガーワードの最適化
- 入出力の契約の補完（必須フィールドの追加、成果物のファイル名の修正）
- エラー処理と拒否戦略
- 決定的なスクリプトの新規提案（必要な場合のみ）
出力テンプレート（推奨）
- 概要：この実行で判明した主な問題
- 主な問題（優先度の高い順）：それぞれ「症状／根本原因／修正案／関連スキル／変更箇所の提案」を記載
- 最小限の変更案：ファイル別に記載
コメント
Markdown 対応