Elevenlabs Upgrade Migration

What it does

When your agent uses it

• Upgrading the elevenlabs-js
• Elevenlabs Python SDK
• Migrating from v1 to v2 models
• Handling deprecations across the JS package rename and model ID changes

Example prompts

• “upgrade elevenlabs”
• “elevenlabs migration”
• “elevenlabs breaking changes”
• “/elevenlabs-upgrade-migration”

Requirements

• Python 3
• Node.js
• A credential in ELEVENLABS_API_KEY
• Compatibility (from SKILL.md): Designed for Claude Code
• Pre-approved tools (allowed-tools): Read, Write, Edit, Bash(npm:*), Bash(pip:*), Bash(git:*)

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

1. 1Check current versions — inspect installed Node/Python SDK versions and list
2. 2JS SDK package migration — uninstall the legacy community elevenlabs
3. 3Model migration — map deprecated model IDs to current generations using the
4. 4Voice settings migration — verify stability, similarity_boost, style,
5. 5API endpoint changes — confirm the stable /v1/ endpoints and adopt the
6. 6Python SDK upgrade — upgrade, pin the version in requirements.txt, and move
7. 7Validation — run tests plus a TTS smoke test and a voice-list check.

What it can do on your machine

Read from SKILL.md and the folder at commit cfae287. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Read
  • Write
  • Edit
  • Bash(npm:*)
  • Bash(pip:*)
  • Bash(git:*)

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • npm
  • git
  • curl

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Hosts in commands or code, which the agent is likely to contact:

  • api.elevenlabs.io

  Also links to:

  • elevenlabs.io
  • github.com
  • pypi.org

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • ELEVENLABS_API_KEY

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

• Compatibility

  Designed for Claude Code

  From compatibility in the SKILL.md frontmatter.

Context cost

Elevenlabs Upgrade Migration loads about 1.8k tokens when it runs, and up to ~4.2k if it reads all its reference files. Until then it costs about 110 tokens; SKILL.md has 643 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~110

When it runs · the whole SKILL.md, loaded when a task matches

~1.8k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~4.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jeremylongshore/tons-of-skills-marketplace at commit cfae287, republished under its MIT licence (© jeremylongshore). 643 words, ~1,795 tokens.

name

elevenlabs-upgrade-migration

description

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".

allowed-tools

Read, Write, Edit, Bash(npm:*), Bash(pip:*), Bash(git:*)

compatibility

Designed for Claude Code

version

1.6.0

license

MIT

author

Jeremy Longshore <jeremy@intentsolutions.io>

tags

saas, voice, ai, elevenlabs, migration, upgrade

npm uninstall elevenlabs
npm install @elevenlabs/elevenlabs-js
git checkout -b upgrade/elevenlabs-sdk

import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";
const client = new ElevenLabsClient({
  apiKey: process.env.ELEVENLABS_API_KEY,
  maxRetries: 3,
  timeoutInSeconds: 60,
});

git checkout -b upgrade/elevenlabs-sdk
npm uninstall elevenlabs && npm install @elevenlabs/elevenlabs-js
npm test
curl -s -o /dev/null -w "%{http_code}" \
  -X POST "https://api.elevenlabs.io/v1/text-to-speech/21m00Tcm4TlvDq8ikWAM" \
  -H "xi-api-key: ${ELEVENLABS_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"text":"Upgrade test.","model_id":"eleven_flash_v2_5"}'

© jeremylongshore, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in skills/.curated/elevenlabs-upgrade-migration of jeremylongshore/tons-of-skills-marketplace.

• SKILL.md
• references/examples.md
• references/migration-guide.md

Open the folder on GitHubat commit cfae287