- Home
- Skills
- Frontend & Web Apps
- Arabic Text QA: Harakat, RTL & Fonts Done Right
Works with the AI Agents you already use
Arabic Text QA: Harakat, RTL & Fonts Done Right
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
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
| Text | Codepoints 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
- SantriOnline: https://santrionline.com
- Open-source skill pack (santri-skills): https://github.com/Santrionlinecom/santri-skills
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
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
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 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