Skip to content
Back to search

sibawayh

MarketplaceWorks with Claude CodeGitHub

Sibawayh (سيبويه): skills that help AI agents write correct Modern Standard Arabic.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 20 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/anasAsh/Sibawayh with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/anasAsh/Sibawayh'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/anasash--sibawayh/badge.svg)](/listings/anasash--sibawayh)

HTML

<a href="/listings/anasash--sibawayh"><img src="/api/listings/anasash--sibawayh/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code

/plugin marketplace add anasAsh/Sibawayh
/plugin install arabic-writing@sibawayh

That's it. The skill now loads by itself whenever Claude writes Arabic.

<details> <summary>Prefer a manual install?</summary>

git clone https://github.com/anasAsh/Sibawayh.git
cd Sibawayh
ln -s "$PWD/skills/arabic-writing" ~/.claude/skills/arabic-writing
# or: cp -r skills/arabic-writing ~/.claude/skills/

From a shell, the plugin commands are `claude plugin marketplace add anasAsh/Sibawayh` and `claude plugin install arabic-writing@sibawayh`.

</details>

Cursor, GitHub Copilot and other agents

Copy `skills/arabic-writing/` into your tool's skills folder; check its documentation for the path. The skill uses the standard `SKILL.md` format. If an agent has no shell, it falls back to the checklist alone.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 12 lines
  1. {
  2. "name": "sibawayh",
  3. "owner": { "name": "Anas Al-Hamdan" },
  4. "description": "Sibawayh (سيبويه): skills that help AI agents write correct Modern Standard Arabic.",
  5. "plugins": [
  6. {
  7. "name": "arabic-writing",
  8. "source": "./",
  9. "description": "Agent Skill that makes AI agents write correct, natural Modern Standard Arabic, with a dependency-free orthography and punctuation checker."
  10. }
  11. ]
  12. }
README.md · README · 232 lines
  1. <div align="center">
  2. ```text
  3. ____ _ _ _
  4. / ___| (_)| |__ __ _ __ __ __ _ _ _ | |__
  5. \___ \ | || '_ \ / _` |\ \ /\ / / / _` || | | || '_ \
  6. ___) || || |_) || (_| | \ V V / | (_| || |_| || | | |
  7. |____/ |_||_.__/ \__,_| \_/\_/ \__,_| \__, ||_| |_|
  8. |___/
  9. ```
  10. # سيبويه · Sibawayh
  11. **Your AI writes Arabic. Sibawayh makes it _correct_ Arabic.**
  12. An Agent Skill that teaches AI agents to write natural Modern Standard Arabic and to check it before they answer.
  13. [![License: MIT](https://img.shields.io/badge/license-MIT-2ea44f)](LICENSE)
  14. [![Python 3.8+](https://img.shields.io/badge/python-3.8%2B-3776ab?logo=python&logoColor=white)](#-run-the-checker-yourself)
  15. [![Dependencies: none](https://img.shields.io/badge/dependencies-none-brightgreen)](#-run-the-checker-yourself)
  16. [![Agent Skill](https://img.shields.io/badge/Agent%20Skill-SKILL.md-d97757)](skills/arabic-writing/SKILL.md)
  17. [![Claude Code plugin](https://img.shields.io/badge/Claude%20Code-plugin-d97757)](#-install)
  18. [![Status: evaluating](https://img.shields.io/badge/status-evaluating-orange)](evals/README.md)
  19. <img src="docs/assets/social-preview.png" alt="Sibawayh: typical AI Arabic vs. Arabic with Sibawayh" width="820">
  20. [Install](#-install) · [How it works](#-how-it-works) · [What it catches](#-what-it-catches) · [Checker](#-run-the-checker-yourself) · [Contribute](#-contribute)
  21. </div>
  22. ---
  23. ## 🤔 Why
  24. Ask an AI model for Arabic and you get text that is *understandable*, but that a native reader spots in a second:
  25. | What goes wrong | Looks like |
  26. |---|---|
  27. | English grammar in Arabic words | تم إنشاء الملف من قبل المستخدم |
  28. | Broken agreement | الملفات الذين تم رفعهم موجودين |
  29. | Wrong number–noun gender | ثلاث مهندسين |
  30. | Wrong hamza | إستخدام، الى |
  31. | English punctuation | نعم, ولكن? |
  32. | Scrambled RTL | lines starting with an English word flip direction |
  33. | Dialect slipping into formal text | عشان، بدي، هيك |
  34. Sibawayh is named after **سيبويه**, the 8th-century scholar whose *al-Kitāb* is the foundational book of Arabic grammar. It gives the agent the rules, a checker and a review checklist, so that its Arabic reads as if a careful native writer wrote it.
  35. ## ✨ Before → after
  36. <div align="center">
  37. <img src="docs/assets/demo.gif" alt="The same LinkedIn prompt answered by Claude Code without and with Sibawayh" width="720">
  38. <br><sub>Real Claude Code outputs for the same prompt, with and without the skill.</sub>
  39. </div>
  40. <table>
  41. <tr><th>✗ Typical AI output</th><th>✓ With Sibawayh</th></tr>
  42. <tr>
  43. <td dir="rtl">
  44. تم إستخدام الأداة من قبل الفريق, وهاذا ساعدنا كثيرا.<br>
  45. لدينا 3 ملفات و٤ مجلدات.<br>
  46. الملفات الذين تم رفعهم موجودين هنا
  47. </td>
  48. <td dir="rtl">
  49. استخدم الفريق الأداة، وهذا ساعدنا كثيرًا.<br>
  50. لدينا 3 ملفات و4 مجلدات.<br>
  51. الملفات التي رُفعت موجودة هنا
  52. </td>
  53. </tr>
  54. </table>
  55. <details>
  56. <summary><b>See what the checker reported on the left-hand text</b></summary>
  57. ```
  58. 1:1 INFO translationese-density Translationese density 15.8 per 100 words (تم/يتم: 2, من قبل: 1) …
  59. 1:4 ERROR hamza-wasl Hamzat al-wasl: write a bare alif, not إ (form X masdar) → استخدام
  60. 1:32 FIX punct-latin Latin punctuation between Arabic words → ،
  61. 1:34 ERROR misspelling Misspelling (no alif after ها) → وهذا
  62. 2:16 WARN digit-mix Mixed digit systems; this text uses Western (0-9) digits → 4
  63. ```
  64. The script finds nothing on line 3: a regex can't reliably catch agreement with non-human plurals. That line gets fixed in the model's checklist review. This is exactly the split Sibawayh is designed around.
  65. </details>
  66. ## ⚙️ How it works
  67. ```mermaid
  68. flowchart LR
  69. A["✍️ Write<br/>with SKILL.md rules"] --> B["🔍 Check<br/>check_arabic.py --fix"]
  70. B --> C["📋 Review<br/>7-point checklist"]
  71. C --> D["✅ Answer<br/>clean Arabic only"]
  72. ```
  73. 1. **Write.** The skill loads whenever the agent is about to produce Arabic: answers, docs, emails, posts, translations, summaries, UI strings and commit messages. While writing, the agent follows the rules in `SKILL.md`: verb-first active sentences, correct agreement and numbers, Arabic punctuation, one digit system, and RTL-safe lines.
  74. 2. **Check.** It runs a tiny Python script with no dependencies. The script auto-fixes what is certain and flags the rest.
  75. 3. **Review.** It works through a prioritized checklist: agreement, numbers, case endings, إنّ/أنّ, translationese, register, formatting. It changes only what is wrong.
  76. 4. **Answer.** The user gets clean Arabic, with no checker noise.
  77. > **🛡️ Golden rule: never over-correct.**
  78. > Forms that purists reject but the Cairo Arabic Language Academy approved are never flagged. Examples: يعتبر، ساهم في، أكد على، في نفس الوقت، أبحاث. Contested forms are left alone, and auto-fixes run only where they can't be wrong.
  79. ## 🎯 What it catches
  80. | | Area | Examples | Handled by |
  81. |---|---|---|---|
  82. | ✏️ | Punctuation | `,` `?` `;` → ، ؟ ؛, spacing | 🤖 checker (auto-fix) |
  83. | 🔤 | Unicode | Persian ک/ی, presentation forms, tatweel | 🤖 checker |
  84. | 📝 | Spelling | إستخدام, هاذا, لاكن, الى, إنشاء الله, ة/ه, ى/ي | 🤖 checker (word lists) |
  85. | 🔢 | Digits and RTL | mixed 3 / ٣, lines that flip direction | 🤖 checker |
  86. | 🗣️ | Dialect leakage | عشان, بدي, هيك in formal text | 🤖 checker |
  87. | ⚖️ | Verb endings | لم يكونون, لن يذهبون, سوف لن | 🤖 checker + 🧠 checklist |
  88. | 🧮 | Agreement and numbers | non-human plurals, العدد والمعدود | 🧠 checklist + 📚 tables |
  89. | 🌐 | Translationese | تم + masdar, قام بـ, من قبل, كـ "as a" | 🤖 density + 🧠 checklist |
  90. | 💻 | Tech terms | واجهة برمجة التطبيقات (API) | 📚 glossary (450+ terms) |
  91. ## 📦 Install
  92. ### Claude Code
  93. ```
  94. /plugin marketplace add anasAsh/Sibawayh
  95. /plugin install arabic-writing@sibawayh
  96. ```
  97. That's it. The skill now loads by itself whenever Claude writes Arabic.
  98. <details>
  99. <summary>Prefer a manual install?</summary>
  100. ```bash
  101. git clone https://github.com/anasAsh/Sibawayh.git
  102. cd Sibawayh
  103. ln -s "$PWD/skills/arabic-writing" ~/.claude/skills/arabic-writing
  104. # or: cp -r skills/arabic-writing ~/.claude/skills/
  105. ```
  106. From a shell, the plugin commands are `claude plugin marketplace add anasAsh/Sibawayh` and `claude plugin install arabic-writing@sibawayh`.
  107. </details>
  108. ### Cursor, GitHub Copilot and other agents
  109. Copy `skills/arabic-writing/` into your tool's skills folder; check its documentation for the path. The skill uses the standard `SKILL.md` format. If an agent has no shell, it falls back to the checklist alone.
  110. ## 🔍 Run the checker yourself
  111. It needs Python 3.8 or later and nothing else.
  112. ```bash
  113. python3 skills/arabic-writing/scripts/check_arabic.py file.md # report findings
  114. python3 skills/arabic-writing/scripts/check_arabic.py --fix file.md # print text with safe fixes applied
  115. python3 skills/arabic-writing/scripts/check_arabic.py --json - # JSON findings from stdin
  116. ```
  117. | Severity | Meaning |
  118. |---|---|
  119. | `fix` | certain; applied by `--fix` |
  120. | `error` | almost always wrong |
  121. | `warn` | probably wrong; check the context |
  122. | `info` | style or consistency note |
  123. <details>
  124. <summary>More options</summary>
  125. - `--digits western|arabic|auto` sets the expected digit system. The default, `auto`, follows the majority in the text.
  126. - Exit code: `1` when findings above `info` remain, otherwise `0`.
  127. - Never touched: code blocks, inline code, URLs, file paths, emails, YAML front matter, Qur'an quotes in ﴿…﴾, and anything between `<!-- arabic-check: off -->` and `<!-- arabic-check: on -->`.
  128. </details>
  129. ## 🗂️ What's inside
  130. ```
  131. skills/arabic-writing/
  132. ├── SKILL.md writing rules, workflow, checklist
  133. ├── references/
  134. │ ├── grammar.md agreement, numbers, case endings
  135. │ ├── orthography.md hamza, ة/ه, ى/ي, punctuation, digits, RTL
  136. │ ├── style.md translationese → natural Arabic
  137. │ ├── common-errors.md قل ولا تقل
  138. │ ├── approved-forms.md never "fix" these
  139. │ └── glossary.md 450+ tech terms, English → Arabic
  140. └── scripts/
  141. ├── check_arabic.py the checker (stdlib only)
  142. ├── archeck/ rules
  143. └── data/ word lists
  144. evals/ before/after evaluation harness
  145. tests/ unit tests
  146. research/ the research the rules are built on
  147. ```
  148. ## 📊 Evaluation
  149. The harness in [`evals/`](evals/README.md) answers 50 realistic prompts with and without the skill. A native speaker scores both versions blind, without knowing which is which. The success bar is **zero over-corrections** and **about 50% fewer errors per 100 words**, with no category getting worse. **Triggering** (does the skill load when it should?): **18/20** in a first run.
  150. - All 14 requests in Arabic, or for Arabic output, loaded the skill. That includes summarise, rewrite and proofread.
  151. - All 4 English-only requests correctly left it unloaded.
  152. - The 2 dialect requests did not load it.
  153. **Pilot quality check** (10 prompts, judged blind by an AI model from a different family; see [`evals/ai_judge.md`](evals/ai_judge.md)):
  154. - The Sibawayh version was preferred in **7 of 10** pairs.
  155. - Grammar and translationese errors went from **8 to 0**.
  156. This is a pilot, not a measured claim. The human-scored evaluation is still to come.
  157. ## 🤝 Contribute
  158. Native-speaker review is the most valuable contribution. Three ways to help:
  159. - 💻 **Glossary.** Suggest better or more standard terms in [`glossary.md`](skills/arabic-writing/references/glossary.md). Some terms, such as epoch, tokenization and pipeline, still have no settled Arabic equivalent.
  160. - 📝 **Word lists.** Add misspellings to `scripts/data/*.tsv`. The rule is strict: an entry must be wrong in *every* context, and each entry needs a test.
  161. - 🚩 **False flags.** If the checker flags correct Arabic, [open an issue](https://github.com/anasAsh/Sibawayh/issues) with the sentence.
  162. Run the tests before opening a pull request:
  163. ```bash
  164. python3 -m unittest discover -s tests -t .
  165. ```
  166. ## 📄 License
  167. MIT, see [`LICENSE`](LICENSE). The project contains no GPL code. Any entries adapted from LanguageTool (LGPL) would live only in `skills/arabic-writing/scripts/data/third_party/`, with their own licence notice.
  168. <div align="center">
  169. <br>
  170. <sub>Built for Arabic speakers who are tired of AI that writes <i>almost</i> right. 🌙</sub>
  171. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.