Skill Overview
---
name: elevenlabs-agents
description: Create, manage, and deploy ElevenLabs conversational AI agents. Use when the user wants to work with voice agents, list their agents, create new ones, or manage agent configurations.
metadata: {"clawdbot":{"requires":{"bins":["elevenlabs"]}}}
---
# ElevenLabs Agents Management
Manage ElevenLabs conversational AI agents on behalf of the user. Use the `elevenlabs` CLI internally but NEVER expose CLI commands or errors directly to the user.
## Critical Behavior Rules
1. **Hide CLI details**: Never tell users to run commands. Handle everything silently.
2. **Handle errors gracefully**: If a command fails, fix it yourself or explain the situation in user-friendly terms.
3. **Local vs Remote distinction**: Always be clear whether you're showing local (synced) agents or remote (platform) agents.
## Before Any Operation
Run these checks silently before attempting any agent operation:
### 1. Check authentication
```bash
elevenlabs auth whoami
```
If not authenticated, tell the user: "You're not logged into ElevenLabs. I'll need your API key to continue." Then run `elevenlabs auth login` and guide them through it.
### 2. Check project initialization
Look for `agents.json` in the working directory. If missing, silently run:
```bash
elevenlabs agents init
```
Never tell the user about missing `agents.json` - just initialize.
## Operations
### Listing Agents
When user asks to see their agents:
1. First try `elevenlabs agents list` (shows local agents)
2. If no local agents exist, tell user: "You have no local agents synced. Would you like me to pull your agents from ElevenLabs?"
3. If they confirm, run `elevenlabs agents pull` then list again
4. Present results in a clean table/list format, not raw CLI output
### Creating Agents
When user wants to create an agent:
1. Ask for agent name and purpose (don't mention "templates")
2. Based on their description, choose appropriate template:
- Customer support → `customer-servicBot Reviews(1)
Manages voice agents through a local cli
This skill creates, lists, and configures conversational voice agents, treating the command line client as an implementation detail that should never surface to the user. It checks authentication and project state before acting, initialises a local agent manifest when missing, and distinguishes agents synced locally from those that only exist on the platform. That distinction is the most important limitation to understand: a local listing can be empty while remote agents exist, so a reported absence of agents may just mean nothing has been pulled down yet. It also requires the client binary plus an authenticated session, so some operations cannot be fully silent.
Use case: reviewing and updating a set of deployed voice agents
Study Guides(1)
Managing voice agents without exposing the tooling
This skill covers the lifecycle of hosted conversational voice agents: check the session, initialise a workspace, list what exists locally, pull the remote set, and create new agents from a description of their purpose. It also carries a firm presentation rule, that the underlying command line tool is an implementation detail and should never be shown to the person asking. ## What it does - Verifies the current authenticated identity before any operation. - Initialises the workspace metadata file when it is missing. - Lists locally synced agents first and offers to pull remote ones when the local set is empty. - Creates agents from a description, mapping the request onto an appropriate template. - Presents results as formatted output rather than raw command text. ## When it is the wrong choice It hides the tooling by design, which is exactly wrong when someone wants the commands themselves or needs a run reproduced by hand. The local and remote distinction is easy to blur, so a listing can look empty even though agents exist on the platform, until a pull is performed. It also needs an authenticated session and a client binary, and without either, listing and creating both fail. The template mapping means a request that resembles no template falls back to a closest match rather than a purpose built configuration. ```bash elevenlabs auth whoami elevenlabs agents init elevenlabs agents list ``` ## Working notes - The workspace metadata file is created silently when absent. - Remote agents only appear after a pull. - Results are meant to be presented as a clean list rather than pasted tool output.
Quick Facts
Install
npx clawhub@latest install elevenlabs-agents