elevenlabs/skills

ElevenLabs Skills – 모든 코딩 어시스턴트를 위한 플러그 앤 플레이 AI 음성 기능

개요 – ElevenLabs의 음성 AI(text‑to‑speech, speech‑to‑text, voice‑changing, dubbing, music generation 등)를 래핑한 agent skills 모음입니다. 이 스킬들은 오픈 Agent Skills specification을 따르며, 호환 가능한 모든 AI 코딩 어시스턴트(예: Cursor, Claude‑based agents)에서 호출할 수 있습니다.

사용 방법 – 단일 npx 명령어로 스킬 팩을 설치합니다:

npx skills add elevenlabs/skills

설치 후 모든 개별 스킬을 어시스턴트에서 사용할 수 있습니다.

주요 기능

Skill	기능
text-to-speech	ElevenLabs의 AI 음성을 사용하여 임의의 텍스트를 생생한 음성으로 변환
speech-to-text	오디오 파일을 전사하고 타임스탬프를 반환
speech-engine	실시간 음성 입출력을 커스텀 LLM 또는 채팅 에이전트로 연결
agents	기능이 풍부한 대화형 음성 에이전트 구축
sound-effects	텍스트 프롬프트로부터 짧은 효과음을 생성
music	AI가 작곡한 음악 트랙 생성
voice-changer	녹음된 음성을 다른 대상 음성으로 변환 (speech‑to‑speech)
voice-isolator	배경 소음을 제거하고 말하는 음성 성분만 분리
dubbing	원본 화자의 음성을 유지하면서 오디오/비디오를 번역 및 더빙
setup-api-key	ElevenLabs API 키를 획득하고 설정하기 위한 대화형 가이드

설정 – 모든 스킬은 ElevenLabs API 키가 필요합니다. 환경 변수에 한 번만 설정하면 됩니다:

export ELEVENLABS_API_KEY="your-api-key"

setup-api-key 스킬이나 ElevenLabs 대시보드를 통해 키를 얻을 수 있습니다.

SDK / 런타임 지원

• 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)을 선택할 수 있습니다. 결과는 evals/results/<timestamp>/에 마크다운 보고서와 JSON 파일로 저장됩니다. 평가는 Cursor Agent CLI (cursor-agent)를 기반으로 하며, cursor-agent login 또는 CURSOR_API_KEY를 통해 로그인이 필요합니다.

라이선스 – MIT, 따라서 스킬을 자유롭게 사용, 수정 및 재배포할 수 있습니다.

---

위의 모든 정보는 레포지토리의 README에서 직접 가져온 것입니다.