RTL / Bidi Lint

SkillDocs & knowledge

Use when reviewing or generating Arabic text, UI strings, HTML or Markdown that mixes RTL with LTR content, to catch digit mixing, unbalanced bidi isolates, stray LTR marks and hardcoded dir="ltr".

Use RTL / Bidi Lint in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add RTL / Bidi Lint and connect your AI. About a minute.

Also: Claude Code · Cursor · Codex

Then ask your AI: use the RTL / Bidi Lint skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Add Ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

RTL / Bidi LintStart free

What this skill tells your AI

The instructions your AI receives, as published by h9-tec/arabic-ai-atlas in skills/rtl-bidi-lint/SKILL.md and read by Ahel’s review.

Runs a small stdlib-only linter over text files and explains each finding.

Run

python ${CLAUDE_PLUGIN_ROOT}/skills/rtl-bidi-lint/bidi_lint.py <files...>

Output lines look like path:line: CODE message. Exit code 1 means findings, 0 means clean.

Codes and fixes

CodeMeaningFix
MIXED_DIGITSArabic-Indic (٠-٩ or ۰-۹) and ASCII (0-9) digits on one linePick one digit system per document. Use ASCII for code, IDs, prices and data; Arabic-Indic only for prose when the audience expects it.
UNBALANCED_ISOLATEU+2066, U+2067 or U+2068 opened without a matching U+2069Close every isolate. Wrap embedded LTR runs (names, URLs, code) as U+2068 ... U+2069 (first-strong isolate).
LTR_MARK_IN_ARABICU+200E sits between Arabic lettersRemove it. It breaks letter joining and shaping. If direction needs forcing, use an isolate around the foreign run instead.
HARDCODED_LTRdir="ltr" on a line that contains ArabicUse dir="auto" for user content, or dir="rtl" for known-Arabic blocks.

Procedure

  1. Run the script on the files in question (or write the text to a temp file first).
  2. For each finding, show the line and apply the fix from the table.
  3. Re-run until exit code 0.

Limits

The linter is line-based and heuristic. It does not render text, so check the final result visually when layout matters.

Signals

GitHub stars
32
Forks
4
Last commit
Oct 2026

Ahel review

  • K5info
    obfuscation (in bidi_lint.py)

Automated review, not a security audit. Ruleset v1+k2.

Advanced
Item type
skill
Key
rtl-bidi-lint
Source
github.com/h9-tec/arabic-ai-atlas