review-skill

スキルレビューチェックリスト

ライブラリに追加する前に、新しいスキルをレビューします。

ファイル構成の確認

必須	ファイル	目的
✅	skill.md	メインのスキルファイル（小文字！）
⚠️	SETUP.md	セットアップガイド（スキルに API／設定が必要な場合）
⚠️	scripts/	補助スクリプト（必要な場合）
⚠️	.env.example	環境変数ファイルの例（実際の認証情報は絶対に記載しないでください！）

skill.md の要件

Frontmatter（YAML ヘッダー）

---
name: skill-name           # Required: kebab-case
description: "..."         # Required: trigger phrases
setup: "./SETUP.md"        # If SETUP.md exists
enhancedBy:                # Optional: complementary skills
  - other-skill: "Benefit description. Without it: fallback behavior"
usedBy:                    # Optional: for helper skills
  - parent-skill
---

コンテンツのガイドライン

• 簡潔に - 100 行未満が理想、最大 150 行
• ワークフローに重点を置く - セットアップ方法ではなく、使い方を記載
• 例 - 簡単なコマンド例
• セットアップ手順は記載しない - これらは SETUP.md に記載します

SETUP.md の要件（必要な場合）

• 手順ごとのセットアップガイド
• API／アカウントの作成手順
• 認証情報の設定（.env）
• セットアップを確認するテストコマンド
• トラブルシューティングの表

ドキュメントサイトとの同期

スキルを追加した後、docs/index.html を更新します。

1. skills-grid セクションにスキルカードを追加
2. スキルに enhancedBy がある場合は、組み合わせバッジを追加します。

<div class="skill-combo" style="...">
  <span style="color: var(--green-primary);">🔗 עובד טוב יותר עם:</span>
  <span style="color: var(--text-secondary);">skill-a, skill-b</span>
</div>

3. docs/skills/[skill-name].html のガイドページを作成
4. ダウンロード用に docs/downloads/[skill-name].zip を作成

レビューチェックリスト

新しいスキルを承認する前に、以下を確認します。

• skill.md が存在する（小文字）
• Frontmatter に name と description がある
• SETUP.md が存在する場合は setup: "./SETUP.md" がある
• コンテンツが 150 行未満である
• どのファイルにも認証情報や API キーが含まれていない
• .gitignore に .env と機密ファイルが含まれている
• スクリプトがある場合、--dry-run オプションがある
• ドキュメントサイトがスキルカードで更新されている
• ダウンロード用 ZIP が作成されている

品質基準

良い説明（トリガーフレーズ）

# Good - tells Claude when to use
description: "Send WhatsApp messages. Use when user says 'send message', 'whatsapp', 'הודעה'."

# Bad - too vague
description: "WhatsApp integration"

enhancedBy の適切な形式

# Good - explains benefit and fallback
enhancedBy:
  - get-contact: "Auto-lookup contact by name. Without it: ask user for phone directly"

# Bad - no context
enhancedBy:
  - get-contact

コマンド

スキルのフォルダーに対してレビューを実行します。

# Check structure
ls -la skills/[skill-name]/

# Check frontmatter
head -20 skills/[skill-name]/skill.md

# Check line count
wc -l skills/[skill-name]/skill.md