Skip to main content
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:
SkillDomainWhat your agent can do
cargoRouterOverview of the whole skill set — the UUID flow between skills, async polling, end-to-end use cases, and common gotchas. Load it first.
cargo-gtmOutcomesFront door for GTM goals — sourcing, waterfall enrichment, email/phone/LinkedIn lookup, verification, scoring, qualification, CRM sync
cargo-orchestrationRuntimeExecute actions, run workflows, trigger batches, message AI agents, query runtime tables (runs/batches/spans/records) with SQL
cargo-storageSchemaManage models, datasets, columns, and relationships; query workspace storage with SQL
cargo-connectionConnectorsList, create, update, and remove connectors; discover integrations and their available actions
cargo-aiAgentsCreate and configure agents, manage releases, connect MCP servers, and handle agent memories
cargo-contentKnowledgeUpload and organize knowledge files, build native and connector-backed libraries for RAG
cargo-contextContextInspect and edit the git-backed context knowledge base and run commands in its sandbox
cargo-analyticsMeasurementDownload workflow run results, export segment data, and monitor run metrics
cargo-billingCostsPull usage metrics, check subscription status, view invoices, and manage credits
cargo-hostingHostingBuild, deploy, promote, and manage hosted apps (Vite SPAs) and edge workers
cargo-workspace-managementAdminInvite 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

SymptomFix
Agent says it has no Cargo skillsRun npx skills add getcargohq/cargo-skills in the project root and restart the session
cargo-ai: command not foundRun npm install -g @cargo-ai/cli
Unauthorized errorsRun cargo-ai whoami to confirm the active token and workspace
Wrong workspace targetedRe-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.