مهارات Claude Code الجديرة بالوجود في بناء موقع

المهارة مجلد فيه SKILL.md. تلك هي الفكرة كلها. فالملف يحمل ترويسة YAML وبعض تعليمات ماركداون، ومن ثم يحمّلها Claude حين يطابق الوصف ما طلبته، أو تستدعيها مباشرة بكتابة مائلة واسمها. وفي بناء موقع هذا هو الفارق بين إعطاء تعليمات ما قبل الإطلاق نفسها في كل مشروع وتشغيل أمر واحد. وتوثيق المهارات هو المرجع؛ وهذا ما يهم حين يكون العمل مواقع.

تخطيط الملفات

SKILL.md مطلوب ويعمل نظرة عامة. وكل ما عداه يُحمّل عند الحاجة فقط، وتلك هي الفكرة: فملف مرجعي بألفي سطر لا يكلف شيئاً حتى تمتد إليه المهارة فعلاً. والتوثيق ينصح بإبقاء SKILL.md تحت 500 سطر ونقل التفصيل إلى ملفات منفصلة، ومجلد scripts/ يحمل كوداً يُنفَّذ لا يُقرأ في السياق.

حقول الترويسة التي تغيّر السلوك

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

• description هو كيف يقرر Claude تحميلها. ويُقرأ لا يُتصفَّح، فاكتب حالة الإطلاق أولاً والشرح ثانياً.
• وdisable-model-invocation: true يمنع Claude من تحميلها تلقائياً، فلا تُشغَّل إلا حين تكتب الأمر. استخدمه في كل ما ينشر أو يكلف مالاً.
• وpaths يأخذ أنماط glob ويحدّ متى تُحمّل المهارة تلقائياً، ما يبقي مهارة CSS بعيدة بينما تحرر ملفات بيانات.
• وcontext: fork يشغّل المهارة في وكيل فرعي متفرّع. نافع للتدقيقات الطويلة، لكن الوكيل الفرعي لا يحصل إلا على محتوى المهارة توجيهاً، فيجب أن تكون التعليمات مكتفية ذاتياً.

الحدود التي تعضّ

أربعة سلوكيات موثقة تسبب معظم الالتباس، ولا ينتج أي منها رسالة خطأ.

• النص المجموع لـdescription وwhen_to_use يُقص عند 1,536 حرفاً في القائمة. وما بعد ذلك غير مرئي لقرار تحميل المهارة.
• وإن لم يُحلَّل YAML بين العلامتين، تُحمّل المهارة مع ذلك بلا حقول مضبوطة. فهي لا تفشل، بل تصير بهدوء ملف تعليمات عادياً.
• وأمر صدفة محقون فاشل يجهض الاستدعاء كله، ولا يرى Claude محتوى المهارة إطلاقاً.
• وallowed-tools يمنح إذناً للدور المستدعي فقط. ويُمسح في رسالتك التالية، ولا يقيّد شيئاً.

المهارات الجديرة بالبناء لعمل المواقع

هذه ما كسبت موضعها لدينا، بالترتيب الذي سنبنيها به. وكل منها سير عمل كنا نكرره يدوياً في كل مشروع.

مهارات أم خطافات أم وكيل

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

ولمشاركة مجموعة منها عبر فريق أو نشرها، تُحزَم إضافةً، وهكذا تنتهي أيضاً بفضاء أسماء عند الاستدعاء. وفهرس التوثيق الكامل في code.claude.com/docs/llms.txt.

وسير البناء الذي تقع فيه هذه في بناء موقع بـClaude Code، والفحوص التي ينبغي لمهارة ما قبل الإطلاق إجراؤها فعلاً معدودة في قائمة فحص السيو لموقع بناه وكيل.

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