asadeisa

Arabic Office Skills — Design skill for Claude Code

Design community

Agent skills for correct Arabic/RTL output in PDF, Word and PowerPoint — with PNG preview for visual verification.

How to install Arabic Office Skills

This entry records only its repository, not the path inside it, so there is no exact command to give. Open asadeisa/arabic-office-skills and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Arabic Office Skills does

Agent skills for correct Arabic/RTL output in PDF, Word and PowerPoint — with PNG preview for visual verification.

Alternatives in Design

  • Canvas Design — Create beautiful visual art in PNG and PDF documents using design philosophy 94.1k ★
  • Export Diagram — Export a diagram-design HTML file to .svg and .png next to the source 27.2k ★
  • Fleet Verify — Use after a UI or user-visible change and before you claim it works — it spawns ONE CCC verification lane that 130 ★

README

Arabic Office Skills

[![tests](https://github.com/asadeisa/arabic-office-skills/actions/workflows/tests.yml/badge.svg)](https://github.com/asadeisa/arabic-office-skills/actions/workflows/tests.yml) ![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue) [![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)

Three agent skills for producing **PDF, Word, and PowerPoint files in Arabic** — and any other right-to-left script — that actually render correctly.

Arabic output breaks in ways that are invisible until someone opens the file: letters stand apart instead of joining, lines within a paragraph swap places, table columns end up mirrored, and the space around an English term silently disappears. None of it shows up in extracted text, because the characters are all present and correct. Only their shape and placement are wrong.

![The same paragraph rendered by plain reportlab and by arabic-pdf](docs/before-after.png)

Same text, same font, same call. On the left the letters stand apart, the title reads back to front, and `Nuxt 3` has jumped out of the sentence — that is what plain reportlab produces, not an exaggeration of it.

Each skill fixes this for one format, and each bundles a working Python library plus a `preview()` that renders the result to PNG so it can be checked before delivery.

Skill Format Library
`arabic-pdf` .pdf reportlab
`arabic-docx` .docx python-docx
`arabic-pptx` .pptx python-pptx

The one thing worth knowing

These three formats need **opposite** techniques, and the most common way to break Arabic output is to carry the right fix into the wrong format.

reportlab (and Pillow without libraqm) Word / PowerPoint (and Pillow with libraqm)
Text engine none full bidirectional engine
Expects final visual-order glyphs raw logical-order Unicode
Technique reshape + bidi