find-agents

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

<EXTREMELY-IMPORTANT> This skill changes the user's agent inventory and must stay explicit-user-only.

Non-negotiable rules:

Verify
```
agentshq
```
availability before relying on it.
Be explicit about scope: project vs global, specific IDEs vs auto-detect.
Do not install or remove agents the user did not ask for.
Confirm ambiguous install targets before making changes.
Report exactly what was added, removed, or updated.

</EXTREMELY-IMPORTANT>

<EXTREMELY-IMPORTANT> 此技能会更改用户的Agent库存，必须仅在用户明确要求时使用。

不可协商的规则：

在依赖
```
agentshq
```
之前，先验证其是否可用。
明确说明范围：项目级还是全局级、特定IDE还是自动检测。
不得安装或移除用户未要求的Agent。
在进行更改前，确认模糊的安装目标。
准确报告新增、移除或更新的内容。

</EXTREMELY-IMPORTANT>

Find Agents

查找Agent

Inputs

```
$request
```
: Search terms, repo source, or management intent such as
```
list
```
,
```
remove
```
, or
```
update
```

```
$request
```
: 搜索词、仓库源或管理意图，例如
```
list
```
、
```
remove
```
或
```
update
```

Goal

目标

Use

agentshq

to help the user:

discover relevant agents
install agents into one or more CLIs or IDEs
list current inventory
remove or update installed agents
scaffold a new agent when asked

使用

agentshq

帮助用户：

发现相关Agent
将Agent安装到一个或多个CLI或IDE中
列出当前库存
移除或更新已安装的Agent
在用户要求时搭建新的Agent

Step 0: Verify runtime prerequisites

步骤0：验证运行时先决条件

Check:

Node.js availability
```
npx agentshq --version
```

If the CLI is unavailable, explain the blocker and stop.

Success criteria:

agentshq

can be invoked from the current environment.

检查：

Node.js是否可用
```
npx agentshq --version
```

如果CLI不可用，说明阻碍因素并停止操作。

成功标准：可从当前环境调用

agentshq

。

Step 1: Resolve the user's intent

步骤1：解析用户意图

Determine whether the user wants to:

search
install
list
remove
update
scaffold

Also resolve:

project vs global scope
target IDEs/CLIs if specified
source repo, URL, or local path if installing

If those details are ambiguous, ask before mutating anything.

Success criteria: The exact

agentshq

action is clear before execution.

判断用户是否想要：

搜索
安装
列出
移除
更新
搭建

同时解析：

项目级还是全局级范围
若指定了目标IDE/CLI
安装时的源仓库、URL或本地路径

如果这些细节不明确，在进行任何修改前询问用户。

成功标准：在执行前明确具体的

agentshq

操作。

Step 2: Run the narrowest relevant command

步骤2：运行最贴合需求的命令

Command Reference

Action	Command	Key Flags
Search	`npx agentshq find [query]`	interactive picker when no query given
Install from repo	`npx agentshq add <owner>/<repo>`	`@<agent-name>` for specific agent
Install from URL	`npx agentshq add <url>`	also works with local paths
Install scope		`-g` for global, `--ide <name> ...` for specific IDEs
Install options		`--all` for all agents to all IDEs, `--list` to preview
List installed	`npx agentshq list`	`-g` for global, `--ide <name>` , `--json`
Remove	`npx agentshq remove [name]`	`-g` for global, `--all` for all agents
Check updates	`npx agentshq check`
Apply updates	`npx agentshq update`
Scaffold new	`npx agentshq init [name]`

When installing, respect:

explicit
```
--ide ...
```
choices when the user gave them
```
-g
```
only when the user asked for global scope
```
--list
```
when the user wants to inspect a source before installing

操作	命令	关键标志
搜索	`npx agentshq find [query]`	未提供查询词时显示交互式选择器
从仓库安装	`npx agentshq add <owner>/<repo>`	使用 `@<agent-name>` 指定特定Agent
从URL安装	`npx agentshq add <url>`	本地路径同样适用
安装范围		`-g` 表示全局级， `--ide <name> ...` 表示特定IDE
安装选项		`--all` 表示将所有Agent安装到所有IDE， `--list` 表示预览
列出已安装内容	`npx agentshq list`	`-g` 表示全局级， `--ide <name>` ， `--json`
移除	`npx agentshq remove [name]`	`-g` 表示全局级， `--all` 表示移除所有Agent
检查更新	`npx agentshq check`
应用更新	`npx agentshq update`
搭建新Agent	`npx agentshq init [name]`

安装时需遵循：

当用户指定了明确的
```
--ide ...
```
选项时，予以尊重
仅当用户要求全局范围时使用
```
-g
```
当用户想要在安装前检查源内容时使用
```
--list
```

Supported IDEs

The CLI supports 43+ IDEs. Common ones:

IDE	Format
Claude Code	`.md` with YAML frontmatter
Cursor	`AGENTS.md` sections
GitHub Copilot	`.agent.md`
Windsurf	`AGENTS.md` sections
Codex	`AGENTS.md` sections
Gemini CLI	`.md` with YAML frontmatter
Kiro	`.json`
Amp	`AGENTS.md` sections
Roo Code	`AGENTS.md` sections

Agents are automatically translated to each IDE's native format on install.

Success criteria: The command matches the user's intent and scope exactly.

该CLI支持43+款IDE。常见的有：

IDE	格式
Claude Code	`.md` 带YAML前置元数据
Cursor	`AGENTS.md` 章节
GitHub Copilot	`.agent.md`
Windsurf	`AGENTS.md` 章节
Codex	`AGENTS.md` 章节
Gemini CLI	`.md` 带YAML前置元数据
Kiro	`.json`
Amp	`AGENTS.md` 章节
Roo Code	`AGENTS.md` 章节

安装时会自动将Agent转换为各IDE的原生格式。

成功标准：命令完全匹配用户的意图和范围。

Step 3: Report the result clearly

步骤3：清晰报告结果

After execution, report:

what command ran
which agents matched or changed
which clients/IDEs were targeted
any next steps such as authentication, reload, or restart

When searching, present the most relevant results instead of dumping raw output.

Success criteria: The user can immediately decide what to do next.

执行后，报告：

运行的命令
匹配或更改的Agent
目标客户端/IDE
任何后续步骤，例如认证、重新加载或重启

搜索时，呈现最相关的结果而非输出原始内容。

成功标准：用户可立即决定下一步操作。

Guardrails

防护规则

Do not run this skill proactively.
Do not install globally unless the user asked for global scope.
Do not remove or update agents without explicit user intent.
Do not guess target IDE names when the user clearly cares about a specific client.
Remember that
```
agentshq
```
can translate one source agent into multiple client formats; report that clearly.

不得主动运行此技能。
除非用户要求全局范围，否则不得全局安装。
无明确用户意图时，不得移除或更新Agent。
当用户明确关注特定客户端时，不得猜测目标IDE名称。
记住
```
agentshq
```
可将一个源Agent转换为多种客户端格式；需清晰报告这一点。

Output Contract

输出约定

Report:

the resolved action
project/global scope
target IDEs or CLIs
the agents found or changed
any follow-up steps the user should know about

报告：

已解析的操作
项目/全局范围
目标IDE或CLI
找到或更改的Agent
用户需要了解的任何后续步骤