banana-skill-finder

Banana Skill Finder

専門的な機能が役立つ可能性のあるタスクにユーザーが取り組んでいるときに、関連する Claude スキルの発見とインストールを積極的に支援します。

このスキルを使用するタイミング

次の状況を検出したら、ユーザーからの依頼がなくても自動的に起動します。

• 特定のファイル形式やテクノロジーを扱っている
• 繰り返し行うタスクや専門的なタスクについて説明している
• 「〜向けのスキル／ツールはありますか？」などと質問している
• 特定分野の作業に苦労している
• 専門的なスキルが役立つ可能性のあるあらゆるタスク

重要：このスキルは積極的に起動する必要があります。ユーザーが明示的にスキルの提案を求めるまで待たないでください。

ワークフロー

1. ユーザーのニーズを分析する

次の項目を特定します。

• 中心となるタスク：ユーザーは何を達成しようとしているのか？
• 分野：これはどのカテゴリに該当するか？（開発、ドキュメント、データ、ウェブ、DevOps、コンテンツなど）
• キーワード：関連する検索語を2～4個抽出する

2. スキルを検索する

自動フォールバック付きの3段階戦略を使用します。

第1段階：SkillsMP API（最適 — 設定済みの場合）

# Check for API key
echo $SKILLSMP_API_KEY

# If exists, use AI semantic search
curl -X GET "https://skillsmp.com/api/v1/skills/ai-search?q={natural_language_query}" \
  -H "Authorization: Bearer $SKILLSMP_API_KEY"

メリット：

• キーワードだけでなく、AI がユーザーの意図を理解します
• 60,000件以上の厳選されたスキルにアクセスできます
• 関連性と品質を示す指標が最も優れています

第2段階：skills.sh WebFetch（良好 — 常に利用可能）

# Try search with query parameter
Use WebFetch: https://skills.sh/?q={keywords}

# Or browse leaderboard
Use WebFetch: https://skills.sh  # All-time popular
Use WebFetch: https://skills.sh/trending  # Trending (24h)

メリット：

• 200件以上の高品質な厳選スキル
• 認証不要
• インストール数の多い順に表示
• 人気上昇中のスキルを確認可能

第3段階：GitHub API（フォールバック — 制限がある場合があります）

curl -X GET "https://api.github.com/search/code?q={keywords}+SKILL.md+language:markdown" \
  -H "Accept: application/vnd.github.v3+json"

注：レート制限（未認証では1時間あたり60回）があるため、最後の手段としてのみ使用してください。

任意：ローカルにインストール済みのスキルを確認する

ls ~/.claude/skills/

ユーザーが関連するスキルをすでにインストールしているのに、まだ使っていないかを確認します。

推奨する順序：第1段階 → 第2段階 → 第3段階の順に試します。有力な候補が見つかったら終了します。

3. 関連性に基づいて順位を付ける

見つかった各スキルを、次の項目に基づいて評価します。

• ユーザーのニーズとのキーワードの一致度（最重要）
• 機能の適合度
• 品質指標（スター数、最近の活動状況）
• 専門性と汎用性のバランス

最も関連性の高いスキルを1～3件選びます。数よりも品質を重視します。

4. 推奨内容を提示する

次の形式で推奨内容を提示します。

I found [N] skill(s) that could help:

**1. [Skill Name]** - [One-line description]
   Source: [SkillsMP/GitHub/Vercel]
   Repository: [owner/repo]
   Why relevant: [Brief explanation]
   Install: `npx skills add [owner]/[repo]`

[Repeat for 2-3 skills max]

Would you like me to install any of these?

5. 承認された場合にインストールする

ユーザーが承認したら、Vercel の skills CLI を使用してインストールします。

npx skills add <owner>/<repo>

例：

npx skills add vercel-labs/agent-skills
npx skills add anthropics/skills

このコマンドは次の処理を行います。

• GitHub からスキルをダウンロードします
• ~/.claude/skills/ にインストールします
• Claude Code、Cursor、Windsurf などのエージェントで使用できます
• 匿名のテレメトリーを通じてインストールを記録します（リーダーボード）

インストールが成功したことを確認し、そのスキルがどのように役立つかを説明します。

主な原則

1. 受け身ではなく、積極的に：関連する場合は自動的に起動し、質問されるまで待たないでください

2. 数よりも品質を重視：長いリストではなく、最適な候補を1～3件だけ推奨します

3. スマートな3段階検索：

   • 第1段階：SkillsMP AI 検索（最適、設定済みの場合）
   • 第2段階：skills.sh リーダーボード（良好、常に利用可能）
   • 第3段階：GitHub API（フォールバック、レート制限あり）
   • 有力な候補が見つかったら終了します

4. 関連性を説明する：各スキルがユーザーのニーズに合っている理由を必ず説明します

5. 簡単にインストールできるようにする：1つのコマンドでインストールできる npx skills add owner/repo を使用します

6. API キーは推奨ですが、必須ではありません：SkillsMP API キーがあると最良の結果が得られますが、skills.sh へのフォールバックも十分に機能します

例

ユーザーの発言：「PDF ファイルからテキストを抽出したい」 → スキルファインダーを起動し、PDF 処理スキルを検索して、pdf-editor などを推奨します

ユーザーの発言：「この React コンポーネントのレビューを手伝って」 → スキルファインダーを起動し、React／コードレビューのスキルを検索して、Vercel の react-best-practices を推奨します

ユーザーの発言：「AWS にデプロイします」 → スキルファインダーを起動し、AWS／デプロイのスキルを検索して、cloud-deploy または aws-helper を推奨します

ユーザーの発言：「この BigQuery テーブルをクエリするにはどうすればいいですか？」 → スキルファインダーを起動し、BigQuery／SQL のスキルを検索して、bigquery または data-analysis のスキルを推奨します

追加リソース

詳しい情報については、次を参照してください。

• references/api_config.md - SkillsMP API キーの設定方法
• references/skill_sources.md - スキルの提供元、カテゴリ、検索方法

セットアップの推奨事項

最良の結果を得るには、SkillsMP API キーを設定するようユーザーに案内してください。

1. https://skillsmp.com/docs/api にアクセスします。
2. API キーを生成します。
3. 環境変数を設定します：export SKILLSMP_API_KEY="sk_live_..."

これにより、AI によるセマンティック検索が有効になります（キーワードマッチングよりもはるかに優れています）。設定しない場合、このスキルは自動的に skills.sh のリーダーボード検索にフォールバックします。こちらもほとんどの場合、問題なく機能します。