Agent skill · software engineering · jeremylongshore
elevenlabs-upgrade-migration
Upgrade ElevenLabs SDK versions and migrate between API model generations. Use when upgrading the elevenlabs-js or elevenlabs Python SDK, migrating from v1 to v2 models, or handling deprecations across the JS package rename and model ID changes. Trigger with: "upgrade elevenlabs", "elevenlabs migration", "elevenlabs breaking changes", "update elevenlabs SDK", "migrate elevenlabs model", "eleven_v3 migration".
Why this skill is useful
Provides specific migration commands and domain knowledge for upgrading ElevenLabs SDK versions and handling API model changes that the AI wouldn't reliably generate on its own.
What it needs
Requires git, npm, pip installed locally. Requires elevenlabs account access. About 4k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
ElevenLabs Upgrade & Migration Overview Guide for upgrading the ElevenLabs SDK and migrating between model generations. Covers the JS SDK package rename (community elevenlabs → official @elevenlabs/elevenlabs-js), model ID changes across generations, voice-settings evolution, and API endpoint stability. Work the seven steps below at a high level from this file; drill into references/migration-guide.md for the full command set and per-step code, and references/examples.md for three end-to-end worked scenarios. Authentication All API calls authenticate with an account API key passed as the xi-api-key header. Store it in the ELEVENLABSAPIKEY environment variable — never inline a key in source. The SDK clients read the same value (process.env.ELEVENLABSAPIKEY in Node, apikey=... in Python). Prerequisites Current ElevenLabs SDK installed (Node or Python) ELEVENLABSAPIKEY exported in the environment Git for version control Test suite available Staging environment for validation Instructions The migration is a seven-step, branch-isolated workflow. Read package manifests and config with Read, apply import/model changes with Edit, add new config files (e.g. config/models.ts) with Write, and run the npm/pip/git commands via Bash. Full commands and code for each step are in references/migration-guide.md. 1. Check current versions — inspect installed Node/Python SDK versions and list the models your account can reach. 2. JS SDK package migration — uninstall the legacy community elevenlabs package, install @elevenlabs/elevenlabs-js, and update imports on an upgrade/elevenlabs-sdk branch. 3. Model migration — map deprecated model IDs to current generations using the migration table, and add a selectModel() helper that falls back off elevenv3 when WebSocket streaming is required. 4. Voice settings migration — verify stability, similarityboost, style, and speed against each model's capabilities. 5. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/elevenlabs-upgrade-migration--7ec0b9