# Apidance Skills 列表

这个目录用于放置随 `@apidance/mcp` 一起发布的可选 Codex Skills。

Skill 本身不是 MCP tool。它更像一套可复用的 Agent 工作流说明和辅助脚本，用来在 Apidance Twitter API 之上完成更高层的任务。

## 当前包含的 Skills

| Skill | 路径 | 用途 |
| --- | --- | --- |
| Apidance Twitter Team Discovery | `skills/apidance-discover-twitter-team/` | 发现并核验官方 X/Twitter 账号背后的直接团队账号，以及相关生态账号。 |

## 使用随包发布的 Skill

安装 npm 包后，可以先找到包根目录：

```bash
npm root -g
```

如果是全局安装，Skill 通常位于：

```text
$(npm root -g)/@apidance/mcp/skills/apidance-discover-twitter-team/
```

在包根目录下可以直接运行服务脚本：

```bash
node skills/apidance-discover-twitter-team/scripts/run-discovery.mjs --help
```

如果把某个 Skill 文件夹复制到 `~/.codex/skills` 独立使用，请保留 `@apidance/mcp` 包，并在运行脚本前设置 `APIDANCE_MCP_PACKAGE_ROOT` 指向该包根目录。

## 公共代码复用

随包发布的 Skills 应尽量复用 MCP 包里的公共代码，不维护重复私有实现。当前团队发现 Skill 使用：

- `src/server.js`：包内 Apidance 调用逻辑。
- `public-scripts/data-cleaning/twitter-normalize.mjs`：Twitter GraphQL 数据归一化和 cursor 提取。

## MCP Resources

MCP 客户端可以通过下面资源读取 Skill 列表：

```text
apidance://twitter/skills
apidance://twitter/skills.zh-CN
```