pp-elevenlabs

What this skill does

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/ai/elevenlabs/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

# Elevenlabs — Printing Press CLI

## Prerequisites: Install the CLI

This skill drives the `elevenlabs-pp-cli` binary. **You must verify the CLI is installed before invoking any command from this skill.** If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to `$HOME/.local/bin` on macOS/Linux and `%LOCALAPPDATA%\Programs\PrintingPress\bin` on Windows:
   ```bash
   npx -y @mvanhorn/printing-press-library install elevenlabs --cli-only
   ```
2. Verify: `elevenlabs-pp-cli --version`
3. Ensure the reported install directory is on `$PATH` for the agent/runtime that will invoke this skill.

If the `npx` install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.3 or newer):

```bash
go install github.com/mvanhorn/printing-press-library/library/ai/elevenlabs/cmd/elevenlabs-pp-cli@latest
```

If `--version` reports "command not found" after install, the runtime cannot see the binary directory on `$PATH`. Do not proceed with skill commands until verification succeeds.

## Unique Capabilities

These capabilities aren't available in any other tool for this API.

### Agent audio planning
- **`voice discover`** — Search owned and shared ElevenLabs voices through one compact, JSON-first command.

  _Agents can pick a voice before generation without paging through incompatible raw endpoints._

  ```bash
  elevenlabs-pp-cli voice discover --source all --limit 5 --agent
  ```
- **`tts resolve`** — Resolve a voice, model, output format, default settings, and subscription context before rendering.

  _Agents can validate generation choices cheaply before spending quota on audio._

  ```bash
  elevenlabs-pp-cli tts resolve --voice JBFqnCBsd6RMkjVDRZzb --model auto --agent
  ```

### Audio artifact workflows
- **`tts render`** — Render text to an audio file and print a structured manifest with file path, byte count, model, and voice.

  _Agents get a durable audio artifact plus machine-readable metadata in one step._

  ```bash
  elevenlabs-pp-cli tts render --voice JBFqnCBsd6RMkjVDRZzb --text 'Hello from ElevenLabs.' --out hello.mp3 --agent
  ```
- **`dialogue cast`** — Render speaker-labelled dialogue lines by resolving speaker-to-voice assignments and saving audio.

  _Agents can generate multi-speaker dialogue from scripts without manually constructing JSON voice-id payloads._

  ```bash
  elevenlabs-pp-cli dialogue cast --line narrator='Welcome.' --cast narrator=JBFqnCBsd6RMkjVDRZzb --out dialogue.mp3 --agent
  ```

## Command Reference

**audio-isolation** — Manage audio isolation

- `elevenlabs-pp-cli audio-isolation audio_isolation` — Removes background noise from audio
- `elevenlabs-pp-cli audio-isolation delete-history-item` — Deletes a specific audio isolation history item and the associated media files.
- `elevenlabs-pp-cli audio-isolation get-history` — Returns a list of all your audio isolation generations.
- `elevenlabs-pp-cli audio-isolation stream` — Removes background noise from audio and streams the result

**audio-native** — Manage audio native

- `elevenlabs-pp-cli audio-native create-project` — Creates Audio Native enabled project, optionally starts conversion and returns project ID and embeddable HTML snippet.
- `elevenlabs-pp-cli audio-native update-content-from-url` — Finds an AudioNative project matching the provided URL, extracts content from the URL, updates the project content,...

**convai** — Manage convai

- `elevenlabs-pp-cli convai add-documentation-to-knowledge-base` — Uploads a file or reference a webpage to use as part of the shared knowledge base
- `elevenlabs-pp-cli convai add-mcp-server-tool-approval-route` — Add approval for a specific MCP tool when using per-tool approval mode.
- `elevenlabs-pp-cli convai add-mcp-tool-config-override-route` — Create configuration overrides for a specific MCP tool.
- `elevenlabs-pp-cli convai add-tool-route` — Add a new tool to the available tools in the workspace.
- `elevenlabs-pp-cli convai agent-testing-bulk-move-route` — Moves multiple tests or folders from one folder to another.
- `elevenlabs-pp-cli convai assign-conversation-tags-route` — Assign one or more conversation tags to a conversation. Tags that are already assigned are ignored. Tags must belong...
- `elevenlabs-pp-cli convai cancel-batch-call` — Cancel a running batch call and set all recipients to cancelled status.
- `elevenlabs-pp-cli convai cancel-file-upload-route` — Remove a file upload from a conversation. Only possible if the file hasn't already been used in the conversation.
- `elevenlabs-pp-cli convai create-agent-deployment-route` — Create a new deployment for an agent
- `elevenlabs-pp-cli convai create-agent-draft-route` — Create a new draft for an agent
- `elevenlabs-pp-cli convai create-agent-response-test-route` — Creates a new agent response test.
- `elevenlabs-pp-cli convai create-agent-route` — Create an agent from a config object
- `elevenlabs-pp-cli convai create-agent-test-folder-route` — Creates a folder for organizing agent tests.
- `elevenlabs-pp-cli convai create-batch-call` — Submit a batch call request to schedule calls for multiple recipients.
- `elevenlabs-pp-cli convai create-branch-route` — Create a new branch from a given version of any branch
- `elevenlabs-pp-cli convai create-conversation-tag-route` — Create a new conversation tag for the workspace.
- `elevenlabs-pp-cli convai create-environment-variable` — Create a new environment variable for the workspace
- `elevenlabs-pp-cli convai create-file-document-route` — Create a knowledge base document generated form the uploaded file.
- `elevenlabs-pp-cli convai create-folder-route` — Create a folder used for grouping documents together.
- `elevenlabs-pp-cli convai create-mcp-server-route` — Create a new MCP server configuration in the workspace.
- `elevenlabs-pp-cli convai create-phone-number-route` — Import Phone Number from provider configuration (Twilio or SIP trunk)
- `elevenlabs-pp-cli convai create-secret-route` — Create a new secret for the workspace
- `elevenlabs-pp-cli convai create-text-document-route` — Create a knowledge base document containing the provided text.
- `elevenlabs-pp-cli convai create-url-document-route` — Create a knowledge base document generated by scraping the given webpage.
- `elevenlabs-pp-cli convai delete-agent-draft-route` — Delete a draft for an agent
- `elevenlabs-pp-cli convai delete-agent-route` — Delete an agent
- `elevenlabs-pp-cli convai delete-agent-test-folder-route` — Deletes an agent test folder by ID. Use force=true to delete a non-empty folder and all its contents.
- `elevenlabs-pp-cli convai delete-batch-call` — Permanently delete a batch call and all recipient records. Conversations remain in history.
- `elevenlabs-pp-cli convai delete-chat-response-test-route` — Deletes an agent response test by ID.
- `elevenlabs-pp-cli convai delete-conversation-route` — Delete a particular conversation
- `elevenlabs-pp-cli convai delete-conversation-tag-route` — Delete a conversation tag. Restricted to the tag owner or a workspace admin.
- `elevenlabs-pp-cli convai delete-knowledge-base-document` — Delete a document or folder from the knowledge base.
- `elevenlabs-pp-cli convai delete-mcp-server-route` — Delete a specific MCP server configuration from the workspace.
- `elevenlabs-pp-cli convai delete-phone-number-route` — Delete Phone Number by ID
- `elevenlabs-pp-cli convai delete-rag-index` — Delete RAG index for the knowledgebase document.
- `elevenlabs-pp-cli convai delete-secret-route` — Delete a workspace secret if it's not in use
- `elevenlabs-pp-cli convai delete-tool-ro