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 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.

Want to suggest an edit, report an issue, or fork the skills? Head to getcargohq/cargo-skills on GitHub.

---

The skills

The set is one skill per CLI command domain, plus a cargo router that ties them together and a cargo-gtm outcome skill that routes real-world GTM goals to the right capability skill:

Skill	Domain	What your agent can do
cargo	Router	Overview of the whole skill set — the UUID flow between skills, async polling, end-to-end use cases, and common gotchas. Load it first.
cargo-gtm	Outcomes	Front door for GTM goals — sourcing, waterfall enrichment, email/phone/LinkedIn lookup, verification, scoring, qualification, CRM sync
cargo-orchestration	Runtime	Execute actions, run workflows, trigger batches, message AI agents, query runtime tables (runs/batches/spans/records) with SQL
cargo-storage	Schema	Manage models, datasets, columns, and relationships; query workspace storage with SQL
cargo-connection	Connectors	List, create, update, and remove connectors; discover integrations and their available actions
cargo-ai	Agents	Create and configure agents, manage releases, connect MCP servers, and handle agent memories
cargo-content	Knowledge	Upload and organize knowledge files, build native and connector-backed libraries for RAG
cargo-context	Context	Inspect and edit the git-backed context knowledge base and run commands in its sandbox
cargo-analytics	Measurement	Download workflow run results, export segment data, and monitor run metrics
cargo-billing	Costs	Pull usage metrics, check subscription status, view invoices, and manage credits
cargo-hosting	Hosting	Build, deploy, promote, and manage hosted apps (Vite SPAs) and edge workers
cargo-workspace-management	Admin	Invite and manage users, create and rotate API tokens, organize resources into folders, inspect roles

---

1. Install the CLI

Skills drive the CLI, so it has to be installed and authenticated first. Follow the Quickstart, then confirm:

cargo-ai whoami

2. Install the skills

npx skills add getcargohq/cargo-skills

This creates a .skills/ directory with the Cargo 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 available skills and what it can do with each.

---

Supported agents & editors

Any tool that follows the skills.sh standard works with the same install command — there’s no per-editor configuration, because .skills/ is the universal integration point.

Claude Code

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.

Cursor

Run the install command in your project root; Cursor’s agent picks up .skills/ automatically.

Codex CLI

Works out of the box once .skills/ is present in the working directory.

GitHub Copilot (agent mode)

Reads .skills/ from the repository root — commit it so Copilot loads it in every session.

Windsurf

Same one-command install; no additional configuration required.

Any skills.sh agent

Follows the open skills.sh standard, so new compatible editors work with the same command.

---

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

Examples

Worked examples: run tools, trigger plays, query the warehouse, build workflows, deploy agents, and more.

CLI Overview

Command reference, UUID flows, filter syntax, async patterns, and gotchas.

Cargo Skills on GitHub

Browse skill source, report issues, or contribute improvements.

skills.sh standard

Learn how skills work and how to author your own packages.