find-agents

このスキルはユーザーのエージェント一覧を変更するため、ユーザーから明示的に依頼された場合にのみ実行してください。

必ず守るルール：

1. 利用する前に、agentshq が利用可能であることを確認してください。
2. 対象範囲を明確にしてください。プロジェクト単位かグローバルか、特定の IDE か自動検出かを示します。
3. ユーザーから依頼されていないエージェントをインストールまたは削除しないでください。
4. インストール対象が曖昧な場合は、変更を加える前に確認してください。
5. 追加、削除、更新した内容を正確に報告してください。

エージェントを探す

入力

• $request：検索語、リポジトリのソース、または list、remove、update などの管理目的

目標

agentshq を使用して、ユーザーが次の操作を行えるよう支援します。

• 関連するエージェントを見つける
• 1 つ以上の CLI または IDE にエージェントをインストールする
• 現在の一覧を表示する
• インストール済みエージェントを削除または更新する
• 依頼された場合、新しいエージェントのひな型を作成する

ステップ 0：実行環境の前提条件を確認する

次を確認します。

• Node.js が利用可能であること
• npx agentshq --version

CLI を利用できない場合は、実行できない理由を説明して終了してください。

成功条件：現在の環境から agentshq を実行できること。

ステップ 1：ユーザーの意図を確認する

ユーザーが次のどれを希望しているかを判断します。

• 検索
• インストール
• 一覧表示
• 削除
• 更新
• ひな型の作成

さらに、次の点も確認します。

• プロジェクト単位かグローバルか
• 指定されている場合は対象の IDE／CLI
• インストールする場合はソースのリポジトリ、URL、またはローカルパス

これらが曖昧な場合は、変更を加える前に質問してください。

成功条件：実行前に、agentshq で行う操作が明確になっていること。

ステップ 2：目的に合う最小限のコマンドを実行する

コマンドリファレンス

操作	コマンド	主なフラグ
検索	npx agentshq find [query]	クエリを指定しない場合は、対話形式の選択メニューを表示
リポジトリからインストール	npx agentshq add <owner>/<repo>	特定のエージェントには @<agent-name> を指定
URL からインストール	npx agentshq add <url>	ローカルパスも使用可能
インストール範囲		グローバルには -g、特定の IDE には --ide <name> ... を指定
インストールオプション		すべてのエージェントをすべての IDE にインストールするには --all、インストール前に確認するには --list を指定
インストール済みエージェントの一覧表示	npx agentshq list	グローバルには -g、IDE の指定には --ide <name>、JSON 形式には --json を指定
削除	npx agentshq remove [name]	グローバルには -g、すべてのエージェントには --all を指定
更新の確認	npx agentshq check
更新の適用	npx agentshq update
新規作成	npx agentshq init [name]

インストールする際は、次の指定に従ってください。

• ユーザーが IDE を明示的に指定した場合は、その --ide ... の指定を尊重します。
• グローバル範囲をユーザーが依頼した場合にのみ、-g を使用します。
• インストール前にソースを確認したいというユーザーの希望がある場合は、--list を使用します。

対応 IDE

CLI は 43 種類以上の IDE に対応しています。一般的なものは次のとおりです。

IDE	形式
Claude Code	YAML フロントマター付きの .md
Cursor	AGENTS.md のセクション
GitHub Copilot	.agent.md
Windsurf	AGENTS.md のセクション
Codex	AGENTS.md のセクション
Gemini CLI	YAML フロントマター付きの .md
Kiro	.json
Amp	AGENTS.md のセクション
Roo Code	AGENTS.md のセクション

インストール時には、エージェントが各 IDE のネイティブ形式に自動変換されます。

成功条件：コマンドがユーザーの意図と対象範囲に完全に合致していること。

ステップ 3：結果を明確に報告する

実行後、次の内容を報告します。

• 実行したコマンド
• 該当したエージェント、または変更したエージェント
• 対象としたクライアント／IDE
• 認証、再読み込み、再起動などの次の手順

検索時は、出力をそのまま貼り付けるのではなく、関連性の高い結果を提示してください。

成功条件：ユーザーが次に行うことをすぐに判断できること。

ガードレール

• ユーザーから依頼されていない場合、このスキルを先回りして実行しないでください。
• ユーザーがグローバル範囲を依頼した場合を除き、グローバルにインストールしないでください。
• ユーザーから明示的な依頼がない限り、エージェントを削除または更新しないでください。
• ユーザーが特定のクライアントを明確に指定している場合、対象 IDE 名を推測しないでください。
• agentshq は 1 つのソースエージェントを複数のクライアント形式に変換できます。そのことを明確に報告してください。

出力要件

次の内容を報告します。

1. 確認した操作
2. プロジェクト単位かグローバルか
3. 対象の IDE または CLI
4. 見つかった、または変更したエージェント
5. ユーザーに伝えるべき追加の手順