review-a-skill について
カタログ内のスキルを対象に、品質、関連性、安全性を評価し、保持、整理、削除の判断を支援するスキルです。
主な機能
- 01スキル内容とサニタイズ結果の確認
- 02メタデータと依存関係の調査
- 03SKILL.md のフロントマター検証
- 04メモと検証情報を付けて整理
- 05削除前の依存項目確認
活用シーン
- 01ライブラリへの追加前にスキルを審査
- 02カタログ項目のメタデータと構造を評価
- 03スキルの保持、整理、削除を判断
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/review-a-skillを入力して読み込まれたか確認します。
詳細
スキルをレビューする
目標
単一のスキルの品質、関連性、安全性を評価し、ライブラリに追加または保持する前に確認します。
ガードレール
- 自動化パイプラインで機械可読な出力を得るには、必ず
--format jsonを使用します。 - カタログ項目を確認するときは、出力サイズを制限するために必ず
--fieldsを使用します。 - スキルを整理または削除する前に、必ず
--dry-runを使用します。 info --format jsonの dependencies で他のスキルが依存しているかを確認せずに、スキルを削除してはいけません。
ワークフロー
- スキルの内容をプレビューし、品質と安全性を確認します。
npx ai-agent-skills preview <skill-name>
プレビューコマンドは内容をサニタイズします。サニタイズの警告が表示された場合は、先に調査してから進めてください。
- カタログ項目を確認し、メタデータが不足なく記載されているかを確認します。
npx ai-agent-skills info <skill-name> --format json --fields name,description,tags,collections,dependencies
- スキルの SKILL.md の構造を検証します。
npx ai-agent-skills validate <skill-name>
- スキルの整理（メモ、コレクション、検証）が必要な場合：
npx ai-agent-skills curate <skill-name> --notes "Reviewed: solid patterns" --verify --dry-run
npx ai-agent-skills curate <skill-name> --notes "Reviewed: solid patterns" --verify
- スキルを削除する場合：
npx ai-agent-skills curate <skill-name> --remove --dry-run
npx ai-agent-skills curate <skill-name> --remove --yes
判断基準
- 保持：説明が明確で、frontmatter が有効で、ライブラリの利用者にとって有用であり、インジェクションのパターンがありません。
- 整理：whyHere、コレクションへの配置、または検証ステータスの改善が必要です。
- 削除：重複している、古くなっている、ソースが壊れている、または疑わしい内容を含んでいます。
注意点
previewコマンドは、ベンダー提供（house）のスキルでのみ機能します。上流のスキルでは、説明と whyHere のみが表示されます。validateコマンドは frontmatter の構造を確認しますが、内容の品質は確認しません。品質の判断には、人またはエージェントによる確認が必要です。- 他のスキルが依存しているスキルを削除すると、依存関係グラフが壊れます。必ず最初に
dependencies.usedByを確認してください。
コメント
Markdown 対応