v1.1.0 — content-level validator + python-docx template

What's new in v1.1.0

Follow-up to v1.0.0 after a real failure case: a generated Arabic document passed the structural harden and looked correct in a LibreOffice PDF preview, yet still violated three content-level rules and rendered wrong in Word. This release adds tooling to catch that class of mistake.

Added

• harden_rtl.py --validate — flags content-level rule violations: a bidi paragraph using jc="right", and a single run mixing Arabic + Latin letters (errors); Latin digits or trailing Latin punctuation in RTL runs (warnings). Exits 1 on errors.
• harden_rtl.py --fix-jc — opt-in rewrite of jc="right" → "start" in unambiguously-RTL paragraphs (have <w:bidi/>, no LTR runs).
• references/python-docx-template.md — a battle-tested python-docx helper layer (split_bidi tokenizer, add_para/add_run/make_table_rtl) that encodes rules 1–8 by construction, plus a worked example.
• SKILL.md — new "python-docx gotcha" section: there is no WD_ALIGN_PARAGRAPH.START, so the natural API emits the buggy jc="right".

Changed

• SKILL.md reference links repointed to existing files; per-language notes folded inline.
• README (EN + AR): documented --validate/--fix-jc, added references/ to the layout, and the build command now bundles references/.

Install: download claude-arabic-docs.skill below → in Cowork, open the skills picker → Install Skill → choose the file.