arabic-captions
Installation
SKILL.md
Arabic Captions
Arabic captions break in three classic ways: disconnected letters, punctuation on the wrong side, and reversed mixed Arabic/English. This skill prevents all three. Start from a clean transcript (arabic-transcript-cleanup).
1. Line rules
- Long-form (YouTube): max 2 lines, ~35–42 characters per line, 1–6 s per caption.
- Short-form (Reels/TikTok): 2–4 words per caption, one line, changing with speech.
- Break at meaning boundaries. Never split: a number from its unit («٣ ثواني»), «ال» from its word, or a negation from its verb («مش هـ…»).
- Captions follow the speaker's dialect. Don't "correct" it to فصحى.
- Digits: follow the Voice Card (Western 0–9 is the safer default for burned-in text).
2. Fix RTL punctuation (the #1 bug)
When a line starts or ends with punctuation or English, many players put the «؟» or «.» on the wrong side. Fix it by adding the invisible Right-to-Left Mark (U+200F) at the start and end of every Arabic line: