作者 marian2js · marian2js/skill-doctor
出荷前にクロード スキルをリントします。フロントマター、リソース参照、トリガーの明確さ、評価の衛生状態、重大度によるスコア 0 ～ 100。
skill-doctor は、ローカル スキル パッケージをスキャンし、アクティベーション、信頼性、または品質を損なう問題にフラグを立てる CLI です。 YAML フロントマターとメタデータをチェックし、リソース参照が壊れていないことを確認し、トリガーの説明を明確に評価して、evals/evals.json を検証します。 出力は、重症度にラベル付けされた所見を含む 0 ～ 100 のスコアです。 テキスト、JSON、スコア専用モードをサポートしており、コミット前、ルート前、または CI ゲートに最適です。
使うタイミング： あなたはスキルを終了し、他の人がそれをインストールする前に正気度パスが必要です。
結果： 期待したときに発動し、参照が壊れていないスキル。
使うタイミング： スキルを頻繁に出荷しており、ドリフトを防止したいと考えています。
結果： スキルの品質を低下させる PR はマージ前に検出されます。
使うタイミング： スキルをインストールしましたが、クロードがそれを発動しません。
結果： より明確なアクティベーション。 クロードは適切なタスクに応じてスキルを選択します。
マーケットプレイスに公開する前のリント
スキルドクターを他のスキル作成ツールと連携させる
オーサリングガイドに従って、lint を実行します
| ツール | 入力 | 呼び出すタイミング | コスト |
|---|---|---|---|
| skill-doctor <path> | skill directory path | 公開前、CI 内、またはアクティベーションの問題の診断 | 0 |
医師はSKILL.mdが見つからないと言うリポジトリのルートではなく、スキル ルート (SKILL.md を含むディレクトリ) から実行します。
ls SKILL.md in CWD「evals/evals.json」スキーマの失敗各評価に必須フィールドがあることを確認してください。 最小限のスタブは壊れるよりはマシです。
jq . evals/evals.json編集してもスコアが上がらない再実行します。 検出結果が解決しない場合は、重大度と詳細を確認してください。修正により、重大度の低い新しい問題が発生する場合があります。
Diff the JSON reports between runs| 代替案 | 代わりに使う場面 | トレードオフ |
|---|---|---|
| agent-skills-cli-skill | スキャフォールディング/スキル管理のための一般的な CLI ツールが必要 | 異なる機能セット。 リンターではありません |
| claude-skill | オーサリング ガイドに「良い」とはどのようなものかを理解してもらいたい | リンターではなくドキュメント |