cargo-quickstart
Original:🇺🇸 English
Translated
Guided first-run demo for the Cargo CLI — from a fresh workspace to a real deliverable (25 leads matching the user's buyer persona, with a cost receipt) in under two minutes, ending by saving the demo as a recurring play. Use when the user is new to Cargo, asks for a demo/tour/quickstart, or has an empty workspace and wants to see what the CLI can do. For real GTM work beyond the demo, route to cargo-gtm.
19installs
Sourcegetcargohq/cargo-skills
Added on
NPX Install
npx skill4agent add getcargohq/cargo-skills cargo-quickstartTags
Translated version includes tags in frontmatterSKILL.md Content
View Translation Comparison →Cargo Quickstart — first value in two minutes
One guided demo: pull ~25 fresh leads matching a buyer persona the user picks, show the cost receipt, then save the pull as a recurring play. The point is not the list — it's that in minute 3 the user owns a running system, not a one-off result.
The one question
Ask exactly one question before doing anything:
"Who do you sell to?" (a persona in a few words — e.g. "Heads of RevOps at mid-market SaaS")
Everything else — provider, filters, limits — you decide. Don't ask about output format, volume, or providers; defaults below.
Speed budget — HARD RULES
The demo has a two-minute budget from answer to deliverable. On the fast path:
- No discovery detours. Do not run ,
cargo-ai --version,cargo-ai whoami, or any exploratory command first. Auth problems will surface as errors on the first real call — handle them then.connection connector list - One command block per step, no narration between commands.
- Paid work is capped at ~1 credit total. The demo uses the cheapest sourcing action in the catalog (, 0.02/record → 25 records ≈ 0.5 credits). Nothing else paid runs without asking.
salesNavigator.searchLeads - Never dead-end. Every step has a fallback (ladder below). If a rung fails, drop one rung silently and keep moving.
Fast path
Translate the persona into a filter (quote the exact title phrase in ; a bare keyword matches loosely and pollutes the page) and run:
searchLeadskeywordsbash
# 1. Execute — returns a run object; note run.uuid and run.workflowUuid.
# searchLeads returns a 25-row page minimum (limit below 25 still bills 25 × 0.02 = 0.5 credits).
cargo-ai orchestration action execute \
--action '{"kind":"connector","integrationSlug":"salesNavigator","actionSlug":"searchLeads","config":{}}' \
--data '{"keywords": "\"<persona title phrase>\"", "limit": 25}' \
--wait-until-finished > /tmp/quickstart-run.json
# 2. Fetch the output data (NOT in the execute stdout) — signed URL, then filter to THIS run
RUN_UUID=$(jq -r '.run.uuid' /tmp/quickstart-run.json)
WF_UUID=$(jq -r '.run.workflowUuid' /tmp/quickstart-run.json)
curl -s "$(cargo-ai orchestration run download-outputs \
--workflow-uuid "$WF_UUID" --output-node-slug action --format json | jq -r '.url')" \
> /tmp/quickstart-outputs.json
# 3. Show the table (the file holds ALL of the workflow's runs — filter by _uuid;
# each row's .output is the leads array directly, fields are snake_case)
jq -r --arg u "$RUN_UUID" \
'[.[] | select(._uuid==$u)][0].output[] | [.full_name, .job_title, .company_name, (.recently_hired // false)] | @tsv' \
/tmp/quickstart-outputs.json | head -25Show the table (name · title · company · recently-hired), not the raw JSON. rows are the demo's headline — lead with them ("6 of these 25 just started the job — the exact moment to reach out").
recently_hired: trueFallback ladder (on auth/error, drop a rung — don't stop)
- (0.02/record) — primary.
salesNavigator.searchLeads - (0.5) — reframe as "companies hiring your persona right now" (job postings for the persona's title). Same wow, different angle.
theirStack.searchJobs - (3/record) — exceeds the ~1-credit demo cap, so this rung asks first: "The two cheap sources aren't connected; I can pull 5 matches via waterfall for ~15 credits instead — run it, or connect Sales Navigator first (free)?" Run only on an explicit yes, with
waterfall.searchProspectscapped at 5.limit - Nothing connected at all → run the free path: , show what could be wired, and offer to connect one (browser auth) — the demo resumes after.
cargo-ai connection integration list | head
The receipt (mandatory, verbatim discipline)
The demo is itself the pilot from . Close it with a receipt:
../cargo-gtm/references/cost-discipline.md- Credits spent + balance remaining (— remaining =
cargo-ai billing subscription get).subscriptionAvailableCreditsCount − subscriptionCreditsUsedCount - Hit-rate: "25 of 25 returned" (or what actually came back, and which rows look off).
Minute 3 — save it as a play
Immediately offer to make the pull recurring — this is the step that shows what Cargo is:
"Want this to run by itself? I can save this exact search as a play that runs weekly and writes new matches into a model — newleads land without you asking."<persona>
On yes, follow with the demo's action + filter as the workflow body and a weekly cron.
../cargo-gtm/recipes/save-as-play.mdAfter the demo — route onward
Propose 2–3 next steps grounded in the rows just pulled, per the next-step spec in (§4): e.g. "enrich these 25 with firmographics (~0.5 cr each)", "find + verify emails for the best 10 (~1.4 cr each)", or something else entirely. From here, real GTM work belongs to — read it before anything beyond the demo.
../cargo-gtm/SKILL.mdcargo-gtm