作者 marian2js · marian2js/skill-doctor
出荷前にクロード スキルをリントします。フロントマター、リソース参照、トリガーの明確さ、評価の衛生状態、重大度によるスコア 0 ～ 100。
skill-doctor は、ローカル スキル パッケージをスキャンし、アクティベーション、信頼性、または品質を損なう問題にフラグを立てる CLI です。 YAML フロントマターとメタデータをチェックし、リソース参照が壊れていないことを確認し、トリガーの説明を明確に評価して、evals/evals.json を検証します。 出力は、重症度にラベル付けされた所見を含む 0 ～ 100 のスコアです。 テキスト、JSON、スコア専用モードをサポートしており、コミット前、ルート前、または CI ゲートに最適です。
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"skill-doctor-skill": {
"command": "npx",
"args": [
"-y",
"skill-doctor@latest",
"."
],
"_inferred": false
}
}
}Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。
{
"mcpServers": {
"skill-doctor-skill": {
"command": "npx",
"args": [
"-y",
"skill-doctor@latest",
"."
],
"_inferred": false
}
}
}Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。
{
"mcpServers": {
"skill-doctor-skill": {
"command": "npx",
"args": [
"-y",
"skill-doctor@latest",
"."
],
"_inferred": false
}
}
}Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。
{
"mcpServers": {
"skill-doctor-skill": {
"command": "npx",
"args": [
"-y",
"skill-doctor@latest",
"."
],
"_inferred": false
}
}
}Claude Desktop と同じ形式。Windsurf を再起動して反映。
{
"mcpServers": [
{
"name": "skill-doctor-skill",
"command": "npx",
"args": [
"-y",
"skill-doctor@latest",
"."
]
}
]
}Continue はマップではなくサーバーオブジェクトの配列を使用。
{
"context_servers": {
"skill-doctor-skill": {
"command": {
"path": "npx",
"args": [
"-y",
"skill-doctor@latest",
"."
]
}
}
}
}context_servers に追加。保存時に Zed がホットリロード。
claude mcp add skill-doctor-skill -- npx -y skill-doctor@latest .ワンライナー。claude mcp list で確認、claude mcp remove で削除。
使うタイミング： あなたはスキルを終了し、他の人がそれをインストールする前に正気度パスが必要です。
結果： 期待したときに発動し、参照が壊れていないスキル。
使うタイミング： スキルを頻繁に出荷しており、ドリフトを防止したいと考えています。
結果： スキルの品質を低下させる 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 | オーサリング ガイドに「良い」とはどのようなものかを理解してもらいたい | リンターではなくドキュメント |