Skills installed
Workflow generated
Workflow live
You’ll need Node.js 18+ and a SuprSend service token.
1
Install the skills
Run this in your project folder:The installer detects which agents you have (Cursor, Claude Code, Copilot, etc.), asks which to install into, and lets you choose where the files land.After install, skills are passive - nothing extra to run. Open your agent and start describing what you want.
- Project-scoped (recommended)
- Global
Committed to your repo, shared with your team. Recommended.
2
Generate a workflow with a single prompt
Open your agent (in Cursor, hit Your agent will say something like “I’ll use the suprsend-workflow-schema skill” and create a new file at
Cmd+L / Ctrl+L) and paste:suprsend/workflows/cart-abandonment/workflow.json containing valid workflow JSON - correct node_type values, a properly nested branch structure, and the exact field names the SuprSend schema expects.Sanity-check the outputOpen suprsend/workflows/cart-abandonment/workflow.json and verify:slugis set tocart-abandonment- A
delaynode sits before the delivery nodes - Each delivery node uses the correct
node_type(send_email,send_inbox, etc.) - Any
branch_waituntilconditions match your intent - agents are most likely to misfire here
3
Push it live
Confirm you’re pointed at the right workspace, then push:Open app.suprsend.com → Workflows. Your workflow is live.
Common gotchas
These are the mistakes agents (and humans) make most often.workflow push myfile.json fails with "failed to read workflow file"
workflow push myfile.json fails with "failed to read workflow file"
Why: The positional argument is a workflow slug, not a file path. The command reads
suprsend/workflows/<slug>/workflow.json.Fix: Pass the slug (suprsend workflow push cart-abandonment or --slug cart-abandonment), or point --dir at a directory with the <slug>/workflow.json layout (default suprsend/workflows/).Workflow pushed but nothing fires
Workflow pushed but nothing fires
Why: Pushed workflows are drafts by default.Fix: Add
--commit=true."Successfully pushed: 0"
"Successfully pushed: 0"
Why: Wrong active profile or workspace.Fix: Run
suprsend profile list and switch with suprsend profile use --name <name>.Workflow JSON can't be targeted by slug
Workflow JSON can't be targeted by slug
Why: The CLI takes the slug from the directory name,
suprsend/workflows/<slug>/workflow.json, not from a field in the file. A slug inside the JSON that differs from the directory is replaced by the directory name.Fix: Save the file as suprsend/workflows/your-slug/workflow.json.Validation error on push
Validation error on push
Why: Referenced schema or category doesn’t exist yet.Fix: Push schema and category first.
Branch logic routes wrong
Branch logic routes wrong
Why: Incorrect
expression_v1 conditions.Fix: Review by hand. See Wait Until.