skill-reviewer

スキルレビュアー

Claude Code スキルの品質と互換性を監査します。オーケストレーターとして、構造と品質のチェックは既存のツールに委任し、自身は互換性の監査に専念します。

前提条件

ツール	種類	必須	インストール
skill-creator	スキル	はい	ほとんどの AI コーディングエージェント（Claude Code、Cursor など）に組み込み済み

スキルの読み込み時に、これらのツールを事前に確認しないでください。ツールが見つからずコマンドが失敗した場合は、インストールと設定の手順をユーザーに直接案内してください。

監査手順

Step 1: 構造の検証（委任）

skill-reviewer に付属する検証スクリプトを実行し、YAML frontmatter、name の形式、description の形式などの結果をまとめます。

bash <skill-reviewer-dir>/scripts/validate.sh

スクリプトが利用できない場合（例：npx skills 経由でインストールされていない場合）は、各 SKILL.md の YAML frontmatter を手動で確認します。name（ハイフン区切りの小文字、64 文字以下）、description（山括弧なし、1024 文字以下）。

Step 2: 内容の品質（委任）

必ず実行：skill-creator スキルを呼び出し、詳細な品質レビュー（トークン効率、段階的開示、アンチパターン、description のベンチマークなど）を行います。

skill-creator が利用できない場合は、必ず作業を中断し、ユーザーに確認を促してください。この手順を省略してはいけません。ほとんどの AI コーディングエージェントには skill-creator が組み込まれています。

• Claude Code：document-skills:skill-creator または skill-creator:skill-creator
• その他のエージェント：対応するスキル管理機能を確認してください

この手順は省略できません。skill-creator を使用しない監査は不完全です。

Step 3: 互換性の監査（自身の主要な役割）

references/compatibility-checklist.md に従い、対象スキルのすべてのファイル（SKILL.md + scripts/ + references/）を項目ごとに確認します。

3a. クロスプラットフォーム互換性 — プラットフォーム固有のパターン（macOS 専用コマンド、Windows 非互換項目など）をスキャンします。

3b. エージェント間の互換性 — Claude Code 専用のツール参照と MCP 依存関係を検出します。

3c. npx skills エコシステムとの互換性 — marketplace.json の登録、シンボリックリンクの利用可否、スキル間の依存関係を検証します。

3d. ツール参照の規約 — Claude Code のツール用語が維持され、他の環境向けのフォールバックに関する注記があるか確認します。詳しくはチェックリストの「Tool Reference Best Practices」セクションを参照してください。

3e. 前提条件の宣言 — SKILL.md に外部依存関係が宣言されているか確認します。

• スキルが外部 CLI ツール（git、gh、reminders-cli など）、MCP サーバー、または別のスキルを使用する場合、## Prerequisites セクションが必須です。
• Prerequisites は本文の最初の ## セクションでなければなりません。
• セクションには、Tool / Type / Required / Install の 4 列からなる表を必ず含めます。
• Type 列では、標準値の cli、mcp、skill、system を必ず使用します。
• 表の後には、受動的な確認に関する説明（blockquote）を必ず記載し、実行に失敗した場合は外部ドキュメントを案内するのではなく、インストールと設定をユーザーに直接案内するよう明記します。
• 設定が必要なツール（MCP サーバーや認証が必要な CLI など）は、Install 列に実行可能なインストールコマンドと設定手順を記載するか、スキルに付属する references/ ドキュメントを参照することが望ましいです。
• 外部依存関係のないスキルには、このセクションは不要です。

詳しくは references/compatibility-checklist.md を参照してください。

Step 4: レポートの出力

以下の形式で統合レポートを出力します。

## Skill Review: {skill-name}

### 总览
| 维度 | 状态 | 方式 |
|------|------|------|
| 结构与元数据 | PASS / FAIL | validate.sh |
| 内容质量 | PASS / FAIL (N issues) | skill-creator |
| 平台兼容性 | PASS / FAIL (N issues) | 自查 |
| Agent 兼容性 | PASS / FAIL (N issues) | 自查 |
| npx skills 生态 | PASS / FAIL (N issues) | 自查 |
| Prerequisites 声明 | PASS / WARN / N/A | 自查 |

### Critical
- **[维度]** 问题描述
  当前: ...
  建议: ...

### High
...

### Medium / Low
...

重大度の分類：

• Critical — 機能が利用できない、または配布に失敗するため、修正が必須です
• High — 利用可能な範囲に大きく影響するため、修正を推奨します
• Medium — 改善できる項目ですが、コア機能には影響しません
• Low — 改善を推奨する項目です