スキルの検証
skills/ 内のすべてのスキルを agentskills.io 仕様と Claude Code のベストプラクティスに対して検証します。
検証チェックリスト
各スキルディレクトリについて、以下を確認します。
仕様準拠 ( agentskills.io )
| チェック項目 | ルール |
|---|---|
name の形式 | 1～64文字、小文字英数字＋ハイフン、先頭/末尾/連続ハイフン禁止 |
name がディレクトリ名と一致 | ディレクトリ名は name フィールドと等しくなければならない |
description の長さ | 1～1024文字、空でないこと |
| オプションフィールドの妥当性 | license, metadata, compatibility が存在する場合に検証 |
ベストプラクティス ( Claude Code )
| チェック項目 | ルール |
|---|---|
| 説明文の形式 | 三人称、何をするか＋いつ使うかを記述 |
| 本文の長さ | 500行以下 |
| 読み込みは1階層のみ | SKILL.md が唯一のプログレッシブ・ディスクロージャのエントリポイント：すべての参照ファイルは SKILL.md から到達可能でなければなりません。参照ファイル同士はナビゲーションのために相互リンクしても構いません（下記注釈参照）。 |
| リンクは Markdown 形式 | ファイル名だけではなく [テキスト](https://raw.githubusercontent.com/callstackincubator/agent-skills/main/パス) を使用 |
| 重複なし | 説明文を本文で繰り返さない |
| 簡潔さ | Claude がまだ知らないコンテキストのみを追加 |
1階層ルール vs. クロスリンク 。1階層ルールが対象としているのはプログレッシブ・ディスクロージャの読み込み連鎖、つまり別の参照を先に読み込まなければ発見できない参照のことです（
SKILL.md→a.md→b.mdで、b.mdがSKILL.mdからリンクされていない場合）。これは欠陥です：読み込みプログラムからコンテンツが隠れてしまいます。このルールは ナビゲーション目的 のクロスリンクを禁止してはいません。AGENTS.md に従い、参照ファイルは「関連スキル」フッターで兄弟参照にリンクすることが求められており、これが必要です。クロスリンクは、両方の端点が
SKILL.mdから直接到達可能であれば問題ありません。別の参照を経由しなければ到達できない参照だけを問題として報告してください。
実行方法
-
すべてのスキルディレクトリを検索：
fd -t d -d 1 . skills/ -
各スキルについて、
SKILL.mdを読み、上記ルールに照らしてチェック -
以下の形式で問題を報告：
## 検証結果 ### skills/example-skill - [PASS] name の形式は有効 - [FAIL] name "example" がディレクトリ名 "example-skill" と一致しない - [PASS] description の長さは OK (156文字)