skill-prune について
skill-pruneは、エージェントスキルの孤立・古い・重複した内容を整理する保守用スキルです。明確な基準と安全ルールで候補を評価し、削除は承認済みの計画に基づいて行います。
主な機能
- 01内容を整理する4つの基準
- 02保護対象ファイルの安全確認
- 03理由付きの削除計画
- 04整理後のリンクと重複の確認
活用シーン
- 01定期的なスキルの保守
- 02リンターが報告した孤立項目の確認
- 03上限を超えたスキルファイルの整理
- 04終了した課題に関する内容の削除
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ transilienceai/ communitytools --skill skill-pruneインストール後、Claude Code で/skill-pruneを入力して読み込まれたか確認します。
詳細
スキルの整理
/skill-updateの逆です。内容を追加するのではなく削除します。四半期ごとのメンテナンス時、エンゲージメント終了後、またはscripts/skill_linter.pyが孤立項目や重複を報告したときに実行します。
実行するタイミング
- 四半期ごとの定期実行時。
scripts/skill_linter.py --check-orphansが孤立した参照ファイルを報告した後。- SKILL.mdまたは参照ファイルが上限を超え、内容を削る必要があるとき。
- 専門性を下げるための一斉見直し後、終了した課題に関連する内容を削除するとき。
整理の基準(4つのシグナル — /skill-updateと同じ形式で、逆の操作)
参照ファイル/シナリオ/行は、次のいずれかに該当する場合、削除候補になります。
- 孤立 — 過去60日間、どのSKILL.mdや他の参照ファイルからもリンクされていない。
- 失敗したエンゲージメントからのみ参照されている —
status=BLOCKEDで終了した実行のattack-chain.mdに登場し、成功したチェーンには一度も登場していない。 - 新しい内容と矛盾している — 後から追加されたシナリオ/パターンに置き換えられており、古い項目が現在の手法を反映していない。
- 新しい内容と重複している — 同じ手法が他の場所で、より明確に説明されている。
これらのいずれにも該当しない内容は削除せず、残します。
安全ルール
- ``注釈が付いたファイルは、絶対に削除しないでください。
- 進行中のエンゲージメントの
OUTPUT_DIR/attack-chain.mdで引用されている内容は、絶対に削除しないでください。 - 単一オーナールール(brute-force、output-discipline、env-reader、skill-update)の標準配置ファイルは、絶対に削除しないでください。
- 運用上の知識よりも、技術的な内容が豊富なものを残すようにしてください。
手順
scripts/skill_linter.py --check-orphansを実行して孤立項目を洗い出します。- 候補となるファイルまたはブロックごとに、4つのシグナルを評価します。
- 削除計画を作成します。削除するファイル/行と、それぞれの簡潔な理由を示します。
- 計画の承認後にのみ削除を適用します(skill-pruneは実行時に自動削除しません)。
scripts/skill_linter.pyを再実行し、変更によって他のリンクが壊れていないこと、重複が再発していないことを確認します。
出力
簡潔な変更レポート:
- 削除済み。 ファイルまたはブロックと、それぞれの簡潔な理由。
- 保持(要フォローアップ)。 4つのシグナルのいずれにも該当しないものの、次の四半期に再確認する価値がある項目。
- 削除なし。 削除に値するものがなかった場合は、明示します。
アンチパターン
- 古いという理由だけで内容を削除すること — 古さだけではシグナルにならず、重要なのは関連性です。
- 親のSKILL.mdが肥大化しているという理由で参照ファイルを削除すること — SKILL.mdのほうを修正してください。
- 単一オーナーの標準配置ファイル(brute-force/output-discipline/env-reader)を削除すること。
- 内容が参照される可能性のある進行中のエンゲージメント中に削除すること。
コメント
Markdown 対応