مهارات مساعد الذكاء الاصطناعي: ما هو SKILL.md وكيف تثبّته بدون الطرفية

ما هو ملف SKILL.md

‏SKILL.md ملف نصي يحوي تعليمات يقرأها مساعد الذكاء الاصطناعي قبل أن يشرع في العمل. ليس برنامجًا ولا إضافة: مجرد markdown عادي يشرح كيف يُنجَز نوع معيّن من العمل — ماذا يُفحص أولًا، بأي ترتيب يجري التفكير، بأي صيغة تُسلَّم النتيجة، وما الذي لا يُفعل أبدًا. يوضع الملف في مستودع، فيلتقطه المساعد، ومنذ تلك اللحظة يُنجَز العمل كما هو مكتوب لا كما يرتجل النموذج.

ظهرت هذه الصيغة أواخر عام 2025 وصارت شائعة خلال أشهر: تقرؤها Claude وCodex وCopilot وCursor وGemini CLI وعشرات الأدوات الأخرى، بينما صارت الأدلة العامة تحصي المهارات بمئات الآلاف. ومع ذلك فإن التوثيق كله تقريبًا مكتوب لمن يملك طرفية ومستودعًا ووكيل برمجة قيد التشغيل — وهذا هو السبب الوحيد الذي يجعل الموضوع يبدو حتى اليوم شأنًا للمطوّرين.

الملف نفسه بسيط. جزآن يفصل بينهما سطر من ثلاث شرطات.

وفيما يلي مهارة كاملة بحجم قريب من الواقع. تصف كيف تُراجَع تسجيلة مكالمة مبيعات: عمّا يُبحَث، وبأي ترتيب، وما الذي لا يجوز اختلاقه.

---
name: sales-call-review
description: مراجعة مكالمة مبيعات — الاعتراضات، الإشارات، الخطوة التالية
---

# مراجعة مكالمة مبيعات

أنت تحلّل تفريغ محادثة مع عميل محتمل.

## ترتيب العمل

1. اكتب الاعتراضات «بنصّها الحرفي» بين علامتَي اقتباس. لا تُعِد صياغتها:
   الصيغة الدقيقة للاعتراض هي البيانات نفسها.
2. بيّن لكل اعتراض إن كان قد جاء ردّ، وإن كان الردّ قد لقي قبولًا.
   الصمت ليس موافقة.
3. ابحث عن إشارات الميزانية والمهلة وصاحب القرار.
   إن لم ترد إشارة، فاكتب ذلك صراحة: «لم يُذكر».
4. حدّد الخطوة التالية: ما هي بالضبط، ومن ينفّذها، وحتى متى.

## صيغة المخرجات

أربعة أقسام بالترتيب أعلاه. داخلها نقاط قصيرة، بلا فقرات تمهيدية.
الاعتراضات مقتبسة بين علامتَي اقتباس.

## ما لا يجوز فعله

- لا تفترض دوافع المحاوِر: فقط ما قيل فعلًا.
- لا تقدّر احتمال إتمام الصفقة بنسبة مئوية — لا توجد بيانات لذلك.
- لا تقترح خصمًا كخطوة تالية إن لم يُطرح موضوع السعر إطلاقًا.

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

المهارة والأداة والموجّه: من يتولى ماذا

ثلاثة مفاهيم يجري الخلط بينها باستمرار مع أنها تحلّ مشكلات مختلفة. والفرق أبسط مما يبدو: الموجّه يحدّد الدور، والمهارة تحدّد الطريقة، وMCP يمنح الوصول.

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

لماذا يعني «بلا طرفية» شيئًا آخر عادةً

«كيف أثبّت مهارة بلا طرفية» سؤال شائع، ونتائج البحث تجيب عنه فعلًا. غير أنها تجيب عن سؤال آخر.

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

التثبيت بلا طرفية وبلا وكيل برمجة

يقرأ Whisperer ملف SKILL.md مباشرةً ويطبّقه على إجابات المساعد. لا شيء يُثبَّت: الملف لا يصل إلى حاسوبك أصلًا، ولا توجد مجلدات، ولا شيء يحتاج إعادة تشغيل. والمصادر اثنان — دليل مشترك، وأي مستودع GitHub عام.

1. لوحة الويب → الموجّهات → زر «المهارات»
2. تبويب «الجاهزة» → اكتب كلمة بحث: system design, code review,
   sales, writing…
3. تعرض القائمة الاسم والمستودع المصدر وعدد التثبيتات. افتح إحداها
   لقراءة الوصف المأخوذ من frontmatter الخاص بها
4. «تثبيت» — تدخل المهارة إلى مكتبتك
5. افتح موجّهًا → «ربط» → اختر المهارة

1. لوحة الويب → الموجّهات → «المهارات» → تبويب «مستودعك»
2. الصق أيًّا من هذه الصيغ:
   owner/repo
   https://github.com/owner/repo
   https://github.com/owner/repo/tree/main/skills/sales-review
   https://github.com/owner/repo/blob/main/skills/sales-review/SKILL.md
3. «ابحث عن المهارات» — نمرّ على المستودع ونسرد كل ملف SKILL.md
   مع وصفه. وإن لصقت رابط مجلد بعينه ظهرت مهارته أولًا
4. اضغط «تثبيت» على ما تريد → ثم اربطه بموجّه

على ماذا تنطبق المهارة فعليًا

لا تُربَط المهارة بـ«المساعد» ككل، بل بموجّه دور بعينه. والدور مجال عمل: الإجابة عن الأسئلة، قراءة الشيفرة، قراءة الصور، تصميم الأنظمة. اربط مهارة بدور، تجدها في كل موضع يعمل فيه ذلك الدور.

وللربط وضعان، والفرق بينهما أثقل مما توحي به التسميتان.

«يكمّل» — تُضاف المهارة إلى نص الموجّه. يبقى الموجّه هو من يحدّد الدور والنبرة، بينما تشحذ المهارة الطريقة. وهذا هو الوضع الصحيح في تسع حالات من عشر.

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

ماذا يحدث للمهارة بعد التثبيت

هنا التفصيلة التي تفصل تثبيتًا يعمل عن مصدر مفاجآت غير سارّة. تُثبَّت المهارة عند كوميت بعينه. ففي لحظة التثبيت نسجّل أي نسخة من الملف أخذناها بالضبط، ونظل نستعملها هي.

وزر «تحديث من المستودع» يعيد قراءة الملف، ويعرض النسخة الجديدة، ويثبّت المهارة عند الكوميت الحالي. وحذف المهارة من المكتبة يفكّ كل روابطها أيضًا — فلا يبقى ما يُنظَّف على حدة.

ثلاث مهارات للبداية

قاعدة الاختيار: تستحق المهارة عناءها حيث شرحت الشيء نفسه ثلاث مرات. فإن كنت تكرّر تعليمة في كل محادثة فهي مرشّحة. أما إن لزمتك مرة كل ربع سنة فكتابتها يدويًا أرخص.

1. معجم مجالك

أكثرها بخسًا لحقّها وأسرعها كتابةً. أسماء منتجاتكم، والاختصارات الداخلية، وألقاب الزملاء، وأسماء العملاء — كل ما يسمعه النموذج أول مرة فيشوّهه. خمس دقائق عمل، وأثر مرئي في كل مكالمة.

---
name: our-glossary
description: المصطلحات والمنتجات والأسماء المستعملة في شركتنا
---

# معجمنا

هذه الكلمات تتكرر باستمرار. اكتبها هكذا تمامًا.

## المنتجات
- [الاسم] — [ما هو، في جملة واحدة]

## الاختصارات
- [الاختصار] — [الصيغة الكاملة]. لا تخلطه بـ [اختصار مشابه]

## الأشخاص
- [الاسم واللقب] — [الدور]

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

2. صيغة رسالة المتابعة عندك

الرسالة التي تلي المحادثة تسير كل مرة على البنية نفسها، وتلك البنية خاصة بكل شخص. والمهارة تثبّتها: أي أقسام، وبأي ترتيب، وبأي طول، وكيف تبدأ الجملة الأولى. وهنا تحديدًا تظهر المسافة بين «أجاب المساعد» و«أجاب المساعد مثلك» من المحاولة الأولى.

3. طريقة مراجعة تناسب نوع اجتماعاتك

المثال الوارد في صدر المقال من هذا الباب. فالمقابلات الوظيفية ومكالمات المبيعات واجتماعات المراجعة والمحادثات البحثية، لكل منها ما يستحق استخراجه على حدة. المساعد العام يستخرج «الموضوعات الرئيسية»؛ أما المهارة فتستخرج الاعتراضات بنصّها، أو إشارات وجع العميل، أو الفروق بين المرشحين في كتلة الأسئلة نفسها.

الأمان: نحو ثلث المهارات العامة به مشكلات

هذا أهم أقسام المقال، وهو غائب عن معظم الأدلة.

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

ومن هنا يظهر تمييز يستحق الفهم عند اختيار طريقة التثبيت.

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

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

حدود يُستحسن معرفتها سلفًا

أربعة أمور قولها الآن خير من اكتشافها لاحقًا.

المهارات المعتمدة على سكربتات تعمل جزئيًا فقط. فبعض ما في الدليل مكتوب على افتراض أن الوكيل سيشغّل الشيفرة المرفقة. وهنا لا يُنفَّذ إلا النص. فإن كانت التعليمة قائمة بذاتها عملت المهارة كاملة؛ وإن انتهت إلى «شغّل analyze.py» فلن تعمل إطلاقًا. ويمكن تمييز ذلك قبل التثبيت: الوصف والمتن ظاهران في المعاينة.

المتن محدود بـ 24000 حرف. نحو عشر صفحات — أكثر مما تحتاجه أي مهارة معقولة. والملف الأطول يُربَط مقصوصًا، ويُبلَّغ بذلك صراحةً لا بصمت.

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

المستودعات الخاصة غير مدعومة. فنحن نصل إلى GitHub بلا بيانات اعتمادك، ولا نرى إلا ما هو عام. والمستودع الخاص والمستودع غير الموجود سواء عندنا: كلاهما يجيب «غير موجود».

قائمة تحقّق قبل ربط مهارة من صنع غيرك

أسئلة متكررة

هل يلزم إتقان البرمجة لكتابة مهارة؟

لا. المهارة نصّ بلغة عادية: ماذا تفعل، وبأي ترتيب، وما تتجنبه. والشرط التقني الوحيد أربعة أسطر من frontmatter في رأس الملف، ويمكن نسخها كما هي من المثال أعلاه. ومستودع GitHub يُنشأ من واجهة الويب، والملف يُضاف بزر.

ما الفرق بين المهارة وموجّه النظام؟

الموجّه يصف من يجيب وبأي نبرة؛ والمهارة تصف كيف يُنجَز نوع من العمل. والفرق العملي في إعادة الاستعمال: الموجّه شخصي، أما المهارة فتُكتب مرة وتصلح لكل من يؤدي العمل نفسه. ولهذا يتشارك الناس المهارات ولا يكادون يتشاركون الموجّهات.

المهارة أم MCP؟

ليسا بديلين. المهارة تأتي بالطريقة، وMCP يأتي بالبيانات والأفعال. فإن أجاب المساعد في غير الموضوع لزمتك مهارة؛ وإن أجاب جيدًا لكنه يجهل الوقائع لزمك MCP. وكثيرًا ما يلزمان معًا: يجلب MCP البيانات من لوحة المهام، وتصف المهارة كيفية التعامل معها.

هل تُربط المهارة الواحدة بعدة موجّهات؟

نعم. المكتبة مشتركة وعدد الروابط غير محدود. تُحفظ المهارة مرة واحدة وتعمل في كل موضع رُبطت به.

ماذا يحدث إن عدّل المؤلف المهارة في المستودع؟

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

لماذا لا يعيد البحث شيئًا أحيانًا؟

لسببين. قد يكون الدليل متعذّرًا مؤقتًا — فتأتي القائمة فارغة، بينما يظل ربط مستودعك الخاص يعمل كالمعتاد. أو يكون GitHub يحدّ من طلباتنا: فبلا رمز وصول تُحتسب الحصة على الخدمة كلها، وفي مثل تلك اللحظات يكون الانتظار بضع دقائق أصدق من عرض نتيجة فارغة كأن لا مهارات هناك.

هل تعمل هنا المهارات المكتوبة لـ Claude Code أو Cursor؟

نعم، ما دامت التعليمة قائمة بذاتها: الصيغة متطابقة والنص يُقرأ بالطريقة نفسها. أما ما لا ينتقل فهو الجزء الذي يفترض وجود نظام ملفات أو صدفة أو تشغيل سكربتات — والمساعد الذي يعمل على اجتماعاتك لا يملك شيئًا من ذلك، وهذا مقصود.

من أين تبدأ

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

مكتبة المهارات في لوحة الويب، في قسم الموجّهات. وكيفية عمل الموجّهات والأدوار مشروحة في دليل Prompt Studio، وأي نموذج يتولى أي دور في مرجع أدوار النماذج.