Cartesia Agent Skills

Install via skills.sh

Agent Skills help coding agents ship Cartesia integrations the way we document them: auth, Cartesia-Version, and when to use Line vs raw APIs. Each skill is a versioned SKILL.md (plus optional references/). Contracts live on docs.cartesia.ai; use the Python and JS/TS SDKs in app code and optional MCP in the IDE if you want it.

This repository follows the Agent Skills convention. It is a Claude Code plugin marketplace and a Cursor plugin (name: cartesia). Product skills live under skills/cartesia-api/ (HTTP/WebSocket + client libraries) and skills/cartesia-line/ (Cartesia Line).

Install

Any agent (skills.sh)

npx skills add cartesia-ai/skills

Select cartesia-api and/or cartesia-line when prompted.

Claude Code (plugin)

Inside Claude Code, add this repo as a marketplace:

/plugin marketplace add cartesia-ai/skills

Then, install the cartesia-skills plugin:

/plugin install cartesia-skills@cartesia

The plugin vends all skills in this repo.

Cursor (plugin)

In Cursor chat:

/add-plugin cartesia

Or install from the Cursor Marketplace (after listing). The plugin registers hosted MCP at https://mcp.cartesia.ai/mcp (sign in via the Playground) and loads the skills, rule, and /build-voice-agent command in this repo.

Local test before the marketplace listing:

ln -s /path/to/skills ~/.cursor/plugins/local/cartesia

Then reload the Cursor window. Pasting https://cartesia.ai shows Add Cartesia / Try in Chat only after Cursor lists the plugin and maps Cartesia domains.

Updating the Claude Code plugin

Update the cartesia marketplace:

/plugin marketplace update cartesia

Then update the plugin:

/plugin update cartesia-skills

Reload plugins:

/reload-plugins

Available skills

Skill	Path	Use when
cartesia-api	`skills/cartesia-api`	Application code: REST/WebSocket, Sonic TTS, Ink STT, voices, SDKs, optional MCP.
cartesia-line	`skills/cartesia-line`	Cartesia Line: CLI, `cartesia deploy`, `VoiceAgentApp`, telephony, multi-agent tools.

Where to look (for LLMs and humans)

Surface	Role
This repo	Curated `SKILL.md` copy and cross-links (docs + OpenAPI stay the contract).
docs.cartesia.ai	Full API reference, guides, OpenAPI/AsyncAPI.
llms.txt / llms-full.txt	Machine-readable doc indexes for RAG and fetches.
SDKs	Python, JS/TS for production integrations.
MCP	Optional IDE tooling; not a substitute for SDKs in apps.

Configuration (Line)

Voice agents on Cartesia Line need a Cartesia key and at least one LLM provider key:

export ANTHROPIC_API_KEY="your-anthropic-key"  # or OPENAI_API_KEY, GEMINI_API_KEY, etc.

Cartesia API keys: play.cartesia.ai/keys.

Repository layout

.cursor-plugin/plugin.json   # Cursor Marketplace plugin (name: cartesia)
.claude-plugin/
  marketplace.json           # Claude Code marketplace ("cartesia")
  plugin.json                # cartesia-skills plugin
.mcp.json                    # hosted MCP (https://mcp.cartesia.ai/mcp)
plugin.json                  # Agent Plugins manifest
commands/build-voice-agent.md
rules/cartesia.mdc
skills/
  cartesia-api/              # HTTP/WebSocket, SDKs, optional MCP
  cartesia-line/             # Line SDK, CLI, telephony

Each skill folder has a SKILL.md (whose YAML name matches the folder) and optional references/.