# Apidance Skills

This directory contains optional Codex Skills bundled with `@apidance/mcp`.

Skills are not MCP tools themselves. They are reusable agent instructions and helper scripts that Codex can load when a task needs a higher-level workflow on top of the Apidance Twitter API.

## Available Skills

| Skill | Path | Purpose |
| --- | --- | --- |
| Apidance Twitter Team Discovery | `skills/apidance-discover-twitter-team/` | Discover and verify the direct team and related ecosystem accounts behind an official X/Twitter account. |

## Using A Bundled Skill

After installing the npm package, locate the package root:

```bash
npm root -g
```

For a global install, the Skill is usually under:

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

Run the bundled service from the package root:

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

If you copy a Skill folder into `~/.codex/skills`, keep `@apidance/mcp` installed and set `APIDANCE_MCP_PACKAGE_ROOT` to the package root before running bundled scripts.

## Shared Code

Bundled Skills should reuse public package helpers instead of keeping private copies. The current team discovery Skill uses:

- `src/server.js` for the in-process Apidance caller.
- `public-scripts/data-cleaning/twitter-normalize.mjs` for Twitter GraphQL normalization and cursor extraction.

## MCP Resources

MCP clients can read this list through:

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