# Citation agent skills

Four focused skills for Citation documents and saved sources. Each folder is an Agent Skills package containing `SKILL.md` and optional supporting files. They work through Citation's installed CLI or the twelve tools on its existing MCP server. They do not grant access by themselves.

## Install into a project

Review the files first. Connect the existing Citation MCP server or install the local CLI package and authenticate with a scoped workspace token. Then download a skill ZIP from `/ai/skills` or use these repository folders.

For Codex, from your chosen project:

```sh
mkdir -p .agents/skills
unzip -n citation-skills-0.1.0.zip -d .agents/skills
```

For Claude Code, from your chosen project:

```sh
mkdir -p .claude/skills
unzip -n citation-skills-0.1.0.zip -d .claude/skills
```

The archives contain skill folders at their root. `-n` preserves existing files. Review an existing installation before updating it; a mixture of old and new files should not be treated as a verified upgrade. You can extract to a fresh temporary directory and compare the folders first. Restart or refresh the client's skill discovery if needed.

Codex: invoke `$citation-research`, `$citation-format`, `$citation-draft`, or `$citation-evidence`. Claude Code: invoke `/citation-research`, `/citation-format`, `/citation-draft`, or `/citation-evidence`. Local project installation does not install a skill into ChatGPT web, Claude web or every other client. Their account and plugin distribution flows are separate.

See [Codex local skill locations](https://learn.chatgpt.com/docs/build-skills) and [Claude Code project skills](https://code.claude.com/docs/en/skills) for client setup.

## Install in an assistant

Choose your host at [Citation skills](https://citation.co/ai/skills). Every download is built from the same four source skills with its supporting references preserved.

| Host | Download and installation |
| --- | --- |
| ChatGPT and Codex plugins | `citation-openai-plugin-0.1.0.zip` contains portable root `plugin.json`, `mcp.json`, and `skills/`. Add the extracted package through supported custom plugin or personal marketplace setup, then authorize Citation. |
| Claude skills | Upload one `citation-<workflow>.zip` at a time in skill settings. The ZIP includes its skill folder. Connect Citation separately. |
| Claude plugins | `citation-claude-plugin-0.1.0.zip` contains `.claude-plugin/plugin.json` and `skills/`. Use a supported plugin surface. For a local Claude Code session, use `claude --plugin-dir /absolute/path/to/extracted-plugin`. |
| Gemini | Upload one `citation-<workflow>-gemini.zip` in Settings, Skills. The archive has `SKILL.md` at its root. Requires eligible personal accounts, age 18 or older, and Keep Activity enabled. Configure the Citation custom app separately. |
| Perplexity Computer | Upload one `citation-<workflow>-perplexity.zip` in Computer Skills. The archive has `SKILL.md` at its root. Configure the Citation remote connector separately. |
| Kimi Work and Code | `citation-kimi-plugin-0.1.0.zip` contains root `kimi.plugin.json` and `skills/`. Import extracted files through Work Plugin Builder and install from your Personal marketplace. Code can use `/plugins install /absolute/path/to/extracted-plugin`, then `/reload`. |

Plugins contain the server address, never account credentials. Personal installation does not publish a directory listing. The model and host determine whether an installed skill is invoked. Review the requested result and permissions in your current conversation.

## What each skill does

| Skill               | Inputs                                         | Output                                           | Permissions                                     |
| ------------------- | ---------------------------------------------- | ------------------------------------------------ | ----------------------------------------------- |
| `citation-research` | Target document and sources to gather          | Saved source IDs, provenance and missing details | Document and source read, plus requested writes |
| `citation-format`   | Document ID and requested citation style       | Formatted bibliography and inline examples       | Document and source read                        |
| `citation-draft`    | Target document, requested edit and source IDs | Reviewed saved version and citation links        | Document read/write, source read                |
| `citation-evidence` | Document ID and review scope                   | Citation integrity issues and evidence gaps      | Document and source read                        |

Research uses supplied metadata or the client's separately available, authorized research tools. Citation MCP/CLI does not fetch URLs or search the public web. Evidence checks do not certify originality or factual truth. No skill exposes sharing, invitations or deletion through unsupported commands.

The CLI workflow examples assume `citation` is on PATH. Check `citation auth status --json` before using them. If using MCP instead, discover the actual server tool names and their input schemas, then call the names stated in each skill with any prefix added by the client. Never paste a token into a prompt or skill file.

## Build and validate

From the Citation repository root:

```sh
node scripts/build-ai-downloads.mjs
node --test packages/cli/test/*.test.mjs
node --import tsx --test tests/ai-cli.test.mts
```

The CLI integration suite runs the workflow operations against disposable PostgreSQL and the real MCP service. Static skill validation and command execution are distinct from a model choosing and following a skill. See `docs/AI_ECOSYSTEM.md` for the actual client evidence and remaining requirements.