---
title: "安装 Wherobots Agent Skills"
summary: "使用 npx skills add -g wherobots/agent-skills 安装技能，也可用 --skill 选择单项。MCP 连接需要单独配置。"
category: skills
level: starter
surfaces: [cli, app, ide]
tags: ["Skills", "Wherobots", "CLI"]
canonical: /tips/wherobots-agent-skills/
---

# 安装 Wherobots Agent Skills

使用 npx skills add -g wherobots/agent-skills 安装技能，也可用 --skill 选择单项。MCP 连接需要单独配置。

在 Codex CLI 和桌面端使用 Wherobots 时，需要分别配置 MCP、Agent Skills 和 CLI。仓库名是 `wherobots/agent-skills`。技能用于指导代理选择 MCP、CLI 或 SDK，MCP 连接仍需单独配置 `mcp_servers.wherobots-mcp-server`。

官方 Codex 页的安装命令带 `-g`，装到用户目录：

```bash
npx skills add -g wherobots/agent-skills
```

先看目录：

```bash
npx skills add wherobots/agent-skills --list
```

安装页单项示例是 `--skill wherobots-usage`，默认不带 `-g`，会落到当前项目。需要全局安装时使用 `-g`，也可指定 `--agent codex`。官方安装示例未指定 `--agent codex`。仓库 README 还写 skills.sh 语法 `wherobots/agent-skills@wherobots-usage`：

```bash
npx skills add -g wherobots/agent-skills --skill wherobots-usage
npx skills add wherobots/agent-skills@wherobots-usage
```

仓库包含三项技能：`wherobots-usage`（选 MCP / CLI / SDK）、`wherobots-explore`（目录和 Spatial SQL）、`wherobots-develop`（CLI / SDK / 提交作业）。Codex 用 `/skills` 或 `$wherobots-usage`、`$wherobots-explore`、`$wherobots-develop`。

远程 MCP 仍走 `codex mcp add wherobots-mcp-server --url https://api.cloud.wherobots.com/mcp/`，再 `codex mcp login wherobots-mcp-server`。explore 工作流需要先建立 MCP 连接。

安装后重新打开会话。先问「帮我选 MCP 还是 CLI 来列 Data Hub 目录」，看它是否调起 `wherobots-usage`。

网页 Cloud 不读取本机技能目录。修改后重新打开会话，`/skills` 应能看见 `wherobots-usage`。

## 来源

- [Wherobots · Set Up Wherobots in Codex](https://docs.wherobots.com/develop/agentic-tools/codex)
- [Wherobots · Install Agent Skills](https://docs.wherobots.com/develop/agent-skills)
- [wherobots/agent-skills](https://github.com/wherobots/agent-skills)