skills-discovery

スキルの検索

claude-plugins.dev レジストリから Agent Skills を検索してインストールし、機能を拡張できます。スキルは、特定のテクノロジー、フレームワーク、分野に関する専門知識、ツール、手法を提供します。

スキルを検索するタイミング

まず、インストール済みのスキルがタスクに合っているか確認してください。合っていない場合は、レジストリを検索してください。まだインストールしていない専門的なスキルが見つかるかもしれません。

重要なタスクを始める前に、次の点を自問してください。

1. このタスクに使えるスキルはありますか？ → 使用してください
2. まだインストールしていないスキルが存在する可能性はありますか？ → レジストリを検索してください

次の場合は、積極的に検索してください。

• 特定のテクノロジー、フレームワーク、ファイル形式が関係するタスク
• ベストプラクティスが重要となる作業（テスト、デプロイ、API、ドキュメントなど）
• 専門性の高い分野（PDF 処理、データパイプライン、ML ワークフローなど）
• 専門家の手法が役立つ場面で、一般的なアドバイスをしようとしていることに気付いたとき

ユーザーからスキルの検索、インストール、管理を明示的に頼まれた場合も検索してください。

検索のワークフロー

検索にはレジストリ API を使用してください（CLI の検索コマンドは対話式のため、プログラムからの使用には適していません）。

curl "https://claude-plugins.dev/api/skills?q=QUERY&limit=20&offset=0"

パラメーター：

• q：検索クエリ（例：「frontend」、「python」、「pdf」）
• limit：1 ページあたりの結果数（最大 100）
• offset：ページネーションのオフセット

レスポンスの構造：

{
  "skills": [
    {
      "id": "...",
      "name": "skill-name",
      "namespace": "@owner/repo/skill-name",
      "sourceUrl": "https://github.com/...",
      "description": "...",
      "author": "...",
      "installs": 123,
      "stars": 45
    }
  ],
  "total": 100,
  "limit": 10,
  "offset": 0
}

検索戦略

レジストリでは、スキル名、説明、タグがインデックス化されています。スキルの作成者が説明に使う用語に合ったクエリを作成してください。

クエリの作成：

• 具体的な用語を1〜3個使用します（範囲が広すぎるとノイズが増え、狭すぎると見逃しが生じます）
• プロジェクト固有の専門用語より、広く使われている用語を優先します
• テクノロジーとタスクを組み合わせると、どちらか一方だけの場合より効果的なことがよくあります
• 結果が芳しくない場合は、検索範囲を広げるか、類義語を試してください

インストール

インストール前に、ユーザーがどのクライアントを使用しているか確認してください。不明な場合は質問してください。

対応クライアント：

• claude-code — Claude Code CLI
• codex — Codex
• cursor — Cursor エディター
• amp - amp CLI
• opencode - OpenCode CLI
• goose - Goose CLI
• github — VSCode/ github
• vscode — VS Code
• letta — Letta CLI
• gemini - Gemini CLI
• windsurf - Windsurf エディター
• antigravity - Antigravity
• trae - Trae
• qoder - Qoder
• codebuddy - CodeBuddy
• クライアントの選択：

npx skills-installer install @owner/repo/skill-name --client claude-code  # default
npx skills-installer install @owner/repo/skill-name --client cursor
npx skills-installer install @owner/repo/skill-name --client vscode

スコープの選択：

npx skills-installer install @owner/repo/skill-name  # global (default)
npx skills-installer install @owner/repo/skill-name --local  # project-specific

組み合わせ：

npx skills-installer install @owner/repo/skill-name --client cursor --local

デフォルト：

• クライアント：claude-code
• スコープ：global

管理

# List installed skills
npx skills-installer list

# Uninstall a skill
npx skills-installer uninstall @owner/repo/skill-name

検索結果をユーザーに提示する

関連するスキルが見つかった場合：

1. 関連性の高い結果を最大3〜5件提示します
2. 名前、名前空間、説明、スター数、インストール数を含めます
3. 各スキルがユーザーの_具体的な_タスクにどう役立つか説明します
4. インストール数が多いものを優先します
5. インストールする前に必ず確認を求めます
6. 適切なスキルがない場合やユーザーが希望しない場合は、直接サポートすることを提案します

例

例：先回りした提案

ユーザー：「Django REST API を作成したいです」

curl "https://claude-plugins.dev/api/skills?q=django&limit=10"

提案を提示：

I found some skills that could help:

1. django-rest-framework-expert (@anthropics/claude-code/django-rest-framework-expert)
   Description: Django REST API development with best practices
   ⭐ 234 stars • 1,567 installs

Would you like me to install this, or help you directly without installing a skill?

例：明示的な検索依頼

ユーザー：「Python のスキルを探してください」

curl "https://claude-plugins.dev/api/skills?q=python&limit=10"

結果を提示し、どれをインストールするか尋ねます。

API リファレンス

エンドポイント	説明
GET /api/skills/search?q=QUERY	スキルを検索
GET /api/skills/@owner/repo/skill-name	スキルの詳細を取得

ウェブレジストリ： https://claude-plugins.dev/skills

トラブルシューティング

検索結果が見つからない場合：

• より広い検索語を試してください
• ウェブレジストリを閲覧してください：https://claude-plugins.dev/skills

インストールに失敗する場合：

• 名前空間の形式を確認してください：@owner/repo/skill-name
• スキルがレジストリに存在するか確認してください
• ディレクトリのアクセス権限を確認してください

スキルが有効にならない場合：

• ユーザーがクライアントを再起動する必要がある場合があります
• インストール先のディレクトリが正しいか確認してください
• インストール先のパスに SKILL.md が存在することを確認してください