# rtl-document-translation

rtl-document-translation translates DOCX files into RTL languages like Arabic, Hebrew, and Urdu while preserving table structures, colors, and layout.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1 install · ★ 46 repo stars
- Author: belumume
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/belumume/claude-skills/tree/HEAD/rtl-document-translation/SKILL.md
- Updated: 2026-09-19
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/rtl-document-translation

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add belumume/claude-skills --skill rtl-document-translation -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/rtl-document-translation/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/rtl-document-translation/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add belumume/claude-skills --skill rtl-document-translation -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/rtl-document-translation/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add belumume/claude-skills --skill rtl-document-translation -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/rtl-document-translation/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install belumume/claude-skills rtl-document-translation
```

2. **Manually: put the files in place**
- File: `.github/skills/rtl-document-translation/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add belumume/claude-skills --skill rtl-document-translation -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/belumume/claude-skills --path rtl-document-translation
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/rtl-document-translation/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add belumume/claude-skills --skill rtl-document-translation -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/belumume/claude-skills/tree/HEAD/rtl-document-translation/SKILL.md

## When to use it
- 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
- Translate `agreement.docx` into Arabic, keeping all table structures and cell colors intact.
- Generate an Urdu version of `quarterly-report.docx` with proper RTL text formatting.

## Similar
- [rtl-chat-fixer](https://affpapa.org/en/nevibecode/plugins/rtl-chat-fixer.md) — plugin · ★ 11 repo stars
- [hebrew-document-generator](https://affpapa.org/en/nevibecode/skills/hebrew-document-generator.md) — skill · 252 installs
- [hebrew-rtl-best-practices](https://affpapa.org/en/nevibecode/skills/hebrew-rtl-best-practices.md) — skill · 772 installs
- [rtl-chat](https://affpapa.org/en/nevibecode/plugins/rtl-chat.md) — plugin · ★ 11 repo stars
- [azure-ai-translation-document-py](https://affpapa.org/en/nevibecode/skills/azure-ai-translation-document-py.md) — skill · 2 installs
- [html-to-pdf](https://affpapa.org/en/nevibecode/skills/html-to-pdf.md) — skill · 1300 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
