skill-improver について
既存のエージェントスキルを改善する作者向けのレビュースキルです。決定的なlintチェックと5つの観点での判断を組み合わせ、採点ではなく優先順位付きの修正案を提示します。
主な機能
- 01スキルの機械的なlintチェック
- 02名前、範囲、説明のレビュー
- 03構成と文書サイズの評価
- 04スクリプト、参照、アセットの確認
- 05具体的な改善案の優先順位付け
活用シーン
- 01共有前のスキルレビュー
- 02呼び出し条件の説明不足の発見
- 03referencesへ移す内容の特定
- 04lint結果を実行可能な修正に変換
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/skill-improverを入力して読み込まれたか確認します。
同梱ファイルscripts/skill-lint.sh
詳細
スキル改善
概要
既存のスキルを改善します。目標は採点ではなく、役立つ改善です。スコアではなく、作成者が適用できる具体的で優先順位の付いた変更を提示します。5 つの観点を確認し、機械的な事実の把握には付属のリンターを活用し、それ以外は判断に基づいて評価します。
基本原則： すべての指摘に、修正案を添えます。
入力
- 必須： スキルディレクトリ（
SKILL.mdを含む）またはSKILL.mdファイルへのパス。 - 任意： スキルの意図された目的（明記されている場合）。名前や範囲が意図に合っているかを判断する際に使います。
手順
- 機械的な事実を決定論的に収集する（スクリプトのパスはこのスキル自身のディレクトリからの相対パスです。その基準ディレクトリから実行してください）：
フロントマターの妥当性、名前の形式、説明の構成、SKILL.md のサイズ、推奨セクション、参照されているファイルと孤立したファイルを報告します。[FLAG] は手がかりとして扱い、最終判断とは見なさないでください。bash scripts/skill-lint.sh <skill-dir-or-SKILL.md> - SKILL.md と付属ファイルを自分で読む — リンターでは明瞭さ、範囲、正確性を判断できません。
- 5 つの観点を確認する（ガイドライン）。各指摘を具体的な修正案に落とし込みます。
- 影響の大きい順に優先順位を付ける。発見されにくくなる問題（説明が不十分など）や正確性に関わる問題を最初に挙げます。
- レポートを作成する（出力）。変更を適用することを提案し、依頼された場合は作成作業を
superpowers:writing-skillsに引き継ぎます。
ガイドライン
| 観点 | 良い状態 |
|---|---|
| 名前と範囲 | 動詞で始まり、能動的で、目的が明確に 1 つであること。曖昧なスキルや複数の目的を持つスキルは指摘し、分割を提案します。 |
| 説明 | 単に機能を述べるのではなく、どのようなときに呼び出すか（きっかけ／症状／状況）を示します。「クエリが遅い、またはインデックスについてユーザーが尋ねたときに使います」は適切ですが、「クエリを分析して最適化します」では不十分です。三人称で、「Use when」から始めます。手順の要約があるとエージェントが本文を読み飛ばすため、その点を指摘します。 |
| 構成 | 概要、入力、手順、ガイドライン、出力形式を推奨します。不足しているセクションを指摘し、内容の移動先を提案します。 |
| 簡潔な SKILL.md | 本文にはワークフローと判断基準を記述します。詳細な情報（API、長い表、大きな例）は references/ に置きます。膨らみすぎている箇所を指摘し、切り出す内容を明示します。 |
| 参照ファイル／スクリプト／アセット | 機械的な処理には決定論的なスクリプトを、再利用可能なコンテキストにはリファレンスを、テンプレートにはアセットを使います。孤立したファイルや非決定論的なスクリプトを指摘します。 |
特に価値の高い次の 2 つの改善機会を明確に探してください。切り出し（常に読み込まれる本文を簡潔にするため、インラインの内容を references/ ファイルに移す）と、決定論化（エージェントによって一貫しない手順を、小さなスクリプトで再現可能にする）です。
出力形式
## Skill review: <name>
Strengths: <1-2 lines>
### Suggested improvements (highest impact first)
1. [<dimension>] <observation> -> <concrete fix>
2. ...
### Extraction & determinism opportunities
- <inline content -> references/file.md>, <prose step -> scripts/x.sh>
Overall: <1-2 sentences, specific and encouraging. No score.>
よくある間違い
- 支援ではなく採点をする — スコアは付けません。各指摘には実行可能な修正案が必要です。
- リンターの結果をそのまま繰り返す — リンターのフラグは入力情報です。そこに、リンターではできない判断を加えます。
- 移動先を決めずに切り出す — 移動先のファイル名と、そこへ移す内容を明記します。
スクリプト
scripts/skill-lint.sh— 機械的なチェック（フロントマター、名前、説明、サイズ、セクション、孤立ファイル／非決定論的ファイル）を決定論的に実行します。読み取り専用です。スキルディレクトリまたはSKILL.mdのパスを渡してください。
ここでスクリプトを実行できない場合（bash やツールがない、または OS が異なるなど）：作業を中断しないでください。スクリプトは一般的な git／テキストコマンドを自動化しているだけなので、この環境で利用できるツールを使って同じ手順を直接再現してください。
コメント
Markdown 対応