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

# AI Coding Skills

> Optional AI assistant skills that help generate correct Rise SDK code. Choose your agent, then add skills with one command.

## What are AI coding skills?

**Skills** are instructions that AI coding assistants (Claude Code, Cursor, Windsurf, Codex, etc.) use to generate better, more accurate code. They describe when to use which APIs, how to structure requests, and what to avoid—so the assistant behaves like someone who already knows the Rise SDK.

Rise ships **optional** skills for its SDK. If you add them to your project, your assistant gets Rise-specific guidance (payments, teams, webhooks, auth, and more). You don’t have to use them; if you do, you don’t need to read or edit any skill files—your tool loads them automatically.

For the general format and how skills work across tools, see the [Agent Skills specification](https://agentskills.io/specification) and [Agent Skills documentation](https://agentskills.io).

## Choose your agent

Skills work with these agents. When you add skills, you’ll pass the one you use:

| Agent ID   | Tool        |
| ---------- | ----------- |
| `claude`   | Claude Code |
| `cursor`   | Cursor      |
| `windsurf` | Windsurf    |
| `codex`    | Codex       |

If you use a different AI coding tool, you can still add skills manually (see below).

## How to add skills

From your project root (with `@riseworks/riseworks-sdk` installed), run:

```bash theme={null}
# Add all skills to your agent (replace <agent> with claude, cursor, windsurf, or codex)
npx @riseworks/riseworks-sdk add-skills --agent <agent>

# Or add all skills to every supported agent
npx @riseworks/riseworks-sdk add-skills

# Add only specific skills to one agent
npx @riseworks/riseworks-sdk add-skills --agent cursor rise-sdk-integration rise-webhooks

# See available agents and skills
npx @riseworks/riseworks-sdk add-skills --list
```

Restart or refresh your AI tool after adding skills so it picks them up.

**Using another agent?** Copy the contents of `node_modules/@riseworks/riseworks-sdk/ai-skills/` into your tool’s skills (or rules) folder, then restart the tool.

## Available skills

| Skill                           | When to use it                                                                                       |
| ------------------------------- | ---------------------------------------------------------------------------------------------------- |
| **rise-sdk-integration**        | General Rise SDK usage—teams, payments, invites, balances, webhooks. Add this to every Rise project. |
| **rise-payments-workflows**     | Payments, bill pay, balances, withdrawals, payroll lookups.                                          |
| **rise-webhooks**               | Webhook validation, event handling, and receiving endpoints.                                         |
| **rise-teams-and-invites**      | Teams, members, invites, organizations.                                                              |
| **rise-auth-and-setup**         | Authentication, JWT vs Rise ID, environment setup.                                                   |
| **rise-v1-migration**           | Migrating from the legacy V1 API to B2B.                                                             |
| **rise-debugging-and-errors**   | Troubleshooting auth, payloads, and webhook issues.                                                  |
| **rise-security-and-approvals** | Server-side secrets, approval flows, and safe patterns.                                              |

**Suggested approach:** Add `rise-sdk-integration` first. Add the others only if you’re actively working in those areas (e.g. `rise-v1-migration` when migrating from V1).

## Documentation

For full API and SDK details, see the rest of this documentation and the [Rise B2B API docs](https://v2-docs.riseworks.io/).