ElevenLabs 语音技能集
为兼容 Agent Skills 规范的 AI 编码助手提供一套开箱即用的 ElevenLabs 语音能力技能，覆盖语音合成、转写、配音、音效与音乐生成。
证据显示API密钥通过环境变量传递（ELEVENLABS_API_KEY），未发现硬编码凭据或过度权限声明，故sensitive_data_handling给2、source_attribution给2（MIT许可证含明确版权归属）；但各skill目录内部文件未提供，无法核实实际调用的API端点、数据流向或是否存在写入/删除类副作用，least_privilege、data_flow_transparency、external_effects仅给1，user_confirmation给1，rollback完全无证据给0，dependency_security因SDK/CLI依赖仅见安装命令而给1。
README声称evals目录含触发与功能评测并给出运行命令，但属未经独立验证的声明，self_consistency与failure_messages均只有文档层面的薄弱证据，各给1；dependency_availability依赖外部SDK版本（且警告了错误的npm包名），说明存在依赖风险，给1。
面向使用ElevenLabs产品的开发者，覆盖TTS/STT/Agent等多场景并支持Python/JS/CLI三种环境，audience_and_scenarios给2；README提到evals/results目录保留触发评测结果，trigger_precision给2；但capability_boundaries与environment_fit（各skill的前置条件、运行环境差异）因skill内部文件缺失仅给1。
仓库结构清晰（按skill分目录+references/文档+evals/），命名一致，安装说明完整，information_architecture、install_notes、naming_stability各给2；license有完整MIT文本给3；但examples与FAQ仅在references/中被声称而未展示，给1；无版本号或CHANGELOG，versioning_changelog给1；维护责任仅由未验证发布者身份隐含，maintenance_responsibility给1；已知局限仅一条（弃用npm包警告），known_limitations给1。
安装命令一行可执行，10个skill覆盖完整语音产品线，marginal_value给2；输出形态（技能规格、evals报告）对开发者可用，output_usability给2；成本主要是一个API密钥，cost_benefit给2；但所有价值声明均未经执行验证。
README中的声明（evals结果、references文档、SDK支持）无法在提供的文件内交叉核实，claim_traceability与cross_source_corroboration各给1；README区分了事实描述与警告（如弃用包提示），fact_inference_separation给2。
- 本次评审仅为静态审查，所有评测能力（evals）声明均未经独立执行验证。
- 各skill内部文件未提供，实际网络调用、副作用与权限范围无法核实，使用前请人工审查每个skill的源文件。
- README明确警告@elevenlabs/elevenlabs-js与npm包elevenlabs易混淆，安装时须核对包名。
- API密钥通过环境变量配置，注意不要在日志或evals结果中泄露；rollback机制无任何文档。
- 发布者身份未经FollowAgents注册表验证，不可仅凭品牌信任该仓库。
这个 Agent 能做什么，适合哪些场景？
elevenlabs/skills 是 ElevenLabs 官方发布的 Agent 技能集合，遵循 agentskills.io 的 Agent Skills 规范，可与任何兼容的 AI 编码助手配合使用。仓库包含十项技能：text-to-speech、speech-to-text、speech-engine、agents、sound-effects、music、voice-changer、voice-isolator、dubbing 和 setup-api-key。所有技能都需要配置 ELEVENLABS_API_KEY 环境变量，通过 Python SDK、JavaScript/TypeScript SDK 或 ElevenLabs CLI 调用 ElevenLabs REST API。安装方式为一条命令：npx skills add elevenlabs/skills。仓库还附带 evals/ 目录，提供触发评测和功能评测脚本，结果输出到带时间戳的结果目录中。它本质上是给编码代理加载的技能包，而非独立运行的常驻服务。
仓库以技能目录的形式提供可复用指令与示例：text-to-speech 将文本转为 ElevenLabs AI 语音；speech-to-text 将音频文件转写为带时间戳的文本；speech-engine 为自定义 LLM 或聊天代理添加实时语音对话；agents 用于构建对话式语音 AI 代理；sound-effects 根据文字描述生成音效；music 用 AI 作曲生成音乐；voice-changer 将录音中的语音转换为其他目标声音（speech-to-speech）；voice-isolator 去除背景噪声并分离人声；dubbing 将音视频配音为其他语言并保留原说话人音色；setup-api-key 引导获取和配置 API 密钥。各技能的 references/ 目录包含 SDK 安装指引，evals/run_all.py 支持 --trigger-only、--functional-only、--skills、--model 等参数运行评测。
- 正在用 Claude Code 等 AI 编码助手开发语音应用的开发者，希望代理直接掌握 ElevenLabs API 的正确调用方式
- 需要为聊天机器人或自定义 LLM 添加实时语音对话能力的工程师，可使用 speech-engine 技能
- 内容创作者代理需要根据文本生成配音、音效或背景音乐时，可调用 text-to-speech、sound-effects 和 music 技能
- 处理多语言视频的团队可用 dubbing 技能将音视频配音为其他语言并保留原说话人音色
- 需要清理录音质量的用户可用 voice-isolator 去噪并分离人声
- 维护基于这些技能的代理系统的团队可运行 evals/ 下的触发与功能评测来验证技能行为
这个 Agent 有哪些优点和局限？
- 遵循开放的 Agent Skills 规范，可与任何兼容的 AI 编码助手配合使用，不绑定单一代理产品
- 覆盖 ElevenLabs 全线语音能力（TTS、STT、配音、变声、降噪、音效、音乐），一次安装即获得完整技能集
- 同时提供 Python、JavaScript/TypeScript SDK 和 CLI 三种调用路径，并明确警示了过时的 v1.x npm 包
- 自带 evals/ 评测体系，可验证技能是否在正确的查询时触发以及输出是否正确
- 所有技能都强依赖 ElevenLabs API 和付费 API 密钥，离开 ElevenLabs 平台无法工作
- 评测脚本绑定 Cursor Agent CLI 和 Cursor 认证，复现评测需要额外的工具链
- 仓库未提供各技能的定价或用量信息，采用前需自行评估 API 成本
- 技能是给编码代理使用的指令包，不是独立可部署的服务，需要兼容 Agent Skills 规范的运行环境
如何安装或部署这个 Agent？
- 安装技能包：npx skills add elevenlabs/skills
- 获取 API 密钥：使用 setup-api-key 技能，或访问 https://elevenlabs.io/app/settings/api-keys
- 配置环境变量：export ELEVENLABS_API_KEY="your-api-key"
- 按需安装 SDK：Python 执行 pip install elevenlabs；JavaScript/TypeScript 执行 npm install @elevenlabs/elevenlabs-js；CLI 执行 npm install -g @elevenlabs/cli 或 brew install elevenlabs/tap/elevenlabs
注意：不要使用 npm install elevenlabs（那是过时的 v1.x 包）。
如何使用这个 Agent？
将技能加载到任何兼容 Agent Skills 规范的 AI 编码助手后，向代理发出相关请求（如“把这段文字转成语音”）即可触发对应技能；技能会指引代理调用相应 SDK 或 CLI，读取 ELEVENLABS_API_KEY 完成 API 调用。各技能 references/ 目录中的安装指南包含从弃用包迁移等完整配置说明。运行评测：python3 evals/run_all.py -v（全部）、--trigger-only（仅触发评测，约 3 分钟）、--functional-only（仅功能评测，约 15 分钟）、--skills text-to-speech agents（指定技能）、--model gpt-5.4-high（自定义模型）；需先安装 Cursor Agent CLI 并通过 cursor-agent login 或 CURSOR_API_KEY 完成认证。结果保存在 evals/results/<timestamp>/ 下。