awesome-arabic-claude-skills：面向 Claude Code 的阿拉伯语技能库

قائمة مختارة ومكتبة مهارات مفتوحة المصدر لـ Claude Code ووكلاء الذكاء الاصطناعي، مخصصة للغة العربية، تعريب البرمجيات (RTL)، الترجمة المرئية، صياغة المحتوى، والمعالجة اللغوية.
A curated directory and open-source skill library for Claude Code and AI agents, specifically engineered for the Arabic language, RTL localization, subtitling, copywriting, and NLP.

الفهرس / Table of Contents

Awesome Arabic Claude Skills | مهارات كلود العربية 🌟

نظرة عامة / Overview

تتيح مهارات كلود (Claude Skills) توسيع قدرات نموذج الذكاء الاصطناعي بسياق متخصص وقواعد عمل دقيقة وتعليمات برمجية جاهزة. يهدف هذا المستودع إلى أن يكون المرجع العربي الأول لهذه المهارات، حيث يجمع بين:

مهارات مدمجة (Native Built-in Skills) جاهزة للاستخدام المباشر داخل مجلد skills/.
فهرس متجدد (Curated Catalog & Registry) لجميع المهارات والمستودعات ومخدمات MCP العربية في مجتمع المطورين.
مزامنة تلقائية (Auto-Sync via GitHub Actions) للتحقق من المهارات وتحديث الفهارس وسجل skills.json آلياً عند كل تحديث أو مساهمة.

طريقة التثبيت والاستخدام / Installation & Usage

1. تثبيت مهارة محددة عبر `npx skills` (Universal Skills)

يمكنك تثبيت أي مهارة من هذا المستودع مباشرة في مشروعك أو على مستوى نظامك العام:

# تثبيت مهارة محددة في مجلد المشروع الحالي
npx skills add EngDawood/awesome-arabic-claude-skills --skill arabic-subtitling

# تثبيت المهارة عامةً لجميع مشاريع Claude Code و Cursor
npx skills add EngDawood/awesome-arabic-claude-skills --skill arabic-localization-rtl -g

2. التثبيت اليدوي مع Claude Code

انسخ مجلد المهارة المطلوبة من skills/ إلى مجلد مهارات كلود في مشروعك:

# في مجلد مشروعك
mkdir -p .claude/skills
cp -r /path/to/awesome-arabic-claude-skills/skills/arabic-copywriting .claude/skills/

أو أضفها إلى إعدادات كلود العامة في جهازك:

نظام لينكس / ماك: ~/.claude/skills/
نظام ويندوز: %USERPROFILE%\.gemini\config\skills\ أو %USERPROFILE%\.claude\skills\

فهرس المهارات المحدث تلقائياً / Auto-Synced Skills Catalog

يتم تحديث هذا الجدول وسجل skills.json تلقائياً عبر GitHub Actions بمجرد إضافة أو تعديل أي مهارة.

المهارة (Skill)	التصنيف (Category)	الوصف (Description)	التثبيت والاستخدام (Install / Link)
arabic-academic-research البحث والتوثيق الأكاديمي وتحقيق النصوص العربية (مدمجة / Native)	`Academic & Research`	Guide Arabic academic research writing, citation formatting (APA 7th Arabic edition, Chicago, MLA), manuscript editing (تحقيق التراث), and scholarly reference auditing. Use when drafting or formatting Arabic academic papers, theses, bibliographies, Islamic/historical terminology, or when citing Arabic primary and secondary sources.	`npx skills add EngDawood/awesome-arabic-claude-skills --skill arabic-academic-research`
arabic-copywriting صياغة المحتوى العربي والكتابة الإعلانية والتحريرية (مدمجة / Native)	`Content & Copywriting`	Craft high-converting Arabic marketing copy, UX microcopy, and editorial content. Eliminates literal translation artifacts (الترجمة الحرفية الركيكة), establishes authentic tone of voice, and sharpens Arabic rhetoric. Use when writing, editing, or auditing Arabic articles, UI microcopy, landing page headlines, emails, or brand messaging.	`npx skills add EngDawood/awesome-arabic-claude-skills --skill arabic-copywriting`
arabic-localization-rtl تعريب البرمجيات وهندسة واجهات RTL (مدمجة / Native)	`Software & RTL Engineering`	Guide Arabic software localization, RTL layout adaptation, bidirectional text (BiDi) handling, Arabic typography, and pluralization. Use when building or refactoring UI components for Arabic, adapting CSS/Tailwind for RTL, handling mixed Arabic/English strings, or configuring i18next/Intl for Arabic locales (ar-SA, ar-EG, ar).	`npx skills add EngDawood/awesome-arabic-claude-skills --skill arabic-localization-rtl`
arabic-rtl-docs arabic-rtl-docs (مزامنة من GitHub / Synced)	`General`	Produce correctly-rendered right-to-left (RTL) Microsoft Office documents — Word (.docx), PowerPoint (.pptx), and Excel (.xlsx) — for Arabic, Hebrew, Persian, Urdu, and other RTL scripts. Use this skill whenever the user asks for a document in Arabic or another RTL language, or whenever the deliverable mixes RTL prose with English/Latin tokens (IBANs, URLs, emails, numbers). It must also be used whenever you produce a docx-js / openpyxl / python-pptx output that contains any RTL text, because those libraries do NOT apply section-level bidi, table direction, or heading bidi automatically — outputs that look correct in LibreOffice can still render as LTR (cells reversed, headings left-aligned, lists flipped) when opened in Microsoft Word. Trigger on phrases like "اكتب", "خطاب", "تقرير عربي", "Arabic letter", "RTL report", "بالعربي", "اللغة العربية", "Hebrew document", "Persian", or any user message written predominantly in an RTL script.	`npx skills add muhmoosa/claude-arabic-docs`
arabic-subtitling معايير الترجمة المرئية والتفريغ العربي (Netflix TTSG) (مزامنة من GitHub / Synced)	`Media & Localization`	Guidelines and QC tooling for adding Arabic subtitles or captions to video - Arabic-to-Arabic captions (transcription, SDH) and translated subtitles (English or other language into Modern Standard Arabic). Covers Netflix Timed Text Style Guide rules (42 chars/line, 2 lines, reading speed, timing/gaps/shot changes, numbers, quotes, ellipses, diacritics, songs, forced narratives), translation strategies for cultural references, and an SRT/VTT checker script. Use this skill whenever the user wants Arabic subtitles, captions, ترجمة فيديو, ترجمة مرئية, تفريغ نصي, تسميات توضيحية, SRT/VTT/TTML files, burning captions into a video, translating a video transcript to Arabic, or reviewing/fixing existing Arabic subtitles - even if they never say "Netflix" or "style guide".	`npx skills add EngDawood/arabic-video-subtitles-skill --skill arabic-subtitling`
arabic-subtitling-guidelines arabic-subtitling-guidelines (مدمجة / Native)	`General`	Guidelines and QC tooling for adding Arabic subtitles or captions to video - Arabic-to-Arabic captions (transcription, SDH) and translated subtitles (English or other language into Modern Standard Arabic). Covers Netflix Timed Text Style Guide rules (42 chars/line, 2 lines, reading speed, timing/gaps/shot changes, numbers, quotes, ellipses, diacritics, songs, forced narratives), translation strategies for cultural references, and an SRT/VTT checker script. Use this skill whenever the user wants Arabic subtitles, captions, ترجمة فيديو, ترجمة مرئية, تفريغ نصي, تسميات توضيحية, SRT/VTT/TTML files, burning captions into a video, translating a video transcript to Arabic, or reviewing/fixing existing Arabic subtitles - even if they never say "Netflix" or "style guide".	`npx skills add EngDawood/awesome-arabic-claude-skills --skill arabic-subtitling-guidelines`
arabic-tashkeel-nlp التشكيل والتدقيق اللغوي ومعالجة النصوص العربية (NLP) (مدمجة / Native)	`Language & NLP`	Guide Arabic diacritization (Tashkeel/Harakat), grammatical inflection (I'rab), and Arabic NLP preprocessing (normalization, lemmatization, root extraction). Use when adding diacritics to Arabic text, preparing text for Arabic Text-to-Speech (TTS), fixing grammatical mistakes, or processing Arabic strings in NLP and search pipelines.	`npx skills add EngDawood/awesome-arabic-claude-skills --skill arabic-tashkeel-nlp`
video-caption-mcp video-caption-mcp (مزامنة من GitHub / Synced)	`General`	This skill should be used when the user asks to "caption this video", "burn subtitles into this TikTok", "translate this reel", "add Arabic captions to this video", "subtitle this YouTube short", "change the caption font", "fix this caption line", asks how to connect to or use the video-caption MCP server, or mentions its tools by name (submit_job, job_status, get_output, cancel_job, restyle_job, fix_script). Covers connecting to the /mcp endpoint, submitting a caption job, polling it, returning the finished download link, and restyling, correcting or stopping a job.	`npx skills add EngDawood/video-caption --skill video-caption-mcp`

أوامر كلود السريعة / Claude Code Slash Commands

تتضمن المهارات أوامر سريعة (Slash Commands) يمكن استدعاؤها مباشرة داخل Claude Code:

الأمر (Slash Command)	المعاملات (Arguments)	الوصف (Description)	ملف الأمر (File)
`/check-subtitles`	`file_path`	Run automated and manual QC checks on Arabic SRT or VTT subtitle files against Netflix TTSG rules.	`commands/check-subtitles.md`
`/translate-subtitles`	`text_or_subtitles`	Translate or adapt foreign dialogue into professional Modern Standard Arabic subtitles following Netflix TTSG and ECR strategies.	`commands/translate-subtitles.md`

أدوات ومخدمات MCP عربية / Arabic MCP Servers & Tools

مجموعة من مخدمات بروتوكول سياق النموذج (Model Context Protocol - MCP) والأدوات الداعمة للمحتوى والبيانات العربية:

الأداة / المخدم	الوصف	الرابط
Arabic Scholar MCP	مخدم MCP للبحث الأكاديمي والتحقيق والوصول للمصادر التراثية والإسلامية	المستودع
Mandumah MCP	تكامل واسترجاع الأبحاث والرسائل العلمية من قاعدة بيانات دار المنظومة	المستودع
Arabic Video Subtitles Skill	دليل معايير وقواعد الترجمة المرئية والتفريغ النصي العربي (Netflix TTSG)	المستودع
Thmanyah Font Web	حزمة وتطبيق ويب لخطوط ثمانية ودعم التيبوغرافيا العربية الحديثة	المستودع

المزامنة التلقائية عبر GitHub Actions / GitHub Actions Automation

يحتوي المستودع على منظومة متكاملة لأتمتة إضافة وتحديث المهارات:

فحص الترويسة والصيغة (Validation): التحقق من التزام كل ملف SKILL.md بمعايير صيغة YAML Frontmatter وعدم تجاوز الوصف لـ 1024 حرفاً ووجود معايير التفعيل.
تحديث سجل skills.json: توليد ملف JSON مهيكل يمكن للأدوات الخارجية وواجهات السطر البرمجي (CLI) قراءته برمجياً.
تحديث الـ README دورياً: حقن المهارات المدمجة والخارجية من sources.json مباشرة في جدول الفهرس أعلاه.
إضافة المهارات عبر الـ Issues والـ PRs: عند اعتماد مساهمة، يقوم الـ Workflow بمزامنة المحتوى فوراً.

دليل المساهمة / Contributing

نرحب بجميع المساهمات من المجتمع العربي والعالمي!

لإضافة مهارة جديدة: افتح Pull Request أو أرسل اقتراحك عبر نموذج المهارات.
للمزيد من التفاصيل، راجع دليل المساهمة CONTRIBUTING.md.

الترخيص / License

هذا المشروع مرخص تحت رخصة MIT. راجع ملف LICENSE لمزيد من التفاصيل.