mirror of
https://github.com/getcargohq/cargo-skills.git
synced 2026-09-14 19:17:15 +08:00
replicas-connector[bot]
5680754126
mcp.getcargo.io/mcp is live and serves thirteen platform tools plus whatever a workspace published with defineMcpServer. Nothing in the bundle covered it, and cargo/SKILL.md asserted "There is no first-party 'Cargo MCP server'" - true when written, wrong now, and the one claim an agent would act on. - cargo-mcp/SKILL.md (1.0.0): connect, the discover to price to execute to poll spine, and the routing table for MCP tool vs cargo-ai. - cargo/SKILL.md (1.22.0): the MCP section becomes a three-way disambiguation. Hosted server, workspace server served over stdio by cargo-ai mcp, and an MCP client attached to a Cargo agent are three things sharing a name and sharing no answers. - evals/routing.jsonl: "How do I use Cargo from ChatGPT?" now expects cargo-mcp; three cases added for the new surface. - Counts, catalogs, plugin manifests, SKILL_DIRS, llms.txt, metadata. skills-lint, routing-eval, sync-trigger-slugs and the cargo-gtm script fixtures all pass. Co-authored-by: Cargo FSD <fsd@getcargo.io> Co-authored-by: Auree Aubert <16732193+aureeaubert@users.noreply.github.com> Co-authored-by: replicas-connector[bot] <replicas-connector[bot]@users.noreply.github.com>
22 lines
1.4 KiB
Markdown
22 lines
1.4 KiB
Markdown
# Cargo skills — agent guide
|
|
|
|
The router skill at [`cargo/SKILL.md`](cargo/SKILL.md) is the canonical entry point for working with this skillpack. It explains the nineteen skills (the `cargo` router + one onboarding skill `cargo-quickstart` + one outcome skill `cargo-gtm` + sixteen capability skills), the UUID flow between them, async polling, end-to-end use cases, and common gotchas.
|
|
|
|
The term reference lives in [`cargo/references/glossary.md`](cargo/references/glossary.md).
|
|
|
|
Both files are installed as part of the `cargo` skill via `npx skills add getcargohq/cargo-skills`, so the same content is available after install at `~/.claude/skills/cargo/`.
|
|
|
|
## Working in this repo
|
|
|
|
Before opening a PR, run the checks CI runs:
|
|
|
|
```bash
|
|
node .github/scripts/skills-lint.mjs . # frontmatter, links, JSON blocks, bootstrap, counts
|
|
node .github/scripts/skills-metadata.mjs --write . # regenerate skill-metadata.json content hashes
|
|
node .github/scripts/generate-llms-txt.ts # regenerate the machine-readable index
|
|
node .github/scripts/sync-trigger-slugs.ts --check # integration/provider names in descriptions
|
|
node .github/scripts/routing-eval.ts # description routing regressions
|
|
```
|
|
|
|
Contribution conventions — including the four-part description template every skill's `description` must follow — are in [`CONTRIBUTING.md`](CONTRIBUTING.md).
|