From totto2727
スキル(SKILL.md)の品質レビュー・改善提案を行う。 フロントマター検証、description品質、本文構成、テスト戦略、anti-pattern検出を網羅。 「スキルレビュー」「SKILL.mdチェック」「スキル品質確認」「スキル改善」で起動。 Do NOT use for: スキルの新規作成(skill-creatorを使え)、スキルの実行・呼び出し。
npx claudepluginhub totto2727-org/monorepo --plugin totto2727This skill uses the workspace's default tool permissions.
ユースケースカテゴリ: **Workflow Automation**
Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.
Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).
Generates original PNG/PDF visual art via design philosophy manifestos for posters, graphics, and static designs on user request.
ユースケースカテゴリ: Workflow Automation 設計パターン: Sequential Workflow(Step 1→2→3→4の順序実行)
スキル(SKILL.md)の品質を体系的にレビューし、改善提案を行う。 Anthropic公式 "The Complete Guide to Building Skills for Claude" (2026-03) に準拠。
以下の評価カテゴリ(G1-G7)を順に実施する。
ユーザーに対象Platformを確認する。 推測で判断しない。
回答に基づき、該当するPlatform固有評価を references/ から読み込んで実施する。
Platformセクションの表を参照し、該当ファイルを読み込むこと。
複数Platformに対応する場合、それぞれの評価を実施する。
全カテゴリのスコアと改善提案を表形式で一覧化する。
YAML frontmatterが仕様に準拠しているか検証する。
必須チェック:
name が存在し、kebab-caseであることname が最大64文字であることname に "claude" / "anthropic" を含まないこと(予約語)description が存在し、空でないことdescription が1024文字以内であること--- デリミタで正しく囲まれていること< > がフロントマター内に含まれないこと推奨チェック:
name がフォルダ名と一致することSKILL.md は大文字小文字厳密(skill.md ❌ / SKILL.MD ❌)my-skill ✅ / My_Skill ❌)license フィールド(OSSの場合)metadata に author / version が含まれることcompatibility に環境要件が記載されていること(依存がある場合)スコア基準:
descriptionはスキル発火判断の唯一の材料。品質が直結する。
7項目チェックリスト:
| # | チェック | 評価ポイント |
|---|---|---|
| 1 | What: 何をするか明記されているか | 曖昧な動詞("管理する")ではなく具体的アクション動詞("抽出・変換・検証する") |
| 2 | When: いつ使うか明記されているか | ユースケースやコンテキストの記述 |
| 3 | トリガーワードが含まれているか | ユーザーが実際に言いそうなフレーズ |
| 4 | 具体的なアクション動詞か | "処理する" → "解析してCSVに変換する" |
| 5 | 長さが適切か(1024文字以内、かつ短すぎない) | 2-3文で概要+トリガー+除外が理想 |
| 6 | 既存スキルとの差別化ができているか | 他スキルとの守備範囲の重複がないか |
| 7 | ネガティブトリガーがあるか | "Do NOT use for: ..." で誤発火を防止 |
追加チェック:
スコア基準:
デバッグ支援: 発火に問題がある場合、以下の問いかけでdescriptionを診断できる:
「When would you use the [skill-name] skill?」
SKILL.md本文が効果的に構成されているか評価する。
チェック項目:
Whyの説明: MUSTやNEVERの多用ではなく、なぜそうすべきかの理由説明があるか。 理由を理解したモデルは、エッジケースでもより適切に判断できる。
スコア基準:
3層構造が適切に活用されているか。
| 層 | 内容 | 理想的な状態 |
|---|---|---|
| L1 | YAML frontmatter | 発火判断に十分な情報(~100語) |
| L2 | SKILL.md本文 | コア指示のみ(500行以内が理想) |
| L3 | references/, scripts/ | 詳細情報、大きなリファレンス |
チェック項目:
スコア基準:
スキルの目的と設計パターンが明確か。
ユースケースカテゴリ(3種のいずれか):
設計パターン(5種のいずれか):
チェック項目:
MCP Enhancement固有チェック(カテゴリ3に該当する場合):
Composabilityチェック:
スコア基準:
テストの観点が設計に含まれているか。
3領域:
チェック項目:
スコア基準:
以下の既知のanti-patternに該当していないか検出する。
| NG パターン | 理由 |
|---|---|
| SKILL.md 5,000語超 | 読み込みコスト増大、応答品質低下 |
| description が曖昧 | 発火しない or 誤発火 |
| description 1024文字超 | フロントマター制限超過 |
description に < > | セキュリティ違反 |
| ネガティブトリガーなし | 類似スキル間で誤発火リスク |
| README.md がスキルフォルダ内に存在 | 仕様違反 |
| 指示が曖昧("適切に処理する"等) | モデルが正しく従えない |
| MUSTやNEVERの過剰使用 | Whyの説明で代替すべき |
| バリデーションを言語指示のみに依存 | スクリプト化すべき |
| 参照ファイルの内容をSKILL.mdに直接コピー | progressive disclosure違反 |
| 同時有効スキル50個超 | コンテキスト圧迫、応答品質低下 |
| マルウェア・エクスプロイトコードを含む | Principle of Lack of Surprise違反。スキルはユーザーの期待に反する動作をしてはならない |
| 不正アクセスやデータ抜き取りを促進する指示 | セキュリティ・安全性違反 |
| ユーザーの意図と異なる動作をする指示 | 信頼性の毀損。スキルの動作はdescriptionから予測可能であるべき |
スコア基準:
対象スキルが使用されるPlatformに応じて、該当するリファレンスファイルを読み込み追加評価を実施する。
| Platform | リファレンスファイル | 評価カテゴリ |
|---|---|---|
| Claude Code | references/claude-code.md | CC1-CC4(専用フロントマター、実行パターン、動的機能、allowed-tools設計) |
必ずユーザーに対象Platformを確認すること。 推測で判断しない。 複数Platformに対応するスキルの場合、該当するすべてのリファレンスを読み込み評価する。
レビュー結果は templates/review-summary.md のテンプレートに従って出力する。
テンプレートを読み込み、? をスコアに、... を要約に置き換えること。
レビュー中に発見した問題に対して、以下のガイドも提供する。