rtl-document-translation — Claude Code skill: setup and usage
rtl-document-translation translates DOCX files into RTL languages like Arabic, Hebrew, and Urdu while preserving table structures, colors, and layout.
no license 1 installs ★ 46 updated 2026-09-19
npx skills add belumume/claude-skills --skill rtl-document-translation -a claude-codeWhat rtl-document-translation does
This skill converts structured DOCX files into Arabic, Hebrew, or Urdu without breaking layouts. It runs a four-stage process: structural analysis, translation dictionary compilation, document generation, and final verification. That sequence prevents corrupted cell dimensions and broken multi-line rows.
RTL formatting applies across three distinct layers. It toggles bidirectional text flags in WordprocessingML, sets right paragraph alignment, and maintains original left-to-right column sequences for financial data. Quote normalization converts curly quotes and unicode spaces, matching strings across multiple fallback passes.
The generator fails without python>=3.8, python-docx, and Pillow in your environment. It handles DOCX files and excludes PDF workflows.
What it helps with
- translate DOCX documents into Arabic while preserving visual styling
- retain cell background colors and table geometry in financial reports
- normalize curly quotes and unicode spacing during text replacement
- apply bidirectional font attributes and right alignment to paragraphs
Example prompts for the agent
- Translate
agreement.docxinto Arabic, keeping all table structures and cell colors intact. - Generate an Urdu version of
quarterly-report.docxwith proper RTL text formatting.
How to install rtl-document-translation
1Skills CLI (Vercel)
npx skills add belumume/claude-skills --skill rtl-document-translation -a claude-code2Manually: put the files in place
~/.claude/skills/rtl-document-translation/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/rtl-document-translation/
1Skills CLI (Vercel)
npx skills add belumume/claude-skills --skill rtl-document-translation -a codex2Manually: put the files in place
.agents/skills/rtl-document-translation/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add belumume/claude-skills --skill rtl-document-translation -a cursor2Manually: put the files in place
.cursor/skills/rtl-document-translation/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install belumume/claude-skills rtl-document-translation2Manually: put the files in place
.github/skills/rtl-document-translation/SKILL.md1Skills CLI (Vercel)
npx skills add belumume/claude-skills --skill rtl-document-translation -a gemini-cli2Platform CLI
gemini skills install https://github.com/belumume/claude-skills --path rtl-document-translationManually: put the files in place
.devin/skills/rtl-document-translation/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add belumume/claude-skills --skill rtl-document-translation -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about rtl-document-translation
How to install rtl-document-translation in Claude Code?
Run npx skills add belumume/claude-skills --skill rtl-document-translation -a claude-code in your terminal. The configuration is stored at ~/.claude/skills/rtl-document-translation/SKILL.md.
What does rtl-document-translation do?
It translates DOCX documents into RTL languages such as Hebrew or Arabic while retaining exact cell colors, column structures, and text alignment.
Does rtl-document-translation work directly with PDF documents?
No, it operates strictly on DOCX files. Running the underlying scripts also requires Python 3.8 or newer alongside python-docx and Pillow.