Title: Wave Skills
Locale: en
URL: https://sensorswave.cn/en/docs/ai/wave-skills/
Description: Wave Skills for Cursor, Claude Code, and Codex, focused on tracking planning, SDK integration, and analytics workflows.
Wave Skills is a set of Sensors Wave-oriented Skills built on top of [MCP Setup](mcp.mdx). It does not replace MCP. Instead, it turns MCP's tool access into a more stable and practical working flow.

The current set includes one router, three tracking workflows, one analytics workflow, and one internal shared package:

- **wave**: router that dispatches requests based on the user's current stage
- **wave-tracking-plan**: tracking planning, event naming, server-side vs client-side decisions, and identify strategy
- **wave-tracking**: Tracking Plan write/publish flow, quality checks, and starter dashboards
- **wave-sdk-integration**: Pipeline setup, SDK initialization, identify / reset, and code integration
- **wave-analytics**: event analysis, funnel analysis, retention analysis, user lists, user sequences, and custom SQL
- **wave-tracking-shared**: internal prompts / policies / references used to keep execution rules small and reusable

The top-level `wave` skill acts as the router and dispatches requests to the right workflow based on user intent.

## When to use it

Wave Skills is useful if you regularly do the following in Cursor, Claude Code, or Codex:

- turn code, PRDs, or user flows into a tracking plan and event table
- create or update project assets such as Pipelines, Tracking Plans, and Dashboards
- follow a repeatable workflow for event, funnel, retention, or SQL analysis
- want answers that are closer to Sensors Wave conventions, tool sequencing, and delivery format

## How it relates to MCP

- **MCP** provides the low-level project, tracking, analytics, and dashboard tools
- **Wave Skills** defines when to call which tools, what to confirm first, and how to structure the output

In practice:

- MCP answers "what tools are available?"
- Wave Skills answers "how should a common task be carried out?"

## What It Includes

Wave Skills currently includes these main parts:

- **wave**: the top-level entry that routes you to the right workflow based on your current stage
- **wave-tracking-plan**: tracking planning, code discovery, and identify design
- **wave-tracking**: Tracking Plan write/publish flow, validation, and starter dashboards
- **wave-sdk-integration**: Pipeline setup, SDK initialization, identify / reset, and code integration
- **wave-analytics**: analysis model selection, query setup, and result interpretation

## Installation

The recommended path is GitHub-based `npx` installation:

```bash
# Install into the current project
npx github:sensorswave/agent-skills --project

# Install into the local tool directory
npx github:sensorswave/agent-skills --cursor
npx github:sensorswave/agent-skills --claude
npx github:sensorswave/agent-skills --codex
```

This defaults to copy-based installation, which works well on macOS, Linux, and Windows, and does not point your target `skills` directory at npm cache locations.

If you cloned the repository and want the target directory to stay symlinked and update with `git pull`, use the repository's `install.sh` instead:

```bash
git clone https://github.com/sensorswave/agent-skills.git
cd agent-skills
./install.sh --all
```

If you prefer manual setup, you can also symlink each Skill directory into the relevant tool's `skills` directory.

## Recommended setup order

Use this order:

1. Complete [MCP Setup](mcp.mdx)
2. Install Wave Skills
3. Ask for the task directly, such as "design a signup-to-paid tracking plan" or "analyze 7-day retention for users acquired in the last 30 days"

That way, the tools and the workflow are already in place, and you only need to describe the business problem.