# Agent skill（技能）

skill 是一个 Markdown 指令文件，Agent 按需加载。Acahti 发布了三个 skill，都放在本站，所有实例通用：

| Skill | URL | 内容 |
|---|---|---|
| `acahti` | [/skill.md](/skill.md) | 查找实例、Git 身份、从推送到合并的循环、流水线、密钥、制品、团队 |
| `acahti-install` | [/install.md](/install.md) | 通过 SSH 安装和升级实例 |
| `acahti-demo` | [/demo.md](/demo.md) | 最短的交付循环，用作首次冒烟测试 |

skill 不包含任何实例数据。Agent 从用户、MCP 连接、`ACAHTI_ROOT_URL` 或名为 `acahti` 的 git remote 获取实例 URL，其余信息都来自 `whoami`。

## 安装

任何能获取 URL 的 Agent：

```text
Install https://acahti.dev/skill.md
```

Claude Code，作为个人 skill：

```bash
mkdir -p ~/.claude/skills/acahti
curl -fsSL https://acahti.dev/skill.md -o ~/.claude/skills/acahti/SKILL.md
```

Codex：

```bash
mkdir -p ~/.codex/skills/acahti
curl -fsSL https://acahti.dev/skill.md -o ~/.codex/skills/acahti/SKILL.md
```

然后连接 MCP 并完成认证（OAuth 或 `ACAHTI_TOKEN`）；参见[接入 Agent](agents.md)。Codex 不需要 CLI。

Cursor 和 Codex 也可以改从[编辑器插件](plugin.md)获取 skill，同时获得 MCP 配置。

`acahti-install` 和 `acahti-demo` 的安装方式相同。

## 保持最新

每个实例都会告诉 Agent skill 的位置：`whoami.skill_url` 和 MCP 服务端在连接时给出的说明，都指向 https://acahti.dev/skill.md。持有旧版本的 Agent 会重新获取该 URL。skill 本身在开头几行也写明了这一点。

## 接下来：连接

skill 需要连接到一个实例：IDE Agent（Codex、Cursor、Claude Code）使用 [MCP](mcp.md)，shell Agent 和流水线任务使用 [CLI](cli.md)。安装 skill 不会安装 CLI，IDE Agent 也不应安装 CLI。