---
name: reviewing-skills
description: >-
  Claude Codeスキルを公式ベストプラクティスに基づいてレビューする。SKILL.mdファイルのレビュー、
  スキル品質のチェック、スキル構造の検証、改善提案が必要な場合に使用。
  トリガー：「このスキルをレビューして」「スキル品質をチェック」「SKILL.mdを検証」
  「このスキルを改善」などのスキルレビューリクエストで起動。
---

# スキルレビュー

公式ベストプラクティスに基づいてスキルをレビューし、具体的な改善提案を行う。

## レビューワークフロー

### ステップ1: 対象スキルの特定

レビュー対象のSKILL.mdファイルを特定する：

- ユーザーがパスを直接指定
- カレントディレクトリでSKILL.mdを検索
- 複数のスキルが存在する場合はユーザーに確認

### ステップ2: 読み込みと分析

1. 対象のSKILL.mdファイルを完全に読み込む
2. [best-practices.md](references/best-practices.md) でチェックリストを確認
3. YAMLフロントマター（name, description）を解析
4. ボディコンテンツの構造を分析

### ステップ3: ベストプラクティスとの照合

各カテゴリを評価：

**フロントマターチェック**

- name: 長さ、形式、命名規則
- description: 完全性、具体性、トリガー

**ボディチェック**

- 行数（目標: 500行以下）
- 構造の明確さ
- Progressive Disclosureの使用
- ワークフロー設計の品質

**コンテンツチェック**

- 用語の一貫性
- 例の品質
- テンプレートの適切さ

**アンチパターン検出**

- デフォルトなしの複数選択肢
- Windowsスタイルのパス
- 時間に依存する情報
- マジック定数

### ステップ4: レビューレポート生成

出力形式：

```markdown
# スキルレビューレポート: {skill-name}

## サマリー
- 総合評価: {PASS | NEEDS_IMPROVEMENT | CRITICAL_ISSUES}
- Critical: {件数}
- Warning: {件数}
- Info: {件数}

## Critical（必須修正）
{修正必須の問題をリスト}

## Warning（推奨修正）
{推奨される改善をリスト}

## Info（改善提案）
{オプションの強化をリスト}

## 具体的な推奨事項
{例を含む具体的なアクションアイテム}
```

### ステップ5: インタラクティブな改善

レポート提示後：

1. ユーザーに修正を希望するか確認
2. Critical問題を優先的に修正
3. 段階的に修正を適用
4. 各修正後に再検証

## 重大度分類

### Critical

スキルの正常な機能を妨げる問題：

- descriptionが空または不足
- ボディが500行を大幅に超過
- スクリプトのセキュリティ脆弱性
- スクリプトのエラー処理不足

### Warning

スキルの効果を低下させる問題：

- Progressive Disclosureが適用されていない
- 例が不十分
- 用語が一貫していない
- ワークフローが不明確

### Info

改善の機会：

- より簡潔にできる
- 構造の最適化
- 追加の例があると良い

## レビューセッション例

ユーザー: 「pdf-processorスキルをレビューして」

```
1. 読み込み: skills/pdf-processor/SKILL.md
2. ロード: references/best-practices.md
3. チェックリストに照らして分析
4. 日本語でレポート生成
5. 修正を提案
```