cargo-context

SKILL.md

Cargo CLI — Context

The context is a git-backed repository of typed markdown/MDX files that captures a workspace's GTM knowledge (company narrative, ICPs, personas, plays, proof, objections, etc.) and is read/written by both humans and agents. The cargo-ai context domain has two subdomains you'll use:

runtime — browse, read, write, edit, and execute against the workspace's runtime sandbox (a checked-out copy of the context repo). write/edit are pushed to the default branch; execute runs are not pushed.

graph — build/load the knowledge graph derived from every markdown/MDX file in the context repo.

The canonical example of a context repository is getcargohq/cargo-workspaces. Read its README.md to understand the domain layout and file conventions before writing new entries.
For uploading runtime-independent files (CSVs, PDFs) used in batch runs, use cargo-workspace-management (cargo-ai workspaceManagement file upload) instead.
For RAG file attachments to agents, use cargo-ai (cargo-ai content file upload).

See references/conventions.md for the full context repo structure and per-domain templates.
See references/response-shapes.md for the JSON shapes returned by each cargo-ai context command.
See references/troubleshooting.md for common errors and how to fix them.
See references/examples/authoring.md for end-to-end add / edit / delete recipes.
See references/examples/lifecycle.md for the bootstrap + refresh-from-calls playbook.
See references/examples/graph-queries.md for inspecting the knowledge graph.

Prerequisites