ما هو ملف SKILL.md؟ ملف SKILL.md هو "البيان التعريفي" (manifest) الذي يقع في قلب كل مهارة ذكاء اصطناعي: مستند markdown صغير يخبر الوكيل الذكي مثل Claude أو Manus أو ChatGPT باسم المهارة، ومتى يستخدمها، وكيف يشغّلها خطوة بخطوة. عندما تُنزّل حزمة مهارة بصيغة ZIP من Mahara AI وتفكّ ضغطها، فإن ملف SKILL.md هو أول ما يقرؤه الوكيل — وكل ما تبقّى في الحزمة موجود فقط لدعمه. في هذا الدليل نفكّك هذا التنسيق جزءاً جزءاً، حتى تستطيع قراءته وفهمه وحتى كتابة ملفاتك الخاصة.
أصبحت المهارات الطريقة القياسية لتغليف سير العمل القابل لإعادة الاستخدام لأنها تحلّ مشكلة قديمة: الـ system prompts العملاقة. فبدلاً من لصق آلاف الكلمات في كل محادثة، تُثبِّت المهارة مرة واحدة، ثم يحمّلها الوكيل فقط في اللحظة التي يحتاجها فيها. ملف SKILL.md هو ما يجعل ذلك ممكناً. إذا كان المفهوم جديداً عليك، ابدأ بدليلنا الأساسي عن ما هي مهارة الذكاء الاصطناعي.
كيف تبدو حزمة المهارة الكاملة؟
المهارة مجلد، وليست ملفاً واحداً. في الأعلى يوجد ملف SKILL.md. وبجانبه قد تحمل المهارة مجلد references يحوي أدلة markdown إضافية، واختيارياً مجلد assets أو scripts يضم ملفات مساعدة تشير إليها التعليمات. عندما تضغط هذا المجلد بصيغة ZIP تحصل على الحزمة القابلة للتنزيل التي توزّعها منصات مثل Mahara AI. ملف البيان إلزامي؛ أما كل ما عداه فهو وزن اختياري تحمله المهارة عند الحاجة فقط.
ما الذي يوجد داخل ملف SKILL.md؟
يتكوّن ملف SKILL.md من طبقتين: ترويسة YAML قصيرة تُسمى frontmatter في أعلى الملف، تليها التعليمات المكتوبة بصيغة markdown عادية. الـ frontmatter هي بيانات وصفية — حقائق مقروءة آلياً عن المهارة. أما متن markdown فهو دليل التشغيل الفعلي. الجدول التالي يغطي كل جزء وفق البنية الحقيقية لمهارات Mahara.
| الجزء | وظيفته | مثال |
|---|---|---|
| الاسم في frontmatter | المعرّف الفريد للمهارة — يشترك فيه المجلد والبيان، ويستخدمه الوكيل عند عرض المهارة أو استدعائها | name: contract-review (مكتوب كمفتاح وقيمة YAML في أعلى الملف) |
| الوصف في frontmatter | جملة أو جملتان تخبران الوكيل متى يحمّل المهارة — شروط التفعيل | وصف يوضّح أن المهارة تُستخدم عندما يطلب المستخدم مراجعة عقد أو رصد بنود خطرة |
| التعليمات (متن markdown) | دليل تشغيل خطوة بخطوة يخبر الوكيل كيف ينفّذ سير العمل، وبأي ترتيب، وبأي صيغة إخراج | خطوات مرقّمة: اقرأ المستند، صنّف كل بند، علّم المخاطر، ثم أنشئ جدول ملخص |
| مجلد references | ملفات .md اختيارية — أدلة أعمق يفتحها الوكيل فقط عندما تتطلب الخطوة ذلك | ملف يغطي تكتيكات التفاوض لكل نوع من البنود الخطرة |
| مجلد assets أو scripts | ملفات دعم اختيارية: قوالب أو قوائم تحقق أو سكربتات تخبر التعليمات الوكيل باستخدامها | قالب قائمة تحقق للبنود يعبّئه الوكيل في كل مراجعة |
طريقة سهلة للتذكر: الوصف يخبر الوكيل متى يحمّل المهارة؛ والتعليمات تخبره كيف يشغّلها.
لماذا حقل الوصف هو أهم سطر في الملف؟
يحتفظ الوكلاء مثل Claude بعدة مهارات في آن واحد، لكنهم لا يقرؤونها كلها في كل محادثة — فذلك يهدر نافذة السياق (context window). بدلاً من ذلك، يُبقي الوكيل اسم كل مهارة ووصفها في ذاكرته، كما لو كان فهرس محتويات. وعندما يطابق طلبك الوصف، يسحب الوكيل ملف SKILL.md كاملاً إلى السياق ويتّبع خطواته. لهذا السبب تضع مهارات Mahara الجيدة في السطر الواحد للوصف عنايتها بالتعليمات نفسها: الوصف الغامض يعني أن المهارة لن تعمل أبداً؛ والوصف الدقيق يعني أنها ستعمل في اللحظة المناسبة تماماً.
لماذا تتفوق البيانات التعريفية على الـ system prompts العملاقة؟
الـ system prompt العملاق يعمل دائماً. يستهلك السياق في كل محادثة، ويربك الوكيل، ويخلط تعليمات لمهام لا تمارسها اليوم. أما المهارة المبنية على بيان تعريفي فتُحمّل عند الطلب، وتنظّم نفسها في ملفات مسماة، وتستطيع حمل أدلة مرجعية دون إثقال التعليمات الرئيسية. ثلاث مكاسب ملموسة تبرز هنا:
- اقتصاد السياق: يحمّل الوكيل التعليمات العميقة فقط عندما يطابق الوصف طلبك.
- الوحداتية (Modularity): كل مهارة تملك سير عمل واحداً، فتدمج مهارة عقود مع مهارة بحث دون تحرير prompt ضخم.
- قابلية النقل: مجلد يحوي ملف SKILL.md ينتقل بسلاسة بين Claude وManus وChatGPT — وهو نفس السبب الذي يجعل حزم ZIP مناسبة للبيع في المتاجر.
كيف يحمّل الوكلاء المهارات تلقائياً؟
الحلقة بسيطة. في بداية المحادثة يفحص الوكيل المهارات المثبتة ويحتفظ ببياناتها التعريفية في ذهنه. وبينما تتحدث، يطابق طلبك بالأوصاف. وعند التطابق يفتح مجلد المهارة، ويقرأ تعليمات SKILL.md، ويسحب أي ملفات مرجعية تتطلبها الخطوات، ثم ينفّذ. أنت لا تلصق شيئاً يدوياً. إذا كنت تستخدم Claude، فإن دليلنا عن استخدام مهارات Mahara داخل Claude يشرح خطوات التثبيت شاشة بشاشة، وكلفتنا دليل كامل عن مهارات Claude المجانية الجاهزة للتنزيل.
هل أستطيع كتابة ملف SKILL.md خاص بي؟
نعم — وهذه هي فلسفة التنسيق. أنشئ مجلداً باسم مهارتك، واكتب ملف SKILL.md تضع في ترويسته اسماً ووصفاً دقيقاً، ثم اكتب التعليمات كخطوات markdown مرقّمة وواضحة. وإذا كان جزء من سير العمل عميقاً أو نادر الاستخدام، فافصله في ملف references حتى يبقى البيان الرئيسي رشيقاً. اختبر المهارة بطرح سؤال على الوكيل يطابق وصفك؛ إذا اشتغلت المهارة فبيانك ناجح. وللبداية، جرّب مهارة مجانية مثل OpenSource Tool Finder وافتح ملف SKILL.md الخاص بها لترى بياناً تعريفياً حقيقياً كاملاً.
خلاصة ما تعلمناه
- ملف SKILL.md هو البيان التعريفي: ترويسة YAML (الاسم + الوصف) تليها تعليمات markdown.
- الوصف يفعّل التحميل؛ والتعليمات تقود التنفيذ.
- مجلدات references وassets الاختيارية تضيف عمقاً دون تضخيم السياق.
- التنسيق نفسه يعمل مع Claude وManus وإعدادات متوافقة مع ChatGPT.
مستعد لتشغيل بيانات تعريفية حقيقية؟ تصفّح مكتبة مهارات Mahara AI، وفكّ ضغط حزمة، واقرأ ملف SKILL.md بنفسك — أسرع طريقة لتعلّم التنسيق هي رؤيته وهو يعمل.
