skill-development

スキル開発

Claude Code スキルの作成、監査、保守のためのツールです。スキルを作成する方や、このリポジトリをフォークする方に欠かせません。

---

スラッシュコマンド

/create-skill <name>

テンプレートから新しいスキルのひな形を作成します。

機能：

1. スキル名を検証します（小文字とハイフンを使用、最大40文字）
2. スキルの種類について質問します（Cloudflare/AI/Frontend/Auth/Database/Tooling/Generic）
3. templates/skill-skeleton/ を skills/<name>/ にコピーします
4. SKILL.md に名前と日付を自動入力します
5. 自動トリガーキーワードを含む README.md を作成します
6. メタデータをチェックします
7. テスト用にスキルをインストールします

使用方法：/create-skill my-new-skill

---

/review-skill <name>

既存のスキルの品質レビューと監査を行います。

機能：

1. SKILL.md の構造とメタデータをチェックします
2. パッケージのバージョンを最新のものと照合して検証します
3. エラーに関するドキュメントをレビューします
4. テンプレートの完全性をチェックします
5. 改善案を提案します

使用方法：/review-skill cloudflare-worker-base

---

/audit [name]

複数のエージェントが並行してスキルを検証する監査スウォームです。

機能：

1. 複数のスキルを監査するエージェントを並行して起動します
2. バージョン、メタデータ、コンテンツの品質をチェックします
3. 統合レポートを生成します

使用方法：

• /audit - すべてのスキルを監査します
• /audit cloudflare-* - 一致するスキルを監査します

---

/audit-skill-deep <name>

公式ドキュメントに照らしてコンテンツを詳細に検証します。

機能：

1. スキルの技術に関する公式ドキュメントを取得します
2. パターンとバージョンを比較します
3. 知識の不足や古くなった内容を特定します
4. 修正や更新を提案します

使用方法：/audit-skill-deep tailwind-v4-shadcn

---

/deep-audit <name>

ドキュメントを包括的にスクレイピングして、詳細な監査を行います。

機能：

1. 複数のドキュメントソースをスクレイピングします
2. スクレイピングしたコンテンツを archive/audit-cache/ にキャッシュします
3. スキルのコンテンツと相互参照します
4. 詳細な正確性レポートを作成します

使用方法：/deep-audit openai-api

---

/scrape-api <docs-url> [skill-name]

API ドキュメントの URL からスキルを生成します。

機能：

1. ドキュメントの URL にアクセスでき、API ドキュメントが含まれていることを検証します
2. 静的なドキュメントでは、まず WebFetch を試します
3. JavaScript を多用するサイト（readme.io、GitBook）では、Playwright に切り替えます
4. エンドポイント、認証、リクエスト／レスポンスのスキーマを抽出します
5. SKILL.md、references/、templates/ を含むスキルの構造全体を生成します
6. プラグインマニフェストの生成を実行します

使用方法：

• /scrape-api https://api.example.com/docs my-api
• /scrape-api https://rocketdotnet.readme.io/（名前を rocket-net-api と自動検出します）

対応プラットフォーム：

• readme.io のドキュメントサイト
• Swagger/OpenAPI 仕様
• GitBook ドキュメント
• 標準的な HTML API ドキュメント

---

テンプレート

このスキルには、新しいスキルを作成するためのテンプレートが含まれています。

テンプレート	用途
templates/skill-skeleton/	コピーして使用するスキルディレクトリ一式
templates/SKILL-TEMPLATE.md	記入する TODO を含む SKILL.md
templates/README-TEMPLATE.md	キーワードセクションを含む README.md
templates/skill-metadata-v2.yaml	YAML フロントマターのリファレンス
templates/RESEARCH_FINDINGS_TEMPLATE.md	調査結果の出力形式
templates/CONTENT_AUDIT_TEMPLATE.md	監査チェックリスト

テンプレートの使用

# Option 1: Use /create-skill (recommended)
/create-skill my-new-skill

# Option 2: Manual copy
cp -r skills/skill-development/templates/skill-skeleton/ skills/my-new-skill/
# Then fill in the TODOs

---

品質基準

公開前に、スキルが以下の基準を満たしていることを確認してください。

必須

• name と description を含む YAML フロントマター
• 説明に「Use when」のシナリオを含める
• 三人称による説明文のスタイル
• パッケージのバージョンが最新である
• テンプレートがテスト済みで、正しく動作する

推奨

• 自動トリガーキーワードを含む README.md
• トークン効率を測定する（目標：50% 以上の削減）
• 既知の問題を出典とともに記録する
• 例にエラーの防止方法を含める

完全版チェックリスト：リポジトリのルートにある ONE_PAGE_CHECKLIST.md を参照してください。

---

エージェント

このスキルは、スキルを自動でメンテナンスするエージェントを提供します。

エージェント	目的
skill-creator	適切な構成で新しいスキルのひな形を作成します
api-doc-scraper	API ドキュメントの URL からスキルを生成します
version-checker	パッケージのバージョンが最新か確認します
content-accuracy-auditor	スキルの内容を公式ドキュメントと比較します
code-example-validator	コード例の構文が正しいか検証します
api-method-checker	ドキュメントに記載された API メソッドが存在するか確認します
doc-validator	ドキュメントの品質を確認します
bulk-updater	複数のスキルに変更を適用します

これらのエージェントは .claude/agents/（リポジトリレベル）と agents/（スキルにバンドル）にあり、コマンドから使用されます。

---

ワークフロー

新しいスキルの作成

1. /create-skill my-skill
2. Fill in TODOs in SKILL.md
3. Add templates, references, scripts as needed
4. /review-skill my-skill
5. Fix any issues
6. Test: /plugin install ./skills/my-skill
7. Commit and push

スキルの監査

1. /audit                          # Quick check all skills
2. /audit-skill-deep my-skill      # Deep check specific skill
3. Review findings
4. Fix issues or document as known limitations
5. Update metadata.last_verified date

四半期ごとのメンテナンス

1. Run: ./scripts/check-all-versions.sh
2. Review VERSIONS_REPORT.md
3. /audit for all skills needing updates
4. Update package versions
5. Test affected skills
6. Commit: "chore: quarterly version updates"

---

フォークした方へ

このリポジトリをフォークして独自のスキルをメンテナンスする場合：

1. このスキルをインストールする：/plugin install ./skills/skill-development
2. /create-skill を使う：適切な構成でスキルを作成します
3. /review-skill を使う：公開前に検証します
4. エージェントをカスタマイズする：必要に応じて .claude/agents/ を変更します
5. 上流の更新を取り込む：git fetch upstream && git merge upstream/main

このツール群は単独で動作するよう設計されています。これらのコマンドを使うために、リポジトリ全体は必要ありません。