skill-curator

skill-curator

ワークフロー

1. 棚卸し — for d in <root>/*/*/; do grep -E '^(name|description):' "$d/SKILL.md"; done
2. 分類 — トピックごとにグループ化し、説明が重複しているペアや、両方のトリガーが発火する可能性があるペアに印を付けます。
3. 疑わしい項目を読む — 説明や正規表現だけで分類してはいけません。
4. 以下の分類体系に照らして分類します。
5. 調査結果と推奨する修正を提示 — 複数ファイルにまたがるリファクタリングの前に方針を確認します。小規模で独立した修正はそのまま進められます。
6. 修正して検証します。依頼されない限り、コミットしてはいけません。

分類体系

• 分岐したスクリプト — 同じスクリプトが複数のスキルにコピーされています。差分を確認してずれを調べます。所有者を1つにし、もう一方からはそちらを参照します。
• 矛盾 — 同じ成果物に対する指示が食い違っています。所有者を決め、もう一方はそちらに従います。
• 言い換え — あるスキルが別のスキルの内容を再度導き出しています。1行の参照に置き換えます。
• 肥大化 — 頻繁に読み込まれるファイルに、まれにしか使わない詳細が含まれています。references/ に外部化し、すぐ使う修正方法はインラインに残します。
• 未使用または予算超過 — セッションログで一度も読まれていないスキル、または説明の合計がハーネスのリスト予算を超えている状態です（Codex：コンテキストの2％。超過すると均等に切り詰められます）。steipete/agent-scripts skill-cleaner は Codex の両方の項目を測定します。それ以外では、説明のバイト数を手作業で合計してください。
• 内部の不備 — 見出しや番号の重複、参照先のないパス、使われていないコード。
• 問題の兆候 — 単独でも問題があるスキルです。238件のスキルを調査した結果（arXiv 2607.01456）、指摘する価値があるのは次の項目です。段階のないワークフロー、選択基準のない選択肢の羅列、正当化の抜け道（「通常は」「必要に応じて」）、埋もれた注意点（「注意事項」ではなく段落の途中にある落とし穴）、分かりにくい説明（何をするか、いつ使うか、キーワードが1つの文に混在）、時間の経過で変わる主張、三人称で書かれていない説明、フロントマター内の XML またはバックスラッシュ付きパス。

ルール

• 欠陥を指摘する前に、必ず申告された欠陥をすべて確認します。ヒューリスティックはコードブロックや意図的な並列構造を誤判定することがあります。
• 機能ごとに所有者を1つにし、もう一方からは明示的なパスで参照します。
• 段階的開示：説明 → SKILL.md（簡潔） → references/REFERENCE.md（詳細）。簡潔さの度合いは読み込み頻度に応じて調整します。
• 欠陥だけを修正します。周辺のリファクタリングや、余分な相互リンクは追加しません。

関連項目

• write-skill — 新しいスキルを作成します。