skills-search

Skills Search — エージェントの行動指針

まずローカルリポジトリを検索

機能の検索や既存の知見の再利用では、 ローカルリポジトリ検索を読み、 そのヘルパーを実行してください。Skill ディレクトリは、インストール先を記憶に頼って推測せず、この読み込まれたバンドルから特定してください。

uv run --script <skill-dir>/scripts/local_sources.py list
uv run --script <skill-dir>/scripts/local_sources.py search '<capability>' --tier owned

候補を選ぶ前に、所有対象の階層にある有効なリポジトリをすべて検索してください。返されたcoverage、調査済み件数、正確なコミットを確認してください。ソースが見つからない場合、設定に問題がある場合、またはスキャンが中断された場合は、カバレッジが不完全であり、「Skill がない」ことを意味しません。デフォルトのインストールディレクトリはインベントリであり、ユーザーのソースカタログ全体ではありません。ユーザーが指定したリポジトリをすべて設定し、最初のリポジトリで見つかったからといって検索を終えたり、別のマシンのパスを暗黙に推測したりしないでください。

段階的に情報を開示してください。カタログの名前・説明 → 選択したSKILL.md（返されたコミットのもの） → 関連するリンク先のリファレンス／スクリプト、の順に確認します。メタデータのスコアは候補の順位付けに使います。適合すると判断する前に、機能、入力、所有者、検証方法を確認してください。適切な既存の Skill を更新し、適合するものがなければ、無関係な所有者にワークフローを詰め込まず、新しい Skill を作成してください。

この階層で残りのタスクを解決できない場合は、設定済みのtrustedリポジトリを検索し、それでも必要であれば、以下の既存の CCPM 検索を使用してください。検索範囲を広げる必要があった理由を記録してください。プライベートなパス、リポジトリ名、内容をレジストリに送信しないでください。ローカルスキャンの失敗を外部検索の結果で覆い隠さないでください。

CCPM の準備（必要な場合のみ）

外部レジストリを検索する場合、またはインストール／更新／管理を明示的に依頼された場合は、command -v ccpmを確認してください。利用できない場合は、既存の CLI の代替手段としてnpx @daymade/ccpmを使います。ローカル検索に CCPM やレジストリの認証情報は不要です。ユーザーがエコシステムのセットアップを依頼した場合に限り、npx @daymade/ccpm setupを使用してください。これは連携機能も設定するため、オフライン検索の前提条件ではありません。

基本動作

選択したローカルヘルパーまたはccpmコマンドは、シェルから自分で実行してください。タスクの権限内で実行できるコマンドを、ユーザーにコピー＆ペーストするよう求めないでください。

ccpmがグローバルにインストールされていない場合は、以下のすべてのコマンドで代わりにnpx @daymade/ccpmを使用してください。

意図の対応付け

ユーザーの意図に適したアクションを選んでください。

ユーザーの意図	アクション
「X の Skill を探して」／「X の Skill を検索して」／Skill を作成する前に既存のものを再利用したい	所有対象のリポジトリ → 設定済みの信頼できるリポジトリ → それでも必要ならccpm search <query>
「人気の Skill は？」／「トップの Skill は？」	ccpm popular
「新しいものは？」／「最新の Skill は？」	ccpm recent
「X をインストールして」／「X の Skill を追加して」	ccpm install <skill-name>
「X は何をするの？」／「X について教えて」	まずローカルの候補を読む。レジストリの候補にはccpm info <skill-name>を使う
「自分が持っている Skill は？」／「Skill の一覧を表示して」	ccpm list
「X を削除して」／「X をアンインストールして」	ccpm uninstall <skill-name>
「X を更新して」／「すべての Skill を更新して」	ccpm update [name] [--all]
「PDF／Excel／…で作業したい」	まずローカルで検索し、必要であればccpm search <topic>まで検索を広げてから、インストールを提案する前に適合性を確認する

実行ルール

1. 必ず自分で直接実行する — 選択したローカルヘルパーまたはccpmコマンドを実行し、ユーザーに手動で実行するよう求めないでください。
2. 結果を要約する — 実行後、出力を明確で読みやすい形式で提示してください。
3. 結果から選ぶ — ローカルの Skill がすでにインストールされている場合があります。見つかっただけで再インストールせず、インストール済みかどうかを別途確認してください。インストールが必要な場合は、既存のオプトイン方式のインストールフローを維持してください。インストール後は、Claude Code を再起動するようユーザーに伝えてください。
4. エラーに適切に対処する — ccpmが見つからない場合は、npx @daymade/ccpmに切り替えてください。レジストリに接続できない場合は、その旨を明確に伝えてください。
5. 名前空間付きの Skill — @org/skill-name形式をサポートしてください（例：ccpm install @daymade/skill-creator）。

コマンドリファレンス

検索

ccpm search <query> [--limit <n>] [--tags <t1,t2>] [--author <name>] [--smart]

検索

ccpm popular [--limit <n>]       # Most downloaded
ccpm recent [--limit <n>]        # Recently published/updated

インストールと管理

ccpm install <skill-name>        # Install (user-level, default)
ccpm install <name> --project    # Install to current project only
ccpm install <name> --force      # Force reinstall
ccpm list                        # List installed skills
ccpm info <skill-name>           # Detailed skill information
ccpm update [name]               # Update a skill
ccpm update --all                # Update all skills
ccpm uninstall <skill-name>      # Remove a skill

インストール後のリマインダー

インストールが正常に完了したら、必ず次の内容をユーザーに伝えてください。

スキルが正常にインストールされました。スキルを利用できるようにするには、Claude Code を再起動するか、新しい会話を開始してください。

MCP サーバーの代替手段

ネイティブなツール連携を希望する Claude Desktop ユーザー（Bash 不要）向けに、同じ機能を MCP サーバーとして利用できます。

{
  "mcpServers": {
    "skill-search": {
      "command": "npx",
      "args": ["-y", "skills-search-mcp"]
    }
  }
}

MCP サーバーは外部の ccpm CLI をラップします。このスキルで設定したローカルリポジトリは検索しません。ローカルの検索は引き続き、同梱のヘルパーが行います。

トラブルシューティング

「ccpm: command not found」

代わりに npx @daymade/ccpm を使用するか、グローバルにインストールしてください：npm install -g @daymade/ccpm。

インストール後にスキルを利用できない

Claude Code を再起動してください。スキルは起動時に読み込まれます。

権限エラー

~/.claude/skills/ への書き込み権限を確認してください。プロジェクト単位でインストールするには、--project を指定してください。