elevenlabs/skills

ElevenLabs Skills – 為任何程式碼助手提供即插即用的 AI 語音功能

是什麼 – 一組封裝了 ElevenLabs 語音 AI（文字轉語音、語音轉文字、變聲、配音、音樂生成等）的 agent skills。這些技能遵循開放的 Agent Skills specification，並可由任何相容的 AI 程式碼助手（例如 Cursor、基於 Claude 的 agents）調用。

如何取得 – 使用單一 npx 指令安裝技能包：

npx skills add elevenlabs/skills

接著，所有的個別技能都可供助手使用。

核心能力

Skill	功能說明
text-to-speech	使用 ElevenLabs 的 AI 語音將任意文字轉換為栩栩如生的語音
speech-to-text	轉錄音檔並回傳時間戳記
speech-engine	將即時語音輸入/輸出連接到自定義的 LLM 或聊天 agent
agents	建立功能齊全的對話式語音 agent
sound-effects	從文字提示生成短暫的音效
music	創作 AI 作曲的音樂軌道
voice-changer	將錄製的聲音轉換為另一個目標聲音（語音轉語音）
voice-isolator	去除背景噪音並分離出說話聲分量
dubbing	在保留原講者聲音的同時，翻譯並配音音訊/影片
setup-api-key	獲取並配置 ElevenLabs API key 的互動式指南

配置 – 所有技能都需要 ElevenLabs API key。請在您的環境中設定一次：

export ELEVENLABS_API_KEY="your-api-key"

您可以透過 setup-api-key 技能或 ElevenLabs 控制台獲取該 key。

SDK / runtime 支援

• Python – pip install elevenlabs
• JavaScript/TypeScript – npm install @elevenlabs/elevenlabs-js（建議使用的套件；舊版的 elevenlabs v1.x 已棄用）
• CLI – npm install -g @elevenlabs/cli 或 brew install elevenlabs/tap/elevenlabs。CLI 會自動讀取 ELEVENLABS_API_KEY。 每個技能都附帶一個 references/ 資料夾，其中包含您所選語言的詳細設定指南。

測試 / 評估 – 此儲存庫包含一個 evals/ 套件：

• Trigger tests – 驗證技能是否針對正確的使用者查詢而觸發（約 3 分鐘）。
• Functional tests – 檢查技能是否回傳正確的輸出（約 15 分鐘）。 使用提供的 Python 腳本執行它們，可選擇性地選擇特定技能或自定義模型（例如 gpt-5.4-high）。結果會以 Markdown 報告和 JSON 檔案的形式寫入 evals/results/<timestamp>/。 評估依賴於 Cursor Agent CLI (cursor-agent) 並要求您已登入 (cursor-agent login 或 CURSOR_API_KEY)。

授權 – MIT，因此您可以自由使用、修改和重新分發這些技能。

---

以上所有資訊直接取自儲存庫的 README。