> ## Documentation Index
> Fetch the complete documentation index at: https://docs.masterskills.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Supported agents

> 70+ coding agents, auto-detected — one install covers all of them.

MasterSkills installs skills for every AI coding agent it finds on a machine. The agent registry covers **70+ agents** — the full [skills.sh](https://skills.sh) agent set — including Claude Code, Codex, Cursor, Gemini CLI, Windsurf, Cline, Amp, Zed, and Warp.

```bash theme={"dark"}
masterskills agents          # detected agents on this machine, with their skill dirs
masterskills agents --all    # every supported agent
```

## How detection works

An agent counts as installed when its config directory exists (for example `~/.claude` for Claude Code, `~/.codex` for Codex). No per-agent integrations, no plugins: supporting an agent means knowing which user-level skills folder it reads.

Two families:

* **Own-directory agents** — Claude Code (`~/.claude/skills`), Windsurf (`~/.codeium/windsurf/skills`), and others each get their own link into the central store.
* **Universal-directory agents** — Cline, Warp, Zed, Kimi, and others read the shared `~/.agents/skills` convention. That directory is linked exactly once and serves them all. The `universal` pseudo-agent covers any future tool that adopts the convention — it activates whenever `~/.agents` exists.

Install once, and every detected agent gets the same skills at the same versions; agents installed later are one [`masterskills link`](/cli/link) (or any subsequent install) away.

## Talking to MasterSkills *through* an agent

Installing skills works for all registry agents. Driving MasterSkills conversationally — "publish this", "any updates?" — additionally requires the agent to run shell commands, since the MasterSkills skill drives the `masterskills` CLI. Claude Code is the reference experience; any agent that loads skills and executes commands works the same way.

## Environment overrides

| Variable                             | Effect                                                              |
| ------------------------------------ | ------------------------------------------------------------------- |
| `MASTERSKILLS_AGENT_DIR_<ID>`        | Redirect one agent's base directory (id uppercased, `-` → `_`)      |
| `MASTERSKILLS_AGENTS`                | Comma-separated ids — restrict the registry to exactly these agents |
| `CLAUDE_CONFIG_DIR`, `CODEX_HOME`, … | Agent-native overrides are honored, same as skills.sh               |

`masterskills agents --json` shows each agent's id, detection state, and resolved `skillsDir` — useful when scripting or debugging link locations.