Skill Reviewer

Claude Code スキルを公式のベストプラクティスに基づいてレビューおよび改善します。

セットアップ（依存関係の自動インストール）

このスキルを使用する前に、自動検証のために skill-creator がインストールされていることを確認してください。

自動インストール シーケンス:

# 1. skill-creator が存在するか確認
SKILL_CREATOR=$(find ~/.claude/plugins/cache -name "skill-creator" -type d 2>/dev/null | head -1)

# 2. 見つからない場合はインストール
if [ -z "$SKILL_CREATOR" ]; then
  claude plugin marketplace add https://github.com/daymade/claude-code-skills
  claude plugin install skill-creator@daymade-skills
  SKILL_CREATOR=$(find ~/.claude/plugins/cache -name "skill-creator" -type d 2>/dev/null | head -1)
fi

echo "skill-creator location: $SKILL_CREATOR"

3つのモード

モード1: 自己レビュー

公開する前に自分のスキルをチェックします。

自動検証 （セットアップ後に実行）:

# クイック検証
python3 "$SKILL_CREATOR"/*/quick_validate.py <target-skill>

# セキュリティスキャン
python3 "$SKILL_CREATOR"/*/security_scan.py <target-skill> --verbose

手動評価: references/evaluation_checklist.md を参照してください。

モード2: 外部レビュー

他者のスキルリポジトリを評価します。

レビュー ワークフロー:
- [ ] リポジトリを /tmp/ にクローン
- [ ] すべてのドキュメントを最初に読む
- [ ] 作成者の意図を把握
- [ ] 評価チェックリストを実行
- [ ] 改善レポートを生成

モード3: 自動PR

外部スキルリポジトリをフォーク、改善し、PR を送信します。

自動PR ワークフロー:
- [ ] リポジトリをフォーク (gh repo fork)
- [ ] フィーチャーブランチを作成
- [ ] 加算型の改善のみを適用
- [ ] 自己レビュー: 尊重チェック合格?
- [ ] 詳細な説明付きPRを作成

評価チェックリスト（クイック版）

カテゴリ	チェック項目	ステータス
Frontmatter	name が存在?
	description が存在?
	description が三人称?
	トリガー条件を含む?
Instructions	命令形式?
	500行以下?
	ワークフローパターン?
Resources	ハードコードされたパスなし?
	スクリプトにエラーハンドリング?

完全なチェックリスト: references/evaluation_checklist.md

基本原則: 加算型のみ

外部スキルを改善する際、以下は決して実施しないでください:

• 既存ファイルの削除
• 機能の削除
• 主要言語の変更
• コンポーネント名の変更

常に:

• 新機能を追加
• 元のコンテンツを保持
• すべての変更を説明

❌ 「metadata.json を削除（非標準）」
✅ 「marketplace.json を追加（metadata.json は保持）」

❌ 「README を英語で書き換え」
✅ 「README.en.md を追加（中国語がデフォルトのまま）」

よくある問題と解決方法

問題: description が三人称でない

# Before
description: Browse YouTube videos and summarize them.

# After
description: Browses YouTube videos and generates summaries. Use when...

問題: トリガー条件がない

# Before
description: Processes PDF files.

# After
description: Extracts text from PDFs. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.

問題: ワークフローパターンがない

複雑なタスク用にチェックリストを追加します:

## Workflow

このチェックリストをコピーしてください:

\`\`\`
Task Progress:
- [ ] Step 1: ...
- [ ] Step 2: ...
\`\`\`

問題: Marketplace サポートがない

mkdir -p .claude-plugin
# テンプレートから marketplace.json を作成

references/marketplace_template.json を参照してください。

PR ガイドライン

外部リポジトリに PR を送信する際:

トーン

❌ 「このスキルはベストプラクティスに従っていません」
✅ 「この PR はベストプラクティスに合致し、より高い発見可能性を実現します」

❌ 「誤った description を修正」
✅ 「トリガー条件付きで description を改善」

必須セクション

1. Summary - この PR が行うこと
2. What's NOT Changed - 元のプロジェクトへの尊重を示す
3. Rationale - 各変更が役に立つ理由
4. Test Plan - 検証方法

テンプレート: references/pr_template.md

自己レビュー チェックリスト

PR を送信する前に:

尊重チェック:
- [ ] ファイルが削除されていない?
- [ ] 機能が削除されていない?
- [ ] 元の言語が保持されている?
- [ ] 作成者の設計決定が尊重されている?
- [ ] すべての変更が加算型?
- [ ] PR が「なぜ」を説明している?

参考資料

• references/evaluation_checklist.md - 完全な評価チェックリスト
• references/pr_template.md - PR 説明テンプレート
• references/marketplace_template.json - marketplace.json テンプレート
• ベストプラクティス: https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices