المهارة التي تستغرق عشر ساعات تتفوق دائماً على التي تستغرق عشر دقائق

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

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

علقت هذه الجملة في ذهني لأنها تطابق ما كنت أراه. الهوة بين ملف markdown سريع ومجلد مهارة منظم بشكل صحيح كانت تظهر في جودة المخرجات الفعلية، لا في النظرية وحدها.

المهارة مجلد وليست ملفاً

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

يعتمد نهج Anthropic الداخلي ما يسمونه الكشف التدريجي. بدلاً من حشو كل شيء في موجّه واحد، يرتبون الملفات بحيث يقرأ Claude ما يحتاجه فحسب في اللحظة التي يحتاجه. ملف references/api.md يحتفظ بتوقيعات الدوال التي يسحبها Claude عند الطلب. مجلد assets/ يحوي قوالب المخرجات حتى لا يضطر الموجّه أن يصف التنسيق. أما سكريبتات التحقق فتتيح لـ Claude اختبار مخرجاته قبل إعادتها.

إن فتحت مستودع skill-creator، سترى هذا المبدأ في العمل. مجلدات agents/ وreferences/ وscripts/ موجودة جنباً إلى جنب مع SKILL.md. والأداة التي تبني المهارات هي نفسها مبنية كمهارة.

التحذيرات أهم من متن الموجّه

وصف طارق قسم التحذيرات بأنه “المحتوى الأعلى إشارةً” في أي مهارة. ليس التعليمات الرئيسية، ولا الأمثلة. التحذيرات.

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

المنطق واضح. Claude يعرف مسبقاً معظم ما قد تكتبه في متن الموجّه. إخباره بكيفية كتابة TypeScript أو تنسيق JSON هو إعادة صياغة لأشياء يتعامل معها بشكل افتراضي. لكن إخباره بما لا يجب فعله في سياقك تحديداً، هذه معلومة جديدة حقاً.

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

محرّر المهارات يحوّل “يبدو يعمل” إلى “موثّق”

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

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

ثمة تمييز مفيد بين نوعين من المهارات. مهارات رفع القدرات تعلّم Claude شيئاً لا يتقنه وحده. مهارات التفضيلات المرمّزة تفرض سير عمل أو معايير محددة لفريق ما. النوع الأول له تاريخ انتهاء طبيعي لأن تحسينات النماذج تجعله لا ضرورة له في نهاية المطاف. أما النوع الثاني فيظل قيّماً طالما سير العمل موجود. التقييمات تساعدك على اكتشاف اللحظة التي تتحول فيها مهارة رفع القدرات إلى ثقل زائد.

تدعم الأدوات وضع المعيار لتتبع معدلات النجاح واستخدام التوكنات عبر تحديثات النماذج، والتنفيذ المتوازي متعدد الوكلاء لتجنب تلوث السياق أثناء الاختبار، ووكيل المقارنة الذي يجري مقارنات A/B عمياء للمخرجات مع وبدون تطبيق المهارة.

العائد المتراكم

بين مئات المهارات التي رأيتها والعشرات التي أُدير، يثبت نمط واحد: قيمة المهارة تأتي من التكرار والتحسين، لا من المسودة الأولى.

هيكل المجلد هو الطريقة التي تشكّل بها نافذة سياق Claude. التحذيرات تحوّل إخفاقاتك إلى معرفة قابلة لإعادة الاستخدام. التقييمات تقيس ما إذا كانت تلك المعرفة لا تزال صالحة.

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