Skip to content
specailm5Public

About

Arabic intent-router for AI agents — selects the right skill set, with writing and grammar as baseline

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

قلم (Qalam)

مستودع مهارات للكتابة العربية يضيفها إلى وكيلك الذكي، فتصحح أخطاءه في العربية، وتحسّن أسلوبه، وتكتب ما تطلبه: قصة، مقالاً، خبراً، خطبة، بحثاً، أو ترجمة.

License Last commit Docs Agent Skills Arabic

🔗 الموقع المرجعي (الأنواع والأمثلة والتفاصيل): specailm5.github.io/qalam

English: a repository of Arabic writing skills for AI agents. It fixes the model's Arabic errors, improves its style, and covers every kind of Arabic writing. Works with Claude Code, Codex, Antigravity and VS Code agent harnesses.


📖 ماذا يعطيك قلم؟

وكيلك يكتب بالعربية، لكنه يخطئ: يترجم حرفياً، ويستعمل لغة الإنشاءات، ويخلط بين أنواع الكتابة. بعد تثبيت قلم:

  • أسلوب عربي طبيعي — بعيد عن الترجمة الحرفية والعَرَنْجِيَّة.
  • نحو وإعراب مضبوطان — يصحح الجملة قبل أن يسلّمها.
  • لكل نوع أصوله — القصة لها بناؤها، والخبر له بنيته، والخطبة لها فقهها، والبحث له توثيقه.
  • مراجعة قبل التسليم — يصلك النص محرَّراً، لا مسودة تحتاج تصحيحاً منك.
  • أسئلة قليلة — لا يسأل إلا عمّا يغيّر النتيجة: العمر في حكاية الأطفال، والمذهب في الخطبة، والجمهور في الإعلان.

⚡ ابدأ في دقيقة

المتطلبات

  • وكيل يدعم Agent Skills — Claude Code، Codex، Antigravity، أو VS Code agent harness.
  • Node.js 22.20 أو أحدث مع npx — لتشغيل مثبّت skills.

١. ثبّت قلم مع أساس اللغة

npx skills add specailm5/qalam -g -y
npx skills add specailm5/arabic-writing-skill -g -y
npx skills add specailm5/arabic-grammar-skill -g -y
npx skills add specailm5/arabic-editing-skill -g -y

٢. تحقق من التثبيت

npx skills list

٣. أول نتيجة

اكتب في وكيلك:

«اكتب حكاية للأطفال عن الصدق»

فيسألك عن العمر، ثم يكتب الحكاية بأسلوب عربي سليم، ويراجعها قبل أن يسلّمها.

أضف الأنواع التي تحتاجها

npx skills add specailm5/arabic-story-skill -g -y
npx skills add specailm5/arabic-children-story-skill -g -y
npx skills add specailm5/arabic-essay-skill -g -y
التثبيت اليدوي (بدون npx)

Windows

$src = "skills\qalam"

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude\skills\qalam"
Copy-Item -Recurse -Force "$src\*" "$env:USERPROFILE\.claude\skills\qalam\"

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.agents\skills\qalam"
Copy-Item -Recurse -Force "$src\*" "$env:USERPROFILE\.agents\skills\qalam\"

macOS / Linux

src=skills/qalam

mkdir -p ~/.claude/skills/qalam
cp -r "$src/." ~/.claude/skills/qalam/

mkdir -p ~/.agents/skills/qalam
cp -r "$src/." ~/.agents/skills/qalam/

بدون بيئة برمجية: انسخ محتوى skills/qalam/SKILL.md إلى التعليمات المخصصة أو System Prompt، ومعه مهارات الأساس.


🗂️ الأنواع

النوع ما تحصل عليه التفاصيل
لغة وأسلوب صياغة عربية سليمة، بلا ترجمة حرفية ولا عَرَنْجِيَّة docs
نحو وإعراب ضبط الجملة وتصحيح الأخطاء النحوية docs
تحرير مراجعة نهائية للأسلوب والبنية قبل التسليم docs
بلاغة تحليل الصورة وصناعتها ونقدها docs
قصة بناء القصة وشخصياتها ونهايتها docs
سيناريو مشاهد وحوار لفيلم أو مسلسل أو مسرح docs
حكايات أطفال حكاية مناسبة لعمر الطفل وجمهوره docs
مقال مقال رأي أو عمود أو خاطرة docs
بحث سؤال وفجوة وخطة وتوثيق أكاديمي docs
ترجمة ترجمة أمينة تحافظ على الأسلوب docs
خطبة خطبتان على أصولهما، وفقه المذاهب، ونصوص متحققة docs
إعلام خبر وتقرير وتحقيق بتحقق من المصادر docs
إعلان نص تسويقي لجمهوره ووسيطه docs

قادم: الشعر، الرواية الطويلة، المسرح، الحكايات المصورة والتفاعلية.


🧩 أمثلة

تكتب ما يحدث
«اكتب قصة قصيرة عن الغربة» يسأل عن الطول والنهاية، ثم يكتب القصة
«اكتب حكاية للأطفال عن الصدق» يسأل عن العمر، ثم يكتب الحكاية
«اكتب مقالاً عن التعليم» يسأل عن نوع المقال، ثم يكتبه
«اكتب بحثاً عن الذكاء الاصطناعي» يسأل عن المستوى والتوثيق، ثم يبني الخطة
«اكتب خطبة جمعة عن الصبر» يسأل عن المذهب، ثم يكتب الخطبتين
«ترجم هذا المقال» يسأل عن الاتجاه والمجال، ثم يترجم
«صحح النحو في هذا النص» يعيد النص مضبوطاً ويبيّن الأخطاء
«حرّر هذا النص» يراجع الأسلوب والبنية قبل التسليم
«أعد صياغته بأسلوب أفضل» يعيد الصياغة بأسلوب عربي طبيعي
«حلّل الاستعارة في هذا البيت» يشرح الصورة ووجه الشبه وأثرها
«اكتب إعلاناً لتطبيق ميزانية» يسأل عن الجمهور والدليل، ثم يكتب


📚 عن المشروع

قلم مستودع مهارات: كل نوع حزمة مستقلة، وسجلّها الكامل — الروابط وأوامر التثبيت وما تحتاجه كل حزمة — في references/registry.json. لمن يريد الجانب التقني: SKILL.md وrouting_rules.md.


🤝 المساهمة

نرحب بالمساهمات التي تحسّن الأمثلة أو التوصيف أو التوثيق. اقرأ CONTRIBUTING.md قبل فتح طلب سحب، والتزم بـقواعد السلوك.

🛡️ الأمان

إن وجدت مشكلة أمنية، فلا تفتح قضية عامة؛ راجع SECURITY.md.

📄 سجل التغييرات

راجع CHANGELOG.md.

📬 الدعم

للأسئلة والاقتراحات: افتح قضية.


📜 الترخيص

هذه المهارة مفتوحة المصدر تحت رخصة MIT.

About

Arabic intent-router for AI agents — selects the right skill set, with writing and grammar as baseline

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors