Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    Arabic Text QA: Harakat, RTL & Fonts Done Right

    1

    Keep Arabic text exact in apps, sites and videos: harakat, tatweel, alef/ya/ta marbuta variants, RTL rendering, font shaping and OCR noise. Display exact, normalise only for search.

    Free

    Security scanned
    Arabic Text QA: Harakat, RTL & Fonts Done Right

    Arabic Text QA: Harakat, RTL & Fonts Done Right

    Example session with this skill installed

    Our search can't find "مكتبة" although the product title is in the database as "مكتـــبة". Also the subtitle in our video shows the harakat floating away from the letters. What's wrong?

    • Read your context and instructions
    • Compiled the arabic text qa

    Summary

    Two separate problems: the stored title contains tatweel characters, and the video font/renderer is not shaping Arabic marks.

    1. Search miss

    TextCodepoints in the middle
    مكتبة (query)ت U+062A, ب U+0628
    مكتـــبة (stored)ت U+062A, ـ U+0640 ×3, ب U+0628

    U+0640 ARABIC TATWEEL is a stretching character, not a letter.

    Fix

    • Keep the stored title as the display copy (the seller may want that look).
    • Add a search copy: remove U+0640, and if you also search without vowels, strip harakat U+064B to U+0652 and U+0670.
    • Normalise the query the same way before matching.

    2. Floating harakat in video

    • The renderer is drawing marks as separate glyphs. Use a font with full Arabic mark positioning (OpenType mark/mkmk) and a text engine that runs complex shaping (HarfBuzz-based, or a browser/HTML renderer).
    • Set dir="rtl" on the subtitle element and isolate any Latin words or numbers with <bdi>.

    Next steps

    • Re-index the product table with the search copy.
    • Re-render one frame and zoom to 200% to confirm every mark sits on its letter.

    Connects securely to your tools. The creator never sees your data.

    About this skill

    Arabic text breaks quietly

    A missing shadda, a Persian ya (ی) instead of an Arabic ya (ي), a tatweel stretched into a word, or a font that does not shape harakat: users notice, your QA usually does not.

    Arabic Text QA gives your agent a checklist and codepoint table for:

    • Harakat & marks: fatha, kasra, damma, sukun, shadda, tanwin, superscript alef, Qur'anic small marks
    • Letter variants: alef forms (ا أ إ آ ٱ), ya vs alef maqsura vs Persian ya, ta marbuta vs ha, Persian kaf
    • Two copies of the text: an exact display copy and a normalised search copy, never mixing them
    • RTL in HTML, SVG and video: dir, bidi isolation with Latin and numbers, fonts that shape marks correctly
    • OCR noise from scanned classical books and how to flag it instead of silently "fixing" it

    Useful for any developer shipping Arabic: education apps, e-commerce, subtitles, search.

    Part of santri-skills, a free open-source pack of 9 skills for trustworthy Islamic & Arabic content: https://github.com/Santrionlinecom/santri-skills

    Licence: MIT (code) + CC BY 4.0 (text). Built by SantriOnline (https://santrionline.com).

    Related resources

    Gives checks and fixes; it does not ship a font or a search engine. It does not correct the meaning or grammar of Arabic text. Qur'an text should be verified with the separate quran-ayah-verification skill.

    How to use

    1. 1

      Connect your agent to the Agensi MCP

      Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup

    2. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before any payment.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill goes through the trust checks below.

    Security scanned

    Checked by our 8-point scan before listing

    Fresh listing

    Recently published to Agensi

    Free forever

    No account required to browse

    Trust & safety

    Security scan

    Security scan passed 9 days ago

    • Free with an Agensi account

    Permissions

    Terminal / Shell
    Listed9 days ago
    Updated4 days ago

    What's inside

    Frequently Asked Questions

    No. The skill tells the agent which Unicode codepoints to inspect and what each one means, so a non-Arabic developer can follow the findings.

    No. It keeps the display text exact and only proposes a separate normalised copy for search. Changes to display text are left to you.

    Yes. It covers RTL direction, bidi isolation with Latin text and numbers, and choosing fonts and renderers that position harakat correctly.

    No. Any Arabic text benefits: e-commerce, education, news, subtitles and search.

    New in Frontend & Web Apps