كيف يقرر Claude متى يستخدم السكِل؟ التحميل التدريجي وسرّ حقل الوصف

كتبت سكِلاً ممتازاً، تعليماته دقيقة وأمثلته واضحة، وتطلب من Claude المهمة المناسبة بالضبط… وما يستخدمه. تعيد الصياغة، ما يستخدمه. المشكلة غالباً مو في محتوى السكِل — المشكلة في سطر واحد أغلب الناس يكتبونه على عجل: الوصف. عشان تفهم ليش، لازم تفهم كيف يُحمَّل السكِل أصلاً.

تذكير سريع: وش هو السكِل تقنياً؟

مجلد فيه ملف SKILL.md إلزامي، يبدأ بترويسة YAML فيها على الأقل الاسم (name) والوصف (description)، وبعدها التعليمات بصيغة Markdown. ويقدر المجلد يحتوي ملفات إضافية: مراجع تفصيلية، قوالب، أو سكربتات ينفذها Claude بدل ما يكتب الكود من جديد كل مرة.

التحميل التدريجي على ثلاث مراحل

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

هذا التصميم (progressive disclosure) هو اللي يخلي السكِلات قابلة للتوسع: السياق ما يمتلئ بمحتوى ما تحتاجه المهمة الحالية.

النتيجة المهمة: الوصف هو المُشغّل

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

• اذكر المهام بأفعال واضحة: يستخرج، يحوّل، يراجع، يولّد.
• اذكر كلمات التشغيل اللي بيكتبها المستخدم فعلاً، بالعربي والإنجليزي: «عرض سعر»، «فاتورة»، «quotation».
• اذكر أنواع الملفات أو السياقات: PDF، Excel، مشروع Flutter.
• اذكر متى لا يُستخدم لو فيه سكِل قريب منه يسبب لبساً.
• اكتبه بصيغة الغائب لا المتكلم: «يراجع…» مو «أنا أراجع…».

لماذا يفشل السكِل في الانطلاق؟

• وصف عام جداً يتداخل مع قدرات Claude الأساسية فما يرى داعياً له.
• وصف يستخدم مصطلحات داخلية ما يكتبها المستخدم.
• سكِلان وصفهما متشابه، فيختار الآخر.
• ترويسة YAML فيها خطأ صياغة، فالسكِل ما يُقرأ أصلاً.
• السكِل مو في المسار الصحيح للبيئة اللي تستخدمها.

نصائح لتنظيم الجسم والملفات

خلّ SKILL.md مركّزاً على سير العمل والقرارات، وانقل التفاصيل الطويلة (جداول مرجعية، أمثلة كثيرة، مواصفات) لملفات منفصلة تحيل لها بوضوح: «للتفاصيل الكاملة لحقول الفاتورة اقرأ reference/fields.md». وأي عملية حتمية تتكرر — تحويل صيغة، تحقق من ملف — اكتبها كسكربت، لأن تشغيل سكربت مجرب أدق وأوفر من إعادة توليد الكود في كل مرة.

اختبر التشغيل مو المحتوى بس

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

مثال: وصف ضعيف مقابل وصف قوي

خذ سكِلاً يجهّز عروض الأسعار بصيغة الشركة. الوصف الضعيف: «سكِل لعروض الأسعار». Claude يشوفه ضمن عشرات السكِلات، وما يعرف هل يستخدمه لما تقول «جهّز لي عرض للعميل» أو «سعّر هالمشروع» أو «اكتب proposal». والنتيجة إنه أحياناً يستخدمه وأحياناً يكتب العرض من عنده بشكل مختلف.

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

• يذكر المخرج بدقة: عرض بصيغة معتمدة وجدول وضريبة.
• يذكر كلمات التشغيل بالعربي والإنجليزي.
• يذكر سياقاً غير مباشر: تحويل ملاحظات إلى عرض.
• يفصل نفسه عن سكِل قريب: الفواتير.

عبدالله عبدالرحيم بن سنكر الكندي أتم دورة Introduction to agent skills من Anthropic، ومكتبة «سكيلز» المجانية في منصة أزهل الرقمية تجمع أكثر من ألف سكِل مفتوح المصدر تقدر تدرس أوصافها وبنيتها كأمثلة حقيقية قبل ما تكتب سكِلك.