skill-validator

スキルバリデーター

目的と意図

skill-validator は、このリポジトリの主要な品質管理ツールです。各 AI エージェントスキルが agentskills.io 標準とリポジトリの AGENTS.md ルールに照らして検証され、「機械で処理可能」であることを確認します。

使用する場面

• 開発中：スキルを作成または変更するたびに、このスキルを実行します。
• CI/CD 統合：準拠していないスキル定義を含むプルリクエストを自動的にブロックします。
• リポジトリ監査：仕様の変更に応じて長期的な準拠を維持するため、agent-skills/ ディレクトリ全体を定期的にスキャンします。

使用しない場面

• コードロジックの検証：このツールはスキルを「実行」したり、内部ロジックを検証したりしません。「契約」（YAML と Markdown）のみを検証します。

エラー条件とエッジケース

• 無効な YAML：skill.yaml を解析できない場合、バリデーターは構文エラーとともに直ちに失敗します。
• 必須フィールドの不足：agentskills.io の仕様で定義されたフィールドが不足している場合、is_valid: false になります。
• 空のディレクトリ：skill.yaml を含まない agent-skills/ 内のフォルダーは、無効なスキルとして報告されます。

セキュリティとデータ取り扱いに関する考慮事項

• 読み取り専用アクセス：このスキルに必要なのは、対象ディレクトリへの読み取り権限のみです。
• 外部呼び出しなし：検証は、組み込まれたスキーマルールを使用してローカルで実行されます。