메뉴
Claude Code スキルのベストプラクティス適合レビューガイド。フロントマター検証（name/description ルール）、SKILL.md 本文品質（行数・構造・Progressive Disclosure）、references/ 構造、description トリガー品質、アンチパターン検出をカバー。スキルの新規作成後のレビュー、既存スキルの品質改善、スキル全体の一括監査時に使用。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Generate draw.io diagrams as .drawio files, optionally export to PNG/SVG/PDF with embedded XML
Figma MCP を使ってデザインを FE コードに変換するスキル。 Trigger when: Figma URL が共有された時、デザインからコンポーネント実装時、 UI 実装でデザイン参照が必要な時、"Figma", "デザイン", "UI実装" への言及時、 「このデザインを実装して」「Figma から」「デザイン通りに」と言われた時。 Always use with: /web-design-principles
プロジェクト全体の統括エージェント向けスキル。要件整理から技術選定・アーキテクチャ設計・タスク分解・委譲までをカバー。git worktreeを活用した並列開発オーケストレーション（featureブランチ管理、BE/FE統括への委譲、横断レビュー）も担う。プロジェクト全体を俯瞰し、適切なエージェント/スキルに委譲する。新規プロジェクト立ち上げ、技術選定、全体設計、タスク分解・委譲、並列開発時に使用。
Webデザイン実装の鉄則ガイド。CSS/レイアウト設計の原則を提供。 Trigger when: UI/UX実装時、CSS設計時、レイアウト実装時、レスポンシブ対応時、 アクセシビリティ確認時、"レイアウト", "CSS", "スタイル" への言及時。 /figma-to-code スキルと併用する場合に自動で参照される。
Codex CLIワーカーエージェントを起動してタスクを実行する。 Claude CodeがオーケストレーターとしてCodexを呼び出すハイブリッド構成。 トリガー: 「Codexで実行」「Codexに任せて」「並列でCodex」「高速に処理」
CSS の包括的なベストプラクティスガイド（フレームワーク非依存）。パフォーマンス最適化、保守性、シンプルなコード、親子要素の相対値設計、モダン CSS 機能（Container Queries、:has()、ネイティブネスティング、Cascade Layers）をカバー。CSS 設計・実装・レビュー時に使用。Tailwind CSS 等のユーティリティフレームワーク使用時は tailwind-css スキルを参照。
| name | skill-reviewer |
| description | Claude Code スキルのベストプラクティス適合レビューガイド。フロントマター検証（name/description ルール）、SKILL.md 本文品質（行数・構造・Progressive Disclosure）、references/ 構造、description トリガー品質、アンチパターン検出をカバー。スキルの新規作成後のレビュー、既存スキルの品質改善、スキル全体の一括監査時に使用。 |
Claude Code スキルをベストプラクティスに照らしてレビューするためのガイド。公式バリデーションルール + SKILL.md ガイドラインに基づく。
1. 対象スキルの特定
- パス指定: ~/.agents/skills/<skill-name>/
- 一括: ~/.agents/skills/ 配下全スキル
2. ディレクトリ構造の確認
- SKILL.md の存在確認
- scripts/, references/, assets/ の内容確認
- 不要ファイル（README.md, CHANGELOG.md 等）の検出
3. フロントマター検証
- YAML パース可否
- name / description の必須チェック
- name 形式: ^[a-z0-9-]+$, 64文字以内, 先頭/末尾/連続ハイフン禁止
- description: 1024文字以内, 山括弧(<>)禁止
- 許可フィールド: name, description, license, allowed-tools, metadata
4. SKILL.md 本文レビュー
- 行数チェック（500行以内）
- Progressive Disclosure パターン確認
- references/ へのリンク確認
- 構造・可読性の評価
5. references/ レビュー
- ネスト構造の検出（1階層のみ許可）
- 100行超ファイルの TOC 有無
- SKILL.md との重複チェック
6. レビュー結果の出力
- 重要度別（Critical / Warning / Suggestion）に整理
- 良い点も記載
7. 改善提案の提示
- 具体的な修正案を提示
SKILL.md が存在する？
├→ No → Critical: SKILL.md 不在
└→ Yes → フロントマターが有効？
├→ No → Critical: フロントマター不正
└→ Yes → name/description ルール準拠？
├→ No → Critical: name/description ルール違反
└→ Yes → 本文 500行以内？
├→ No → Warning: 行数超過
└→ Yes → 構造・references 品質確認
├→ 問題あり → Warning/Suggestion
└→ 問題なし → Pass
3段階の重要度で判定する。
| 重要度 | 意味 | 例 |
|---|---|---|
| Critical | スキルが正常に動作しない | SKILL.md 不在、フロントマター不正、name/description ルール違反 |
| Warning | ベストプラクティス違反 | 500行超、body 内の When to Use、TODO 残存、references/ ネスト、不要ファイル |
| Suggestion | 品質向上の推奨事項 | 300行超、TOC なし、SKILL.md と references/ の重複、description 短すぎ |
詳細な判定基準: references/review-checklist.md
# スキルレビュー: <skill-name>
## 概要
| 項目 | 結果 |
|------|------|
| スキル名 | <skill-name> |
| 総合判定 | Pass / Warning / Critical |
| Critical | N 件 |
| Warning | N 件 |
| Suggestion | N 件 |
## Critical
- [C-01] <指摘内容>
- 現状: ...
- 修正案: ...
## Warning
- [W-01] <指摘内容>
- 現状: ...
- 推奨: ...
## Suggestion
- [S-01] <指摘内容>
- 推奨: ...
## 良い点
- <良い点>
~/.agents/skills/ 配下の全スキルを対象にレビューする場合:
1. ls ~/.agents/skills/ でスキル一覧を取得
2. 各スキルに対してレビューワークフローを実行
3. サマリーテーブルを出力:
| スキル名 | 判定 | Critical | Warning | Suggestion |
|---------|------|----------|---------|------------|
| skill-a | Pass | 0 | 1 | 2 |
| skill-b | Critical | 1 | 0 | 0 |
name が ^[a-z0-9-]+$ に合致、64文字以内description が 1024文字以内、山括弧なし