CommunitySchreiben & Editierengithub.com

a7aadly1987-hub/arabic-voice-ready

Bereite arabische (ägyptischer Dialekt oder MSA) Voiceover- und Werbeskripte so vor, dass ElevenLabs und andere TTS-Engines sie korrekt aussprechen. Verwende dies immer dann, wenn du ein arabisches Skript für Text-to-Speech, eine Reel/Werbesprecherstimme, eine IVR-Ansage oder eine Hörbuchzeile schreibst oder korrigierst; wenn arabische TTS Zahlen, Preise, Daten, Prozentangaben, Markennamen, englische Lehnwörter oder Domains falsch ausspricht; oder wenn der Benutzer eine ägyptische „عامية“-Erzählung wünscht.

Was ist arabic-voice-ready?

Die arabische Text-to-Speech (TTS) – insbesondere mit ElevenLabs – scheitert an vorhersagbaren Stellen: Zahlen, Preise, Daten, Prozentangaben, Markennamen, englische Lehnwörter und Domainnamen werden oft falsch ausgesprochen. Dieses Skill behebt diese Probleme **im Text**, bevor Audio generiert wird, um Credits zu sparen. Es unterstützt sowohl den ägyptischen Dialekt (عامية) als auch Modernes Standardarabisch (MSA) und bietet einen Normalisierer (`scripts/normalize.mjs`), der Zahlen in Worte umwandelt und `%`, Bereiche, Tausendertrennzeichen, arabisch-indische Ziffern und Lehnwörter automatisch behandelt. Der empfohlene Arbeitsablauf umfasst: 1) Verfassen eines kurzen Skripts (4–9 Wörter pro Satz) im Ziel dialekt, 2) Anwendung des Normalisierers (`--dialect=egy` für Ägyptisch oder `--dialect=msa`), 3) manuelle Anpassungen aus den Referenzdateien für diakritische Zeichen, Buchstaben und Markennamen, 4) sparsame Ergänzung von ElevenLabs-Audio-Tags (max. ein Emotions-Tag pro 2–3 Sätze) und 5) Erstellung von 2 Takes mit Korrektur nur der fehlerhaften Wörter. Besonders wichtig: niemals Ziffern im Rohtext lassen – immer vorschreiben; Lehnwörter in lateinische Schrift umwandeln, wenn der arabische Buchstabe mehrdeutig ist (z.B. „ج“ = /g/ → `gel` statt جل); diakritische Zeichen nur dort setzen, wo Fehler auftreten; Marken so schreiben, wie die Marke sie ausspricht; Preise mit einmaliger Nennung der Währung. Das Skill enthält Referenzdateien zu ägyptischen Aussprachefallen (`references/pronunciation.md`), ElevenLabs-Tags (`references/elevenlabs-tags.md`) und Beispiele (`examples/`).

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/a7aadly1987-hub/arabic-voice-ready/tree/HEAD

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Arabic Voice Ready

Arabische TTS scheitert an vorhersagbaren Stellen. Korrigiere sie im Text, bevor Audio generiert wird – jede Neugenerierung kostet Credits.

Arbeitsablauf

  1. Schreibe das Skript im Ziel dialekt. Ägyptische Anzeigen lesen sich natürlich in عامية («اطلب دلوقتي», «بس», «في المية»). Halte Sätze kurz: eine Idee pro Satz, 4–9 Wörter.
  2. Führe den Normalisierer auf dem Entwurf aus – er schreibt Zahlen so, wie der Dialekt sie ausspricht, und behandelt %, Bereiche, Tausendertrennzeichen, arabisch-indische Ziffern, Domains und gängige Lehnwörter:
    node scripts/normalize.mjs "خصم 20% من 5 لـ 15 نوفمبر بـ 359 جنيه" --dialect=egy --pauses
    # خصم عشرين في المية من خمسة لِـخمستاشر نوفمبر بـ تلتمية وتسعة وخمسين جنيه
    
    --dialect=msa ergibt فصحى-Zahlen (خمسة عشر، عشرون بالمئة). --pauses fügt [short pause] zwischen Sätzen ein (ElevenLabs v3/v4 Audio-Tags).
  3. Wende die manuellen Regeln in references/pronunciation.md an für das, was ein Skript nicht entscheiden kann: diakritische Zeichen auf mehrdeutige Wörter, Markennamen, die Buchstaben ج / ق / ث / ذ im Ägyptischen, Betonung auf Lehnwörtern.
  4. Füge Ausgabe-Tags aus references/elevenlabs-tags.md hinzu – sparsam (ein Emotions-Tag pro 2–3 Sätze).
  5. Generiere 2 Takes, höre zu, korrigiere dann nur die Wörter, die fehlerhaft waren. Notiere jede Korrektur im Skript, damit der nächste Take sie beibehält.

Wichtigste Regeln

  • Lasse niemals Ziffern im Rohtext, damit die Engine sie erraten muss. «15» könnte in einer ägyptischen Anzeige zu «خمسة عشر» werden, «20%» könnte als «عشرون بالمئة» gelesen werden. Schreibe immer vor.
  • Lehnwörter → lateinische Schrift, wenn der arabische Buchstabe mehrdeutig ist. Im Ägyptischen ist «ج» ein hartes /g/, also wird «جل» als gal gelesen. Schreibe gel. Gleiches für memory foam, wenn es bricht, .com → «دوت كوم».
  • Diakritische Zeichen nur wo nötig. Voll vokalisierter Text klingt roboterhaft. Füge einen Vokal nur zu einem Wort hinzu, das falsch gelesen wurde: «البِيضاء», «خَصْم», «كُمْفُورْت».
  • Marken: Schreibe sie so, wie die Marke sie ausspricht, mit Sukun auf Konsonantenclustern: «ماكْس كُمْفُورْت», «نُون», «جُومْيا».
  • Preise: Nenne die Währung einmal: «بـ تلتمية وتسعة وخمسين جنيه بدل أربعمية وتسعة وأربعين».
  • Daten: «من خمسة لِخَمَسْتاشَر نوفمبر» – das ل verbindet sich mit der Zahl; diakritische Zeichen auf «خمستاشر» verhindern, dass es zu «خمسة عشر» wird.
  • Versprich nicht, was du nicht beweisen kannst. Werbeskripte dürfen keine Preise, Rabatte oder medizinische Behauptungen erfinden; lies Zahlen aus der echten Quelle.

Dateien

  • scripts/normalize.mjs – abhängigkeitsfreier Normalisierer (CLI + import { normalize, numberToWords }).
  • scripts/normalize.test.mjs – node --test scripts/normalize.test.mjs.
  • references/pronunciation.md – Ägyptische Aussprachefallen und Korrekturen.
  • references/elevenlabs-tags.md – Audio-Tags, die gut mit Arabisch funktionieren.
  • examples/ – Skripte vorher/nachher.

Verwandte Skills