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. Product skills live under skills/api/ (HTTP/WebSocket + client libraries) and skills/line/ (Cartesia Line).
npx skills add cartesia-ai/skillsSelect cartesia-api and/or line-voice-agent when prompted.
Docs: Agent skills on the Cartesia documentation site.
| Skill | Path | Use when |
|---|---|---|
| cartesia-api | skills/api |
Application code: REST/WebSocket, Sonic TTS, Ink STT, voices, SDKs, optional MCP. |
| line-voice-agent | skills/line |
Cartesia Line: CLI, cartesia deploy, VoiceAgentApp, telephony, multi-agent tools. |
| 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. |
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.
skills/
api/ # cartesia-api: HTTP/WebSocket, SDKs, optional MCP
line/ # line-voice-agent: Line SDK, CLI, telephony
Each area has a SKILL.md and optional references/. npx skills add matches the YAML name in that file (see table above), not the folder path.