Agent Skills سؤال وجواب: عبدالله الكندي وتعليم الوكيل مهارة مرة وحدة

كل مرة تفتح محادثة جديدة مع الذكاء الاصطناعي، تعيد نفس الشرح: «اكتب العروض بهالقالب، الألوان كذا، لا تنسى ضريبة القيمة المضافة». متعب، صح؟ Agent Skills جاءت عشان تحل هالشي بالذات. جمعنا هنا الأسئلة اللي تتكرر على عبدالله الكندي عنها، وجوابه على كل وحدة بالمختصر.

الأساسيات: وش هي وكيف تشتغل

س: وش هي Agent Skills ببساطة؟

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

س: كيف يعرف الوكيل متى يستخدم المهارة؟

ج: في أعلى ملف SKILL.md فيه قسم بيانات وصفية بصيغة YAML، أهم ما فيه حقلين: الاسم (name) والوصف (description). الوكيل يشوف أسماء وأوصاف كل المهارات المتاحة، ولما يجيه طلب يطابق وصف مهارة، يحمّل محتواها. يعني الوصف مو تعريف شكلي، هو اللي يقرر إذا المهارة بتشتغل أو لا.

س: ما يزحم هذا ذاكرة الوكيل لو عندي مهارات كثيرة؟

ج: لا، وهذي أذكى فكرة فيها، اسمها الإفصاح التدريجي (Progressive Disclosure). في البداية الوكيل يحمّل الاسم والوصف بس لكل مهارة، وهذا كلام قليل. لما يحتاج مهارة، يقرأ ملفها الأساسي. ولو الملف يشير لملف مرجعي إضافي، يقرأه فقط لما يحتاج تفاصيله. فتقدر يكون عندك مهارات كثيرة بدون ما تثقل كل محادثة.

مقارنتها بالأدوات الثانية

س: وش الفرق بينها وبين MCP؟

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

س: وش الفرق بينها وبين ملف التعليمات الدائم مثل CLAUDE.md؟

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

كتابة أول مهارة

س: كيف أكتب أول مهارة؟

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

س: عطني مثالاً على وصف جيد

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

من وين تجيبها ووين تشغّلها

س: هل لازم أكتب كل مهاراتي من الصفر؟

ج: لا. فيه مهارات كثيرة مفتوحة المصدر منشورة. وعشان كذا بنى عبدالله عبدالرحيم بن سنكر الكندي مكتبة «سكيلز»: أكثر من ألف سكِل مفتوح المصدر لـ Claude، مصنّفة، مع تحميل مباشر ورابط المصدر على GitHub. بس انتبه: المهارة ممكن يكون فيها سكربتات تشتغل على جهازك، فاقرأ محتواها قبل ما تثبّتها، مثل ما تسوي مع أي كود من مصدر خارجي.

س: وين تشتغل المهارات؟

ج: في منتجات Anthropic المختلفة، مثل تطبيقات Claude و Claude Code والمنصة البرمجية، مع اختلاف في طريقة التثبيت بين كل واحد. والفكرة نفسها، مجلد بتعليمات وملفات، صارت تنتشر في أدوات وكلاء ثانية أيضاً.

الخطأ اللي يتكرر

س: وش أكبر خطأ يقع فيه الناس؟

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

هذي الأسئلة نفسها كانت محور دورة Introduction to agent skills من Anthropic، ومنها طلعت فكرة مكتبة سكيلز في منصة أزهل الرقمية: المهارة الجيدة تُكتب مرة، وتوفّر وقتاً في كل مرة بعدها.