skillcheck: SKILL.mdファイルのクロスエージェント互換性問題を検出するリンター

skillcheckの機能

skillcheckは、agentskills.io仕様に準拠してSKILL.mdファイルを検証するリンターです。Claude Code用に書かれたスキルが、nameフィールドの不一致やその他のクロスエージェント互換性の問題によりVS Codeで読み込めない問題に遭遇した後、作成されました。

主な機能

• 発見可能性のための説明文品質を0-100でスコアリング（エージェントはこのフィールドを使用してスキルをアクティベートするかどうかを決定）
• Claude Codeでのみ機能し、VS Code、Codex、Cursorでは機能しないフィールドについて警告
• SKILL.md本文内のファイル参照がディスク上に存在するファイルを指しているかチェック
• 仕様からの段階的開示トークン予算を検証
• CI統合のためのJSON出力と終了コードを提供
• GitHub Actionを含む

インストールと使用方法

pip経由でインストール: pip install skillcheck

ファイルまたはディレクトリを指定して実行: skillcheck path/to/skill.md または skillcheck path/to/skills/directory

技術詳細

• Python 3.10+で構築
• 依存関係はPyYAMLのみ
• MITライセンス
• ClaudeとVS Codeの支援を受けて構築

既存ツールとの比較

作成者はskillcheckを構築する前に、skills-ref、cclint、skills-cli、Anthropicのquick_validate.pyを含むすべての既存バリデータのソースコードを読みました。説明文のスコアリング、クロスエージェント警告、ファイル参照チェックは、これらの既存ツールのいずれにも存在しません。フロントマター検証の一部は既存バリデータと重複しています。