Cartesia Skills

Cartesia Agent Skills

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 and is also a Claude Code plugin marketplace. Product skills live under skills/cartesia-api/ (HTTP/WebSocket + client libraries) and skills/line-voice-agent/ (Cartesia Line).

Install

Any agent (skills.sh)

npx skills add cartesia-ai/skills

Select cartesia-api and/or line-voice-agent 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.

Updating skills (Claude Code plugin)

You can update easily skills using the plugin. First update the cartesia marketplace:

/plugin marketplace update cartesia

Then update the plugin:

```text
/plugin update cartesia-skills

Finally, reload plugins to get the updated skills:

/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.
line-voice-agent	skills/line-voice-agent	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

.claude-plugin/
  marketplace.json   # Claude Code marketplace ("cartesia") vending the plugin
  plugin.json        # cartesia-skills plugin manifest (plugin root = repo root)
skills/
  cartesia-api/      # HTTP/WebSocket, SDKs, optional MCP
  line-voice-agent/  # Line SDK, CLI, telephony

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