> ## Documentation Index
> Fetch the complete documentation index at: https://docs.suprsend.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Install SuprSend Agent Skills and build your first workflow in under 5 minutes.

## Install Skills

Install all SuprSend skills at once:

```bash theme={"system"}
npx skills add suprsend/skills
```

The installer detects which agents are on your machine and asks which to install. Choose project-scoped (committed to your repo) or global.

Or install a single skill:

```bash theme={"system"}
npx skills add https://github.com/suprsend/skills --skill suprsend-workflow-schema
npx skills add https://github.com/suprsend/skills --skill suprsend-cli
npx skills add https://github.com/suprsend/skills --skill suprsend-docs-support
```

<Tip>
  Commit skills to your repo. Your whole team gets consistent agent behavior with no extra setup.
</Tip>

After installation, skills are passive — nothing extra to run. Open your agent, describe what you want to build, and the agent loads the relevant skill automatically.

***

## Try it — build a cart abandonment workflow

Open Cursor (`Cmd+L` / `Ctrl+L`) and paste this prompt:

```text theme={"system"}
Create a SuprSend cart abandonment workflow JSON
with slug "cart-abandonment". It should send 1 hour after user
leaves the cart and then send email and In-app notification.
```

The `suprsend-workflow-schema` skill activates automatically and generates correct `node_type` values, branch structure, and field names.

***

## Review and push

Open `suprsend/workflow/cart-abandonment.json` and verify the structure — especially any `branch_waituntil` conditions.

```bash theme={"system"}
suprsend profile list
suprsend profile use --name my-workspace   # if needed
suprsend workflow push --slug cart-abandonment --commit=true
```

Go to [app.suprsend.com](https://app.suprsend.com) → **Workflows**. Your workflow is live.

***

## Common gotchas

These are the mistakes agents make most often. Watch for these before pushing.

| What goes wrong                               | Why                                                  | Fix                                                                               |
| --------------------------------------------- | ---------------------------------------------------- | --------------------------------------------------------------------------------- |
| `workflow push myfile.json` silently pushes 0 | Command expects `--slug` or `--dir`, not a file path | Use `--slug` or `--dir suprsend/workflow/`                                        |
| Workflow pushed but nothing fires             | Pushed workflows are **drafts by default**           | Add `--commit=true`                                                               |
| "Successfully pushed: 0"                      | Wrong active profile or workspace                    | Run `suprsend profile list` and switch                                            |
| Workflow JSON can't be targeted by slug       | Missing `slug` field in the JSON                     | Always include `"slug": "your-slug"`                                              |
| Validation error on push                      | Schema or category doesn't exist yet                 | Push schema and category first                                                    |
| Branch logic routes wrong                     | Incorrect `expression_v1` conditions                 | Review conditions. See [Wait Until](https://docs.suprsend.com/docs/wait-until.md) |

***

## Next steps

<CardGroup cols={2}>
  <Card title="Workflow Schema Skill" icon="diagram-project" href="/reference/agent-skill-workflow-schema">
    All node types and configuration fields.
  </Card>

  <Card title="CLI Skill" icon="terminal" href="/reference/agent-skill-cli">
    Every CLI command, flag, and troubleshooting tip.
  </Card>

  <Card title="Prompt Cheatsheet" icon="clipboard-list" href="/reference/mcp-prompts">
    More copy-paste prompts for common tasks.
  </Card>

  <Card title="Agent Skills Overview" icon="graduation-cap" href="/reference/agent-skills">
    All available skills and how they work.
  </Card>
</CardGroup>