rudderstack

🚀 Just launched RudderAI - the agentic layer for the entire customer data lifecycle

RudderStack Agent Skills

A Claude Code plugin marketplace and Agent Skills collection that teaches your AI coding agent how to drive every programmatic RudderStack surface — CLI, MCP server, Terraform, Profiles, and AI events — with the right preflight checks, commands, and recovery paths. Works with Claude Code, Cursor, and 40+ agents.

What's inside

One marketplace (rudder-agent-skills) bundling six plugins. Install the ones you use.

Most users drive RudderStack with more than one tool. Install rudder-core plus whichever tool plugins you use; the domain knowledge lives in rudder-core so it never duplicates across tool-specific plugins.

Installation

One command, any agent — no cloning, no local setup.

Any agent — Skills CLI (recommended)

The Skills CLI installs these skills into Claude Code, Cursor, Cline, OpenCode, and 40+ agents:

# Interactive — pick skills and your agent
npx skills add rudderlabs/rudder-agent-skills

# Or: list first · install everything globally · target one agent
npx skills add rudderlabs/rudder-agent-skills --list
npx skills add rudderlabs/rudder-agent-skills -g --all
npx skills add rudderlabs/rudder-agent-skills -a claude-code --skill rudder-cli-workflow

# Update anytime
npx skills update

Claude Code — plugin marketplace

/plugin marketplace add rudderlabs/rudder-agent-skills
/plugin install rudder-core@rudder-agent-skills      # then add whichever tool plugins you use

Non-interactive equivalent: claude plugin marketplace add rudderlabs/rudder-agent-skills then claude plugin install <plugin>@rudder-agent-skills. Update with /plugin marketplace update rudder-agent-skills.

To try a plugin from an unmerged branch, clone that branch and either start claude --plugin-dir ./rudder-agent-skills/plugins/<plugin> (this session only) or run claude plugin marketplace add ./rudder-agent-skills, then install as above.

Cursor

Add it straight from the cursor.directory listing with Add to Cursor, or use the Skills CLI:

npx skills add rudderlabs/rudder-agent-skills -a cursor

Manual symlink, git submodule, agent-specific paths, and troubleshooting live in docs/installation.md.

Available skills

rudder-core

Installed as a Claude Code or Cursor plugin, rudder-core also connects the RudderStack MCP server (https://mcp.rudderstack.com/mcp). The first time an MCP tool runs, your agent asks you to sign in to RudderStack in the browser. No token goes in a config file. The Skills CLI copies skill folders only, so after npx skills add, add the server yourself: in Claude Code, claude mcp add --scope user --transport http rudderstack https://mcp.rudderstack.com/mcp; in other agents, an HTTP MCP server with that URL.

rudder-cli

rudder-mcp

rudder-terraform

rudder-profiles

rudder-ai-events

How skills work together

flowchart TD
    plan["rudder-instrumentation-planning<br/>design the taxonomy"]
    plan --> catalog["rudder-data-catalog<br/>build the vocabulary"]
    plan --> evolve["rudder-import-and-evolve<br/>adopt existing resources"]
    plan --> plans["rudder-tracking-plans<br/>group events per source"]
    catalog --> cli["rudder-cli-workflow<br/>validate &rarr; dry-run &rarr; apply"]
    evolve --> cli
    plans --> cli
    cli --> typer["rudder-typer-workflow<br/>generate typed SDKs"]
    cli --> transform["rudder-transformations<br/>transform events"]
    cli --> debug["rudder-instrumentation-debugging<br/>fix validation issues"]

Directory structure

rudder-agent-skills/
├── README.md                  # this file
├── CONTRIBUTING.md            # authoring + PR guidelines
├── LICENSE
├── .claude-plugin/
│   └── marketplace.json       # the marketplace catalog
├── docs/
│   └── installation.md        # full install guide
├── examples/                  # end-to-end worked examples
└── plugins/
    └── <plugin>/              # rudder-core, rudder-cli, rudder-mcp, rudder-terraform, rudder-profiles, rudder-ai-events
        ├── .claude-plugin/plugin.json
        └── skills/
            └── <skill>/
                └── SKILL.md

Prerequisites

A compatible AI coding agent (Claude Code, Cursor, Cline, OpenCode, or any of the 40+ supported agents).

Each plugin includes a setup skill that guides you through installing and configuring tool-specific prerequisites:

After installing a plugin, run its setup skill to get started. Use /rudder-environment-check to verify your full setup.

Examples

examples/ contains worked end-to-end projects that demonstrate skills in action — the current example covers the transformations workflow.

Contributing

See CONTRIBUTING.md for authoring conventions, testing steps, and PR expectations.

License

MIT License — see LICENSE for details.