Agent skill

Setup API Key

by elevenlabs in elevenlabs/skills

Guides users through setting up an ElevenLabs API key for REST API and SDK workflows.

MITAuto-check: notesMedia & Creative

Install Setup API Key

skills CLI
$ npx skills add elevenlabs/skills --skill setup-api-key -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install elevenlabs/skills setup-api-key --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/elevenlabs/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/setup-api-key .claude/skills/setup-api-key && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
setup-api-key
GitHub stars
482
Token cost
~954 tokens
SKILL.md length
499 words
Files
1
Skills in repo
8
Repo updated
First seen
Licence
MIT

At a glance

Guides users through setting up an ElevenLabs API key for REST API and SDK workflows.

  • Works in 3 steps: Check for an existing API key first → Request the API key → Validate and configure
  • The user needs to configure an ElevenLabs API key
  • SKILL.md covers Workflow and Safety Rules
  • Reaches api.elevenlabs.io; needs ELEVENLABS_API_KEY

What it does

Setup API Key is an agent skill from elevenlabs/skills. Guides users through setting up an ElevenLabs API key for REST API and SDK workflows. Use when the user needs to configure an ElevenLabs API key or when an API or SDK request fails because a key is missing. First checks whether ELEVENLABSAPIKEY is already configured and valid, and only runs full setup when needed.

Its SKILL.md is about 950 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Requires internet access to elevenlabs.io and api.elevenlabs.io.

It sits in Media & Creative, covering Text to speech and voice and REST APIs. It works with ElevenLabs. The repository describes itself as: Collections of skills for building with ElevenLabs. The licence is MIT.

When your agent uses it

  • The user needs to configure an ElevenLabs API key
  • SDK request fails because a key is missing

Example prompts

  • “Use the setup-api-key skill to guide users through setting up an ElevenLabs API key for REST API and SDK workflows”
  • “/setup-api-key”

Requirements

  • A credential in ELEVENLABS_API_KEY
  • Compatibility (from SKILL.md): Requires internet access to elevenlabs.io and api.elevenlabs.io.

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Check for an existing API key first
  2. Request the API key
  3. Validate and configure

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    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

    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

    Requires internet access to elevenlabs.io and api.elevenlabs.io.

    From compatibility in the SKILL.md frontmatter.

Context cost

Setup API Key loads about 954 tokens when it runs. Until then it costs about 83 tokens; SKILL.md has 499 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~83
When it runs · the whole SKILL.md, loaded when a task matches
~954

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

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:19
    if it is not in the environment, check `.env` for `ELEVENLABS_API_KEY=<value>`.
  • NoteMentions a .env fileSKILL.md:49
    Instead, copy/paste it into your local `.env` file:
  • NoteMentions a .env fileSKILL.md:55
    > If `.env` already has an `ELEVENLABS_API_KEY=...` line, replace that line.
  • NoteMentions a .env fileSKILL.md:64
    1. Re-check both `.env` and the current environment for `ELEVENLABS_API_KEY`, but treat `.env` as the source of truth fo
  • NoteMentions a .env fileSKILL.md:65
    2. If `.env` contains a value, validate that value even when the current environment also has a different `ELEVENLABS_AP
  • NoteMentions a .env fileSKILL.md:66
    3. If `.env` does not contain the key:
  • NoteMentions a .env fileSKILL.md:67
    - Tell the user `.env` does not appear to contain `ELEVENLABS_API_KEY`.
  • NoteMentions a .env fileSKILL.md:69
    s step still requires saving the key in `.env`.
  • NoteMentions a .env fileSKILL.md:71
    4. If a `.env` key is found, validate it:
  • NoteMentions a .env fileSKILL.md:79
    - Ask them to replace the `.env` value and tell you when it is saved.

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 elevenlabs/skills at commit 1d08a4a, republished under its MIT licence (© elevenlabs). 499 words, ~954 tokens.

Download SKILL.mdSave it as .claude/skills/setup-api-key/SKILL.md (or your agent's skills folder).
name
setup-api-key
description
Guides users through setting up an ElevenLabs API key for REST API and SDK workflows. Use when the user needs to configure an ElevenLabs API key or when an API or SDK request fails because a key is missing. First checks whether ELEVENLABS_API_KEY is already configured and valid, and only runs full setup when needed.
compatibility
Requires internet access to elevenlabs.io and api.elevenlabs.io.
license
MIT

ElevenLabs API Key Setup

Guide the user through obtaining and configuring an ElevenLabs API key.

Workflow

Step 0: Check for an existing API key first

Before asking the user for a key, check for an existing ELEVENLABS_API_KEY:

  1. Check whether ELEVENLABS_API_KEY exists in the current environment. If it does, use that value for this initial check.
  2. Only if it is not in the environment, check .env for ELEVENLABS_API_KEY=<value>.
  3. Do not print, quote, or repeat the key. If you mention it, redact it.
  4. If an existing key is found, validate it:
    text
    GET https://api.elevenlabs.io/v1/user
    Header: xi-api-key: <existing-api-key>
  5. If existing key validation succeeds:
    • Tell the user ElevenLabs is already configured and working
    • Skip the setup flow
    • Ask whether they want to replace/rotate the key; if not, stop
  6. If existing key validation fails:
    • Tell the user the existing key appears invalid or expired
    • Continue to Step 1
Step 1: Request the API key

Tell the user:

To set up ElevenLabs, open the API keys page: https://elevenlabs.io/app/settings/api-keys

(Need an account? Create one at https://elevenlabs.io/app/sign-up first)

If you don't have an API key yet:

  1. Click "Create key"
  2. Name it (or use the default)
  3. Set permission for your key. If you provide a key with "User" permission set to "Read" this skill will automatically verify if your key works
  4. Click "Create key" to confirm
  5. Copy the key immediately - it's only shown once!

Do not paste the key into this chat. Instead, copy/paste it into your local .env file:

ELEVENLABS_API_KEY=your-api-key

If .env already has an ELEVENLABS_API_KEY=... line, replace that line. Tell me when you've saved it, without sharing the key.

Then wait for the user to confirm that the key is saved locally.

Show full SKILL.md (225 more words)Show less
Step 2: Validate and configure

After the user says the key is saved:

  1. Re-check both .env and the current environment for ELEVENLABS_API_KEY, but treat .env as the source of truth for this step.
  2. If .env contains a value, validate that value even when the current environment also has a different ELEVENLABS_API_KEY.
  3. If .env does not contain the key:
    • Tell the user .env does not appear to contain ELEVENLABS_API_KEY.
    • Show the expected line again.
    • If the current environment does contain a key, note that this step still requires saving the key in .env.
    • Remind them not to paste the key into chat.
  4. If a .env key is found, validate it:
    text
    GET https://api.elevenlabs.io/v1/user
    Header: xi-api-key: <local-api-key>
  5. If validation fails:
    • Tell the user the local key appears invalid or expired.
    • Remind them of the API keys page.
    • Ask them to replace the .env value and tell you when it is saved.
  6. If validation succeeds, confirm:

    Done. ElevenLabs is configured and the key in .env works.

Safety Rules

  • Never ask the user to paste an API key, token, or secret into chat.
  • Never print or echo API key values from environment variables or .env.
  • Prefer .env or managed secrets over shell history for persistent local configuration.
  • For browser or client-side apps, keep ELEVENLABS_API_KEY on the server and issue short-lived tokens where applicable.

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

Files

Just SKILL.md in setup-api-key of elevenlabs/skills.

Open the folder on GitHubat commit 1d08a4a

Compare with similar skills

Setup API Key next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Setup API Key compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Setup API Key this skillelevenlabs/skills482—~954Automated safety check: NotesMIT
Fish Audio APIwaker240/FullVideoProductionSkill199—~1.1kAutomated safety check: NotesApache-2.0
Elevenlabs Deploy Integrationjeremylongshore/tons-of-skills-marketplace2.8k—~1.4kAutomated safety check: PassMIT
Elevenlabs Performance Tuningjeremylongshore/tons-of-skills-marketplace2.8k—~2kAutomated safety check: PassMIT
Musictadaspetra/loop2962 repos~827Automated safety check: PassMIT
ElevenLabs Voiceover Generatordigitalsamba/claude-code-video-toolkit2.2k1 repos~2.7kAutomated safety check: NotesMIT

Similar skills

  • Fish Audio API

    waker240/FullVideoProductionSkill

    Generate narration with the public Fish Audio REST API using environment credentials and a user-selected voice.

    199 GitHub stars~1.1k tokensUpdated 12 days ago
    Media & CreativeAuto-check: notes
  • Elevenlabs Deploy Integration

    jeremylongshore/tons-of-skills-marketplace

    Deploy ElevenLabs TTS applications to Vercel, Fly.io, and Cloud Run.

    2.8k GitHub stars~1.4k tokensUpdated today
    Media & CreativeAuto-check passed
  • Elevenlabs Performance Tuning

    jeremylongshore/tons-of-skills-marketplace

    Optimize ElevenLabs TTS latency with model selection, streaming, caching, and audio format tuning.

    2.8k GitHub stars~2k tokensUpdated today
    Media & CreativeAuto-check passed
  • Music

    tadaspetra/loop

    Generate music using ElevenLabs Music API. An agent skill from tadaspetra/loop.

    296 GitHub starsUsed in 2 repos~827 tokens
    Media & CreativeAuto-check passed
  • ElevenLabs Voiceover Generator

    digitalsamba/claude-code-video-toolkit

    Generates narration, sound effects and cloned voices through the ElevenLabs API, with model and setting choices tuned to the content's style.

    2.2k GitHub starsUsed in 1 repo~2.7k tokens
    Media & CreativeAuto-check: notes
  • AI SDK Development

    trypostit/trypost

    TRIGGER when working with ai-sdk which is Laravel official first-party AI SDK.

    685 GitHub starsUsed in 1 repo~3.5k tokens
    AI & LLM EngineeringAuto-check passed

More from elevenlabs/skills

All 8 skills in this repo
  • Dubbing

    elevenlabs/skills

    Dub audio and video into other languages using the ElevenLabs Dubbing API (dubbingv2), preserving the original speakers' voices.

    482 GitHub stars~3.3k tokensUpdated today
    Auto-check passed
  • Text To Speech

    elevenlabs/skills

    Convert text to speech using ElevenLabs voice AI. An agent skill from elevenlabs/skills.

    482 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Voice Changer

    elevenlabs/skills

    Transform the voice in an audio recording into a different target voice while preserving emotion, timing, and delivery using the ElevenLabs Voice Changer (speech-to-speech) API.

    482 GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Voice Isolator

    elevenlabs/skills

    Remove background noise and isolate vocals/speech from audio using ElevenLabs Voice Isolator (audio isolation) API.

    482 GitHub stars~923 tokensUpdated today
    Auto-check passed
  • Speech Engine

    elevenlabs/skills

    Add real-time voice conversations to a custom agent runtime with ElevenLabs Speech Engine.

    482 GitHub stars~2.5k tokensUpdated today
    Auto-check: warnings
  • Agents

    elevenlabs/skills

    Build voice AI agents with ElevenLabs. An agent skill from elevenlabs/skills.

    482 GitHub stars~6.5k tokensUpdated today
    Auto-check passed

Works with

Questions about Setup API Key

What does Setup API Key do?

Guides users through setting up an ElevenLabs API key for REST API and SDK workflows. Setup API Key is an agent skill from elevenlabs/skills. Guides users through setting up an ElevenLabs API key for REST API and SDK workflows.

When should I use Setup API Key?

Setup API Key fits situations like: the user needs to configure an ElevenLabs API key; SDK request fails because a key is missing.

How do I install Setup API Key in Claude Code?

Run `npx skills add elevenlabs/skills --skill setup-api-key -a claude-code`. Or copy the skill folder (setup-api-key in elevenlabs/skills) into .claude/skills/setup-api-key in your project. Claude Code loads it when a task matches its description.

How do I install Setup API Key in Codex?

Run `npx skills add elevenlabs/skills --skill setup-api-key -a codex`. Or copy the skill folder (setup-api-key in elevenlabs/skills) into .agents/skills/setup-api-key in your project. Codex loads it when a task matches its description.

Can I use Setup API Key in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add elevenlabs/skills --skill setup-api-key -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/setup-api-key, .gemini/skills/setup-api-key, .github/skills/setup-api-key and .opencode/skills/setup-api-key in your project.

What does Setup API Key need to run?

Going by SKILL.md and its folder, Setup API Key needs credentials named ELEVENLABS_API_KEY. Our summary lists: A credential in ELEVENLABS_API_KEY. Compatibility (from SKILL.md): Requires internet access to elevenlabs.io and api.elevenlabs.io..

Does Setup API Key access the network?

SKILL.md names 2 domains. In commands or code: api.elevenlabs.io; the agent is likely to contact it when it follows the instructions. As links in the text: elevenlabs.io. This is read from the text; nothing was executed.

Is Setup API Key safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Setup API Key use?

Setup API Key is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Setup API Key use?

About 954 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Setup API Key?

Skills that share tags, products or a category with Setup API Key: Fish Audio API (waker240/FullVideoProductionSkill, 199 stars), Elevenlabs Deploy Integration (jeremylongshore/tons-of-skills-marketplace, 2.8k stars), Elevenlabs Performance Tuning (jeremylongshore/tons-of-skills-marketplace, 2.8k stars) and Music (tadaspetra/loop, 296 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Setup API Key?

elevenlabs (a GitHub organization) maintains it in elevenlabs/skills, which has 482 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 9, 2026.

Source: elevenlabs/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.