mcpField
S
skill-review

skill-review

github.com/ovachieverテスト・品質5661 回インストール48 週間前に更新
リポジトリ

skill-review について

skill-reviewは、claude-skillsリポジトリのメンテナー向け監査スキルです。スクリプト検査とAIによる手動検証を組み合わせた9段階の手順で、古い情報や不整合、誤りを特定して修正します。

主な機能

  1. 019段階の監査ワークフロー
  2. 02メタデータとリンクの自動検査
  3. 03パッケージバージョンの確認
  4. 04ドキュメントとAPIの照合
  5. 05問題の重大度分類
  6. 06修正後の検証

活用シーン

  1. 01マーケットプレイス提出前のスキル監査
  2. 02パッケージのメジャー更新後の手順確認
  3. 03報告されたスキルのエラー調査
  4. 04検証日が古いスキルの再確認

MCP 対応

Context7 MCPが利用できる場合、ドキュメントに基づくAPIパターンの検証に使用します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/ovachiever/droid-tings --skill skill-review

インストール後、Claude Code で/skill-reviewを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
.claude-plugin/
plugin.json
references/
audit-report-template.md

詳細

スキルレビュースキル

概要

skill-review スキルは、claude-skills リポジトリ内のスキルを監査するための、包括的かつ体系的なプロセスを提供します。自動技術検証と AI を活用した確認を組み合わせ、スキルの正確性、最新性、高品質を維持します。

次のような場合にこのスキルを使用します：

  • スキルに問題がある疑いがあり、調査する場合
  • パッケージのメジャーバージョンが更新された場合（例：better-auth 1.x → 2.x）
  • スキルの最終検証から 90 日以上経過している場合
  • スキルをマーケットプレイスに提出する前
  • ユーザーから、スキルの手順に従った際にエラーが発生したと報告された場合
  • 例が古い、または矛盾しているように見える場合

本番環境での実績：better-auth スキルの監査に成功しました（2025-11-08）。存在しない API のインポートを含む、重大または高優先度の問題を 6 件発見し、誤ったコードを 665 行削除して、正しいパターンを用いた v2.0.0 を実装しました。

クイックスタート

スラッシュコマンドから呼び出す
/review-skill <skill-name>

例：

/review-skill better-auth
スキルから呼び出す（プロアクティブ）

Claude が潜在的な問題に気付いた場合、次のように提案できます：

User: "I'm having trouble with better-auth and D1"

Claude: "I notice the better-auth skill was last verified 6 months ago.
Would you like me to review it? Better-auth recently released v1.3
with D1 changes."

このスキルでできること

9 フェーズの体系的な監査

  1. レビュー前の準備（5～10 分）

    • スキルをローカルにインストールします：./scripts/install-skill.sh <skill-name>
    • 現在のバージョンと最終検証日を確認します
    • スキルが検出されることをテストします

  2. 標準への準拠（10～15 分）

    • YAML のフロントマター（name、description、license）を検証します
    • キーワードが十分に網羅されているか確認します
    • 説明が三人称で書かれていることを確認します
    • ディレクトリ構造が仕様に準拠していることを確認します

  3. 公式ドキュメントの検証（15～30 分）

    • Context7 MCP または WebFetch を使用して API パターンを検証します
    • GitHub で最近の更新や問題を確認します
    • パッケージのバージョンを npm レジストリと照合します
    • 本番環境のリポジトリと比較します

  4. コード例とテンプレートの監査（20～40 分）

    • 現在のパッケージにインポート文が存在することを確認します
    • API メソッドのシグネチャが公式ドキュメントと一致することを確認します
    • ファイル間でスキーマに一貫性があることを確認します
    • テンプレートをビルドして実行します

  5. ファイル間の一貫性（15～25 分）

    • SKILL.md と README.md の例を比較します
    • 「Bundled Resources」セクションが実際のファイルと一致することを確認します
    • 設定例に一貫性があることを確認します

  6. 依存関係とバージョン（10～15 分）

    • ./scripts/check-versions.sh <skill-name> を実行します
    • パッケージ更新に伴う破壊的変更がないか確認します
    • 「Last Verified」の日付が新しいことを確認します

  7. 問題の分類（10～20 分）

    • 重要度で分類します：🔴 重大 / 🟡 高 / 🟠 中 / 🟢 低
    • 根拠（GitHub URL、ドキュメントへのリンク、npm の変更履歴）を添えて記録します

  8. 修正の実装（30 分～4 時間）

    • 明確な問題は自動修正します
    • アーキテクチャ上の判断についてのみユーザーに尋ねます
    • 影響を受けるすべてのファイルを一貫して更新します
    • 破壊的変更がある場合はバージョンを上げます

  9. 修正後の検証（10～15 分）

    • スキルが検出されることをテストします
    • テンプレートが動作することを確認します
    • 矛盾が残っていないことを確認します
    • 詳細な変更履歴を添えてコミットします
自動チェック（スクリプトによる）

このスキルは ./scripts/review-skill.sh <skill-name> を実行し、次の項目を確認します：

  • ✅ YAML フロントマターの構文と必須フィールド
  • ✅ パッケージバージョンの最新性（npm）
  • ✅ リンク切れ（HTTP ステータス）
  • ✅ コード内の TODO マーカー
  • ✅ ファイルの整理状況（想定されるディレクトリの有無）
  • ✅ 「Last Verified」日付の古さ
手動検証（AI による）

Claude が次の項目を確認します：

  • 🔍 公式ドキュメントに基づく API メソッドの検証
  • 🔍 GitHub の活動状況と問題の確認
  • 🔍 本番環境のリポジトリとの比較
  • 🔍 コード例の正確性
  • 🔍 スキーマの一貫性の検証

プロセスのワークフロー

ステップ 1：自動チェックを実行する
./scripts/review-skill.sh <skill-name>

出力を確認し、技術的な問題を特定します。

ステップ 2：手動検証を実行する

フェーズ 3：公式ドキュメントの検証では、次の手順を実行します。

  1. Context7 MCP を使用します（利用可能な場合）。

    Use Context7 to fetch: /websites/<package-docs>
Search for: [API method from skill]

  2. または、WebFetch を使用します。

    Fetch: https://<official-docs-url>
Verify: [specific patterns]

  3. GitHub を確認します。

    Visit: https://github.com/<org>/<repo>/commits/main
Check: Last commit, recent changes
Search issues: [keywords from skill]

  4. 本番環境での使用例を探します。

    WebSearch: "<package> cloudflare production github"
Compare: Do real projects match our patterns?

フェーズ 4：コード例の監査では、次の点を確認します。

  • すべてのインポートが存在すること（公式ドキュメントを確認）
  • API メソッドのシグネチャが一致していること
  • ファイル間でスキーマの整合性が保たれていること
  • テンプレートが実際に動作すること
ステップ 3：問題を分類する

🔴 CRITICAL - 機能を損なう問題：

  • 存在しない API メソッド／インポート
  • 無効な設定
  • 必須の依存関係の不足

🟡 HIGH - 混乱を招く問題：

  • ファイル間で例の内容が矛盾している
  • パターンに一貫性がない
  • メジャーバージョンが古い

🟠 MEDIUM - 品質を低下させる問題：

  • マイナーバージョンが古い（90 日超）
  • ドキュメントのセクションが不足している
  • エラー一覧が不完全

🟢 LOW - 仕上げに関する問題：

  • 誤字や書式の不整合
  • 任意のメタデータの不足
ステップ 4：問題を修正する

次の場合は自動修正します。

  • ✅ 修正方法が明確（ドキュメントに記載された正しいインポート）
  • ✅ 根拠が明確
  • ✅ アーキテクチャへの影響がない

次の場合はユーザーに確認します。

  • ❓ 複数の妥当な方法がある
  • ❓ 破壊的変更に関する判断が必要
  • ❓ アーキテクチャ上の選択が必要

質問の形式：

I found [issue]. There are [N] approaches:

1. [Approach A] - [Pros/Cons]
2. [Approach B] - [Pros/Cons]

Recommendation: [Default based on evidence]

Which would you prefer?
ステップ 5：バージョン更新を評価する

破壊的変更がある場合：

  • メジャー：v1.0.0 → v2.0.0（API パターンの変更）
  • マイナー：v1.0.0 → v1.1.0（新機能、後方互換性あり）
  • パッチ：v1.0.0 → v1.0.1（バグ修正のみ）
ステップ 6：監査レポートを生成する
## Skill Review Report: <skill-name>

**Date**: YYYY-MM-DD
**Trigger**: [Why review performed]
**Time Spent**: [Duration]

### Findings

🔴 CRITICAL (N): [List with evidence]
🟡 HIGH (N): [List with evidence]
🟠 MEDIUM (N): [List with evidence]
🟢 LOW (N): [List with evidence]

### Remediation

**Files Modified**: [List]
**Version Update**: [old] → [new]
**Breaking Changes**: Yes/No

### Verification

✅ Discovery test passed
✅ Templates work
✅ Committed: [hash]

### Recommendation

[Final assessment]

例：better-auth の監査

調査結果

問題 #1：存在しない d1Adapter 🔴 CRITICAL

場所：references/cloudflare-worker-example.ts:17

問題：存在しない 'better-auth/adapters/d1' から d1Adapter をインポートしています。

根拠：

修正：'better-auth/adapters/drizzle' から drizzleAdapter をインポートするように変更します。

結果
  • 削除したファイル：3（古いパターン）
  • 作成したファイル：3（正しいパターン）
  • 変更した行数：差し引き +1,266
  • バージョン：v1.0.0 → v2.0.0
  • 所要時間：3.5 時間

同梱リソース

このスキルでは、次のリソースを参照します。

  1. planning/SKILL_REVIEW_PROCESS.md - 手動で実施する 9 フェーズの完全ガイド
  2. scripts/review-skill.sh - 自動検証スクリプト
  3. .claude/commands/review-skill.md - スラッシュコマンドの定義

Claude がこのスキルを呼び出すタイミング

先回りして呼び出す場合：

  • ユーザーがスキルの古さを指摘した
  • パッケージのメジャーバージョンが話題に出た
  • ユーザーがスキルに従ってエラーが発生したと報告した
  • メタデータを確認したところ、検証から 90 日以上経過していた

明示的に呼び出す場合：

  • 「X スキルをレビューして」
  • 「better-auth スキルを監査して」
  • 「cloudflare-worker-base は最新ですか？」
  • 「tailwind-v4-shadcn の更新が必要か確認して」

トークン効率

このスキルを使わない場合：約 25,000 トークン

  • 試行錯誤による検証
  • ドキュメントの検索を繰り返す
  • ファイル間で修正に一貫性がない
  • 根拠の引用が不足する

このスキルを使う場合：約 5,000 トークン

  • 体系的なプロセス
  • 明確な判断フロー
  • 根拠に基づく修正
  • 包括的な監査履歴

削減率：約 80％（20,000 トークン）

防止できる一般的な問題

  1. 偽の API アダプター - 存在しないインポート
  2. 古い API メソッド - 変更されたシグネチャ
  3. スキーマの不整合 - テーブル名が異なる
  4. 古いスクリプト - 非推奨のアプローチ
  5. バージョンのずれ - 90 日以上古いパッケージ
  6. 矛盾する例 - 複数のパターンが互いに矛盾している
  7. リンク切れ - 404 になるドキュメント URL
  8. YAML エラー - 無効なフロントマター構文
  9. キーワードの不足 - 見つけにくい
  10. 同梱リソースの不足 - 一覧にあるファイルが存在しない

ベストプラクティス

  1. 必ず出典を明記します - GitHub の URL、ドキュメントへのリンク、npm の変更履歴
  2. 推測しません - 最新の公式ドキュメントで確認します
  3. 体系的に進めます - 9 つのフェーズすべてに従います
  4. 一貫性を保ちます - 1 つだけでなく、すべてのファイルを更新します
  5. 詳細に記録します - 詳細なコミットメッセージを記述します
  6. 修正後にテストします - スキルが引き続き動作することを確認します

既知の制限事項

  • リンクのチェックにはネットワークアクセスが必要です
  • パッケージのバージョン確認には npm のインストールが必要です
  • Context7 MCP の利用可否はパッケージによって異なります
  • 本番環境のリポジトリ検索には GitHub API が必要な場合があります
  • 手動で行うフェーズでは人による判断が必要です

バージョン履歴

v1.0.0 (2025-11-08)

  • 初回リリース
  • 9 フェーズの体系的な監査プロセス
  • 自動化スクリプトと手動ガイド
  • スラッシュコマンドとスキルラッパー
  • better-auth v2.0.0 の監査で本番環境にてテスト済み

追加リソース

  • プロセスガイド全文: planning/SKILL_REVIEW_PROCESS.md
  • リポジトリ: https://github.com/jezweb/claude-skills
  • 監査の例: プロセスガイドの付録 B（better-auth v2.0.0）を参照してください

最終確認日: 2025-11-08 | バージョン: 1.0.0

コメント

Markdown 対応