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

# Cargo Skills

> Structured prompt packages that teach AI coding agents — Claude Code, Cursor, Codex, and more — how to operate your entire Cargo workspace from natural language.

**Cargo Skills** turn the [Cargo CLI](/cli/overview) into something your AI agent
can drive on its own. Each skill is a prompt package that encodes the CLI's
commands, flags, UUID-discovery patterns, and gotchas — so instead of guessing,
your agent already knows exactly how to run tools, trigger plays, query the
warehouse, and deploy agents.

You just describe what you want:

```
"Trigger the MQL scoring play on all leads added this week."
  → cargo-ai orchestration play list
  → cargo-ai orchestration batch create --workflow-uuid <uuid> \
      --data '{"kind":"segment","segmentUuid":"<uuid>"}' \
      --wait-until-finished
```

No manual UUID lookup, no documentation tab, no copy-pasting JSON.

<Note>
  Want to suggest an edit, report an issue, or fork the skills? Head to
  [getcargohq/cargo-skills](https://github.com/getcargohq/cargo-skills) on
  GitHub.
</Note>

***

## The seven skills

Each skill maps to one [command domain](/cli/overview#command-domains) of the CLI:

| Skill                     | Domain      | What your agent can do                                                                                                                            |
| ------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `cargo-cli-orchestration` | Runtime     | Run tools on single records, trigger batch plays across segments, chat with AI agents, query the data warehouse with SQL, fetch live segment data |
| `cargo-cli-storage`       | Schema      | Inspect model DDL, create and update columns (custom, computed, metric, lookup), manage datasets, set model relationships                         |
| `cargo-cli-connection`    | Connectors  | Authenticate connector instances, list available integrations and their action slugs, discover native actions                                     |
| `cargo-cli-ai`            | Agents      | Create and configure agents, manage releases (draft → deploy), upload files for RAG, connect MCP servers, inspect memories                        |
| `cargo-cli-analytics`     | Measurement | Download run results, export segment data to files, pull per-node error rates and success metrics                                                 |
| `cargo-cli-billing`       | Costs       | Track credit consumption by workflow, connector, or agent; check subscription status; view invoices                                               |
| `cargo-cli-workspace`     | Admin       | Invite users, create and rotate API tokens, organize resources into folders, manage roles                                                         |

***

## 1. Install the CLI

Skills drive the CLI, so it has to be installed and authenticated first. Follow
[Install & authenticate](/developer-tools/installation), then confirm:

```bash theme={null}
cargo-ai whoami
```

## 2. Install the skills

```bash theme={null}
npx skills add getcargohq/cargo-skills
```

This creates a `.skills/` directory with seven skill files your agent reads
automatically. Commit it so every team member and CI environment shares the same
setup without a separate install step.

## 3. Verify

Ask your agent:

```
What Cargo skills do you have available?
```

It will list the seven domains and what it can do with each.

***

## Supported agents & editors

Any tool that follows the [skills.sh](https://skills.sh) standard works with the
**same install command** — there's no per-editor configuration, because
`.skills/` is the universal integration point.

<CardGroup cols={2}>
  <Card title="Claude Code" icon="anthropic">
    Persist your token in your shell profile so it's available from any working
    directory: `export CARGO_API_TOKEN=<your-api-token>` in `~/.zshrc` or
    `~/.bashrc`.
  </Card>

  <Card title="Cursor" icon="c">
    Run the install command in your project root; Cursor's agent picks up
    `.skills/` automatically.
  </Card>

  <Card title="Codex CLI" icon="terminal">
    Works out of the box once `.skills/` is present in the working directory.
  </Card>

  <Card title="GitHub Copilot (agent mode)" icon="github">
    Reads `.skills/` from the repository root — commit it so Copilot loads it in
    every session.
  </Card>

  <Card title="Windsurf" icon="wind">
    Same one-command install; no additional configuration required.
  </Card>

  <Card title="Any skills.sh agent" icon="robot">
    Follows the open [skills.sh](https://skills.sh) standard, so new compatible
    editors work with the same command.
  </Card>
</CardGroup>

***

## Troubleshooting

| Symptom                           | Fix                                                                                      |
| --------------------------------- | ---------------------------------------------------------------------------------------- |
| Agent says it has no Cargo skills | Run `npx skills add getcargohq/cargo-skills` in the project root and restart the session |
| `cargo-ai: command not found`     | Run `npm install -g @cargo-ai/cli`                                                       |
| `Unauthorized` errors             | Run `cargo-ai whoami` to confirm the active token and workspace                          |
| Wrong workspace targeted          | Re-authenticate: `cargo-ai login --token <token> --workspace-uuid <uuid>`                |

***

## Next steps

<CardGroup cols={2}>
  <Card title="Examples" icon="book-open" href="/skills/examples">
    Worked examples: run tools, trigger plays, query the warehouse, build
    workflows, deploy agents, and more.
  </Card>

  <Card title="CLI Overview" icon="terminal" href="/cli/overview">
    Command reference, UUID flows, filter syntax, async patterns, and gotchas.
  </Card>

  <Card title="Cargo Skills on GitHub" icon="github" href="https://github.com/getcargohq/cargo-skills">
    Browse skill source, report issues, or contribute improvements.
  </Card>

  <Card title="skills.sh standard" icon="book" href="https://skills.sh">
    Learn how skills work and how to author your own packages.
  </Card>
</CardGroup>