مهارة الكتابة العربية الفصيحة ونبذ العَرَنْجِيَّة

(Arabic Writing Skill — Anti-Aranjiya)

Arabic writing skill for AI agents — strips English calques and translated phraseology (العَرَنْجِيَّة) from Arabic text: قام بزيارة ← زار, تم التوقيع بواسطة ← وقّع. Works with Claude Code, Codex, Antigravity and VS Code agent harnesses.

🔗 الموقع المرجعي (المعجم والتراكيب والنماذج): specailm5.github.io/arabic-writing-skill

مهارة برمجية ولغوية احترافية لنماذج الذكاء الاصطناعي والمحررات الذكية (Codex، Claude Code، Antigravity IDE، VS Code Agent Harness) لتدقيق النصوص والترجمات العربية وتخليصها من «العَرَنْجِيَّة» (الأساليب والتراكيب الإفرنجية المنقولة بلفظها)، استناداً إلى كتاب «العَرَنْجِيَّة: بلغات أعجمية وألسن عربية» للترجمان أحمد الغامدي.

🎬 عرض توضيحي (Demo)

📖 ما هي المهارة؟

العَرَنْجِيَّة (نحتٌ من: عربية + إفرنجية) هي التعبير عن الأفكار والتراكيب الغربية بألفاظ عربية؛ فتكون الجملة مستقيمة الإعراب ظاهراً، لكنها إفرنجيةٌ في جوهرها وبنائها ورصف ألفاظها (مثل: كثرة الأفعال المساعدة قام بزيارة بدلاً من زار، والمبني للمجهول المرفوق بالفاعل تم التوقيع بواسطة فلان بدلاً من وقّع فلان، والتكلف في أدوات الربط مثل حيث أن، من خلال، على صعيد).

تُمكِّنُ هذه المهارةُ الوكيلَ الذكيَّ (AI Agent) من كتابة النصوص العربية وتدقيقها على سَنَن كلام العرب الفصحاء، وحفظ لسان الكاتب والمترجم من العجمة الهجينة المعاصرة.

📂 بنية المهارة ومكوناتها

arabic-writing-skill/
│
├── skills/arabic-writing-skill/          # المهارة (تركيب Agent Skills القياسي)
│   ├── SKILL.md                          # الدليل الأساسي للمهارة (الأصول والأوامر والنواهي)
│   ├── references/                       # المعاجم والجداول المرجعية التفصيلية
│   │   ├── vocabulary_and_idioms.md      # معجم الألفاظ والتعابير العرنجية وبدائلها الفصيحة
│   │   └── stylistic_patterns.md         # سجل التحويلات الأسلوبية والنحوية المتقدمة
│   └── examples/                         # دراسات الحالة والنماذج التطبيقية
│       └── before_after_texts.md         # نماذج كاملة (سياسية، إدارية، فكرية) قبل وبعد التحوير
│
├── docs/                                 # الموقع المرجعي الإلكتروني والتوثيق (GitHub Pages)
│
├── .agents/skills/arabic-writing-skill/  # مسار الاكتشاف التلقائي لبيئات Codex و Antigravity
│
└── .claude/skills/arabic-writing-skill/  # مسار الاكتشاف التلقائي لبيئة Claude Code

🚀 طرق التثبيت والاستخدام (Installation Guide)

تُثبَّتُ المهارةُ إما في مشروعٍ بعينه (محلياً)، وإما عامةً (Global) لتعمل في كافة المشاريع.

أولاً: التثبيت بأمر واحد عبر npx (الطريقة الأسرع — موصى به)

تُثبَّت المهارة في بيئات الوكلاء المدعومة (Claude Code، Codex، Opencode، Cursor، Gemini وغيرها) بأمرٍ واحد عبر مدير مهارات الوكلاء:

npx skills add specailm5/arabic-writing-skill -g -y

ولاختيار بيئات بعينها أو التثبيت داخل مشروع محدد:

npx skills add specailm5/arabic-writing-skill -a claude-code -a codex
npx skills add specailm5/arabic-writing-skill --skill arabic-writing-skill -g -y

ثانياً: التثبيت العام لبيئة Claude Code و Codex و Antigravity (يدوياً)

لتفعيل المهارة في كل مشروعاتك من غير أن تكرر تثبيتها في كل مجلد:

لنظام Windows (PowerShell):

# مصدر المهارة داخل المستودع
$src = "skills\arabic-writing-skill"

# 1. تثبيت لبيئة Claude Code
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude\skills\arabic-writing-skill"
Copy-Item -Recurse -Force "$src\*" "$env:USERPROFILE\.claude\skills\arabic-writing-skill\"

# 2. تثبيت لبيئة Codex و Agent Skills العامة
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.agents\skills\arabic-writing-skill"
Copy-Item -Recurse -Force "$src\*" "$env:USERPROFILE\.agents\skills\arabic-writing-skill\"

# 3. تثبيت لبيئة Google Antigravity / Gemini
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.gemini\config\skills\arabic-writing-skill"
Copy-Item -Recurse -Force "$src\*" "$env:USERPROFILE\.gemini\config\skills\arabic-writing-skill\"

لنظام macOS / Linux (Bash):

src=skills/arabic-writing-skill

# 1. لبيئة Claude Code
mkdir -p ~/.claude/skills/arabic-writing-skill
cp -r "$src/." ~/.claude/skills/arabic-writing-skill/

# 2. لبيئة Codex و Agent Harness
mkdir -p ~/.agents/skills/arabic-writing-skill
cp -r "$src/." ~/.agents/skills/arabic-writing-skill/

# 3. لبيئة Antigravity / Gemini
mkdir -p ~/.gemini/config/skills/arabic-writing-skill
cp -r "$src/." ~/.gemini/config/skills/arabic-writing-skill/

ثالثاً: التثبيت المحلي داخل مشروع محدد (VS Code Workspace Harness)

إذا أردت حصر المهارة داخل مستودع أو مجلد عمل واحد في VS Code:

1. انسخ مجلد المهارة داخل مجلد .agents/skills/ أو .claude/skills/ في جذر مشروعك:

# داخل مجلد مشروعك الحالي:
New-Item -ItemType Directory -Force -Path ".agents\skills\arabic-writing-skill"
Copy-Item -Recurse -Force "path\to\skills\arabic-writing-skill\*" ".agents\skills\arabic-writing-skill\"

1. بمجرد فتح المشروع في VS Code أو تشغيل Claude Code / Codex، يكتشفُ الوكيلُ المهارةَ ويقرؤها من تلقاء نفسه عند صياغة أي نص باللغة العربية.

رابعاً: الاستخدام اليدوي (Direct System Prompt / Custom Instructions)

إذا كنت تستخدم واجهات الويب (مثل ChatGPT أو Claude أو Gemini) مباشرة دون بيئة برمجية:

• افتح ملف skills/arabic-writing-skill/SKILL.md وانسخ محتواه وضعه في خانة التعليمات المخصصة (Custom Instructions) أو System Prompt.

⚡ كيف تعمل المهارة؟ (أوامر ونواهٍ سريعة)

📚 المراجع والاعتماد

• كتاب «العَرَنْجِيَّة: بلغات أعجمية وألسن عربية»، للترجمان أحمد الغامدي (الطبعة الثانية 1445هـ / 2023م).
• نصوص وشواهد الأوائل (الجاحظ في «البيان والتبيين» و«البخلاء»، القاسم بن سلام في «الأموال»، نهج البلاغة، صحيح البخاري).

🤝 المساهمة

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

🛡️ الأمان

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

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

راجع CHANGELOG.md لمعرفة ما أُضيف في كل إصدار.

📬 الدعم

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

📜 الترخيص (License)

هذه المهارة مفتوحة المصدر ومتاحة للاستخدام الشخصي والتجاري والبحثي لدعم وتعزيز الفصاحة والبيان في الذكاء الاصطناعي.