من الفكرة إلى SKILL.md جاهز للنشر — التخطيط، الكتابة، الاختبار، التوزيع، وأنماط الحلول الجاهزة، بالإضافة لقوالب عملية تبدأ منها مباشرة.
ست محطّات تأخذك من فهم مفهوم الـ Skill حتى بناء واحدة ونشرها فعلياً — بالتفاصيل والأمثلة.
كل فصل مبني على الذي قبله — إن كنت تبني skill مستقلة ركّز على الفصول 1، 2، و5. وإن كنت تُحسّن تكامل MCP فأضف قسم "Skills + MCP".
الـ Skill مجموعة تعليمات — معبّأة في مجلّد بسيط — تُعلّم Claude كيف يتعامل مع مهام أو سير عمل محدّد.
الـ Skill تُبنى من مجلّد يحتوي: SKILL.md (إلزامي)، ومجلدات اختيارية scripts/ و references/ و assets/.
كلا المسارين يشتركان في نفس المتطلبات التقنية، لكن تختار ما يهمّ حالتك.
كلا المسارين يوصلانك لنفس الهدف: skill جاهزة للاستخدام، مبنيّة بشكل صحيح من أول مرّة.
مما تتكوّن الـ Skill، وما المبادئ الثلاثة التي تجعلها فعّالة: الإفصاح التدريجي، التركيب، والقابلية للنقل.
ملف واحد إلزامي، وثلاثة مجلدات اختيارية — كل عنصر له دور محدد.
ابدأ بـ SKILL.md فقط. أضف scripts أو references أو assets لاحقاً فقط عندما تحتاجها فعلاً.
هذا المبدأ هو ما يجعل Claude يستطيع تفعيل مئات الـ skills دون إرهاق الذاكرة السياقية.
كل مستوى يُحمَّل فقط عند الحاجة إليه — هذا ما يقلّل استهلاك التوكنز مع الحفاظ على الخبرة المتخصصة.
الإفصاح التدريجي يقلّل استهلاك التوكنز مع الحفاظ على خبرة متخصصة كاملة عند الحاجة إليها.
الـ skill الجيدة لا تفترض أنها وحدها، ولا تتغيّر حسب مكان تشغيلها.
صمّم الـ skill وكأنّها ستعمل بجانب عشرات غيرها، وعلى منصّة لا تتحكّم بها بالكامل.
إن كنت تبني skill مستقلة بلا MCP، يمكنك تخطّي هذه الصفحة والعودة إليها لاحقاً.
إن كان لديك خادم MCP يعمل، فقد أنجزت الجزء الأصعب. الـ Skills هي طبقة المعرفة فوقه.
معاً، يُمكّنان المستخدمين من إنجاز مهام معقّدة دون الحاجة لمعرفة كل خطوة بأنفسهم.
الفرق بين ربط تكامل والمستخدم تائه، وبين تجربة تعمل من أول محاولة.
الـ Skills تجعل تكامل الـ MCP الخاص بك مكتملاً — تمنحك أفضلية أمام البدائل التي تعتمد على MCP فقط.
من حالة الاستخدام إلى الـ YAML frontmatter — كل قرار تصميمي يحدّد هل ستُفعَّل الـ skill في اللحظة الصحيحة أم لا.
حالة استخدام مكتوبة جيداً توضّح: متى تُفعَّل الـ skill، وما الخطوات، وما النتيجة المتوقّعة.
حالة استخدام محدّدة بوضوح هي أساس كل قرار تصميمي لاحق في بناء الـ skill.
كما لاحظنا في Anthropic — معظم الـ skills الناجحة تقع ضمن واحدة من هذه الفئات.
معرفة أي فئة تناسب حالتك يوجّهك مباشرة لأنماط البناء المناسبة في الفصل الخامس.
أهداف استرشادية أكثر من كونها عتبات دقيقة — اجتهد بصرامة لكن تقبّل عنصر التقييم الحسّي.
Anthropic تعمل حالياً على تطوير إرشادات وأدوات قياس أكثر نضجاً لهذا الجانب.
قواعد بسيطة، لكن مخالفتها تمنع رفع الـ skill بالكامل.
هذه القواعد الثلاث هي أكثر أسباب فشل رفع الـ skill شيوعاً — تحقّق منها أولاً عند أي خطأ.
الـ YAML frontmatter هو كيف يقرّر Claude تحميل الـ skill من عدمه — احرص على كتابته بدقّة.
حقلان فقط مطلوبان للبدء — لكن جودتهما تحدّد مصير الـ skill بالكامل.
---
name: your-skill-name
description: What it does. Use when
user asks to [specific phrases].
---هذا كل ما تحتاجه للبدء فعلياً — بقية الحقول اختيارية بالكامل.
مرونة أكبر في التوثيق — لكن مع قيود واضحة لحماية سلامة النظام.
السبب: الـ frontmatter يظهر داخل الـ system prompt الخاص بـ Claude — أي محتوى ضار قد يحاول حقن تعليمات.
البنية الذهبية: [ماذا تفعل] + [متى تُستخدَم] + [القدرات الأساسية].
اختبر وصفك: اسأل Claude "متى تستخدم skill [الاسم]؟" — سيقتبس الوصف. عدّل بناءً على ما ينقص.
عدّل هذا القالب حسب الـ skill الخاصة بك — استبدل الأقسام بين قوسين بمحتواك الفعلي.
استخدم الإفصاح التدريجي: أبقِ SKILL.md مركّزاً على التعليمات الأساسية، وانقل التوثيق التفصيلي إلى references/ مع رابط إليه.
التعليمات المحدّدة تُنفَّذ. التعليمات الغامضة تُفسَّر بطرق مختلفة في كل مرّة.
للتحقّقات الحرجة، فكّر بتضمين سكربت يقوم بالفحص برمجياً بدل الاعتماد على تفسير اللغة — الكود حتمي، أمّا اللغة فلا.
الـ skills وثائق حيّة. من الاختبار اليدوي السريع إلى التقييم البرمجي عبر الـ API — اختر الصرامة المناسبة لحالتك.
اختر المستوى المناسب لمدى ظهور الـ skill الخاصة بك — فريق داخلي صغير يختلف عن آلاف المستخدمين.
ابنِ أساساً ناجحاً على مهمّة واحدة أولاً، ثم وسّع لحالات اختبار متعدّدة للتغطية الكاملة.
الهدف: التأكّد من أن الـ skill تُحمَّل في الأوقات الصحيحة فقط — لا أكثر ولا أقلّ.
شغّل 10–20 استعلام اختبار يجب أن تُفعِّل الـ skill، وتتبّع كم مرّة تُحمَّل تلقائياً مقابل الحاجة لتفعيل يدوي.
قارن نفس المهمّة بوجود الـ skill وبدونها — الأرقام تتحدّث.
استخدم مقاييس "معايير النجاح" من الفصل الثاني لبناء هذه المقارنة على بياناتك الفعلية.
الـ skills وثائق حيّة — خطّط للتكرار المستمر بناءً على ثلاث إشارات رئيسية.
"استخدم skill-creator لبناء skill لـ [حالتك]" — يولّد SKILL.md صحيح البنية، ويقترح عبارات تشغيل وحالات اختبار، ويراجع الإصدارات السابقة.
من الرفع الفردي إلى النشر على مستوى المؤسسة، ومن الاستخدام عبر الواجهة إلى الأتمتة الكاملة عبر الـ API.
من التنزيل الفردي إلى النشر التلقائي على مستوى المؤسسة بالكامل.
كل تحديث ينتشر تلقائياً — لا حاجة لإعادة توزيع يدوي للفِرَق.
للاستخدامات البرمجية — بناء تطبيقات أو وكلاء أو سير عمل آلي — يمنحك الـ API تحكماً مباشراً.
| حالة الاستخدام | Best Surface |
|---|---|
| مستخدمون يتفاعلون مع الـ skills مباشرة | Claude.ai / Claude Code |
| اختبار وتكرار يدوي أثناء التطوير | Claude.ai / Claude Code |
| سير عمل فردي غير متكرّر | Claude.ai / Claude Code |
| تطبيقات تستخدم الـ skills برمجياً | API |
| نشر إنتاجي على نطاق واسع | API |
| أنابيب آلية وأنظمة وكلاء | API |
ملاحظة: الـ skills عبر الـ API تتطلّب ميزة Code Execution Tool (beta) — توفّر البيئة الآمنة التي تحتاجها الـ skills للتشغيل.
مستودع عام، README واضح للزوّار البشريين، وأمثلة استخدام بلقطات شاشة.
مستودع الـ skill نفسه يجب ألّا يحتوي README.md — الـ README هنا على مستوى المستودع لزوّار GitHub البشريين فقط.
كيف تصف الـ skill في الـ README أو التوثيق أو التسويق يحدّد هل سيجرّبها المستخدمون أصلاً.
أبرِز قصّة "MCP + Skills معاً": الـ MCP يمنح Claude الوصول، والـ Skill تُعلّمه سير عمل فريقك — معاً يُمكّنان إدارة مشاريع مدعومة بالذكاء الاصطناعي.
أنماط ظهرت من skills بناها متبنّون أوائل وفرق داخلية — تمثّل نُهجاً شائعة أثبتت نجاحها، لا قوالب إلزامية.
تماماً كمتجر Home Depot: قد تدخل بمشكلة "أحتاج أصلح خزانة مطبخي" فيوجّهك الموظّف للأداة الصحيحة — أو تختار مثقاباً وتسأل كيف تستخدمه لمهمّتك.
مُعظم الـ skills تميل لاتّجاه واحد — معرفة أيّهما يناسب حالتك يوجّهك للنمط الصحيح.
حدّد أي إطار يناسب حالة الاستخدام لديك قبل اختيار أحد الأنماط الخمسة التالية.
اختر النمط الأقرب لطبيعة سير العمل الذي تبنيه.
راجع أمثلة كل نمط في المصادر المرفقة — Sequential Orchestration، Multi-MCP، Iterative Refinement، Context-Aware Selection، Domain Intelligence.
أكثر ثلاث مشاكل شيوعاً عند البدء — وحلّها المباشر.
اختبار تشخيصي سريع: اسأل Claude "متى تستخدم skill [الاسم]؟" وقارن الإجابة بما تنوي فعلاً.
حين تُحمَّل الـ skill لكن النتائج ليست كما هو متوقّع.
للكسل النموذجي: أضف تشجيعاً صريحاً — "خذ وقتك للتأكّد من الجودة، لا تتخطَّ خطوات التحقّق" — هذا أكثر فعالية في الـ prompt من كتابته في SKILL.md.
إن كانت هذه أوّل skill تبنيها، ابدأ بدليل أفضل الممارسات، ثم ارجع للمراجع التقنية عند الحاجة.
التوثيق الرسمي، مستودع الأمثلة، وأداة skill-creator لبناء ومراجعة الـ skills.
ابدأ من دليل أفضل الممارسات، ثم راجع مراجع API التقنية عند الحاجة فقط.
استخدمها للتحقّق من الـ skill قبل وبعد الرفع — أو ابدأ بـ skill-creator ثم راجع هذه القائمة.
الحقول المطلوبة فقط: name (kebab-case) و description (ماذا + متى، أقل من 1024 حرفاً، بلا < >).
قالبان جاهزان لطلب Claude ببنائهما — الصقهما مباشرة في المحادثة وعبّئ الأقواس بمحتواك.
الأنسب حين يكون لديك مستند موجود (دليل أسلوب، عملية، معيار) وتريد تحويله مباشرة.
الأبسط للبدء — مثالي حين يكون لديك مصدر جاهز تريد Claude يستخرج منه الـ skill.
الأنسب حين تبني skill من الصفر بلا مستند مصدر — عبّئ كل قسم بعناية.
استخدم skill-creator لضمان بنية SKILL.md الصحيحة، واحفظها داخل .claude/skills/[skill-name]/ جاهزة للاستخدام الفوري.
ابدأ بحالة استخدام واحدة، اكتب وصفاً محدّداً، اختبر التفعيل، وكرّر. 15 إلى 30 دقيقة تفصلك عن أول skill عاملة.