Community라이팅 & 에디팅github.com

a7aadly1987-hub/arabic-voice-ready

아랍어(이집트 방언 또는 현대 표준 아랍어) 음성 해설 및 광고 스크립트를 준비하여 ElevenLabs 및 기타 TTS 엔진이 올바르게 발음하도록 합니다. 텍스트 음성 변환, 릴/광고 음성 해설, IVR 프롬프트, 오디오북 대본을 작성하거나 수정할 때; 아랍어 TTS가 숫자, 가격, 날짜, 백분율, 브랜드 이름, 영어 외래어, 도메인을 잘못 발음할 때; 또는 사용자가 이집트 «عامية» 내레이션을 요청할 때 사용하세요.

arabic-voice-ready란 무엇인가요?

이 스킬은 아랍어(이집트 방언 및 현대 표준 아랍어) 텍스트를 TTS(Text-to-Speech) 엔진에 최적화하여 발음 오류를 사전에 방지하는 전처리 도구입니다. ElevenLabs를 비롯한 TTS 엔진은 숫자, 가격, 날짜, 백분율, 브랜드명, 영어 외래어, 도메인 이름 등에서 일관되게 오류를 보이므로, 이 스킬은 이러한 요소들을 방언에 맞는 철자로 사전 변환합니다. 주요 기능은 노멀라이저 스크립트(`scripts/normalize.mjs`)를 통해 CLI에서 실행 가능하며, 방언(egy/msa) 선택과 선택적 일시 정지 태그 추가를 지원합니다. 또한 수동 규칙(모음 부호, 브랜드명 특수표기, 이집트 방언의 ج/ق/ث/ذ 처리 등)과 전달 태그(ElevenLabs 오디오 태그)에 대한 참조 문서를 제공합니다. 이 스킬은 불필요한 음성 재생성을 줄여 크레딧과 시간을 절약하며, 자연스럽고 정확한 아랍어 음성 출력을 보장합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/a7aadly1987-hub/arabic-voice-ready/tree/HEAD

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Arabic Voice Ready

아랍어 TTS는 예측 가능한 위치에서 실패합니다. 오디오를 생성하기 전에 텍스트에서 수정하세요. 매번 재생성할 때마다 크레딧이 소모됩니다.

워크플로우

  1. 대상 방언으로 스크립트를 작성하세요. 이집트 광고는 عامية(«اطلب دلوقتي», «بس», «في المية»)로 자연스럽게 읽힙니다. 문장을 짧게 유지하세요: 한 문장에 하나의 아이디어, 4–9단어.
  2. 초안에 노멀라이저를 실행하세요. 방언이 말하는 방식으로 숫자를 표기하고, %, 범위, 천 단위 구분자, 아랍-인도 숫자, 도메인 및 일반적인 외래어를 처리합니다:
    node scripts/normalize.mjs "خصم 20% من 5 لـ 15 نوفمبر بـ 359 جنيه" --dialect=egy --pauses
    # خصم عشرين في المية من خمسة لِـخمستاشر نوفمبر بـ تلتمية وتسعة وخمسين جنيه
    
    --dialect=msa는 표준 아랍어 숫자(خمسة عشر، عشرون بالمئة)를 제공합니다. --pauses는 문장 사이에 [short pause]를 추가합니다(ElevenLabs v3/v4 오디오 태그).
  3. 스크립트가 결정할 수 없는 항목에 대해 references/pronunciation.md의 수동 규칙을 적용하세요. 모호한 단어의 모음 부호, 브랜드명, 이집트 방언의 ج / ق / ث / ذ 문자, 외래어 강세 등.
  4. references/elevenlabs-tags.md의 전달 태그를 추가하세요. 드물게 사용하십시오(2~3문장당 하나의 감정 태그).
  5. 2개의 테이크를 생성하고 듣고, 깨진 단어만 수정하세요. 각 수정 사항을 스크립트에 기록하여 다음 테이크에서 유지되도록 하십시오.

가장 중요한 규칙

  • 엔진이 추측하도록 숫자를 그대로 두지 마세요. 이집트 광고에서 «15»는 «خمسة عشر»가 될 수 있고, «20%»는 «عشرون بالمئة»로 읽힐 수 있습니다. 항상 미리 철자를 써두세요.
  • 외래어 → 아랍 문자가 모호할 경우 라틴 문자로 작성하세요. 이집트에서는 «ج»가 강한 /g/로 발음되므로 «جل»은 gal로 읽힙니다. gel을 작성하세요. memory foam이 깨질 경우에도 동일하게, .com은 «دوت كوم»로.
  • 필요한 곳에만 모음 부호를 추가하세요. 완전히 모음화된 텍스트는 기계처럼 들립니다. 잘못 읽힌 단어에만 모음을 추가하세요: «البِيضاء», «خَصْم», «كُمْفُورْت».
  • 브랜드명: 브랜드가 말하는 방식대로 철자를 쓰고, 자음군 위에 수쿤을 붙이세요: «ماكْس كُمْفُورْت», «نُون», «جُومْيا».
  • 가격: 통화를 한 번만 말하세요: «بـ تلتمية وتسعة وخمسين جنيه بدل أربعمية وتسعة وأربعين».
  • 날짜: «من خمسة لِخَمَسْتاشَر نوفمبر» — ل이 숫자에 붙습니다. «خمستاشر»에 모음 부호를 붙이면 «خمسة عشر»가 되는 것을 방지합니다.
  • 증명할 수 없는 것을 약속하지 마세요. 광고 스크립트는 가격, 할인, 의학적 주장을 임의로 만들어서는 안 됩니다. 실제 출처에서 숫자를 읽으세요.

파일

  • scripts/normalize.mjs — 의존성 없는 노멀라이저(CLI + import { normalize, numberToWords }).
  • scripts/normalize.test.mjs — node --test scripts/normalize.test.mjs.
  • references/pronunciation.md — 이집트 발음 함정과 수정 방법.
  • references/elevenlabs-tags.md — 아랍어에 잘 작동하는 오디오 태그.
  • examples/ — 전후 스크립트.

관련 스킬