كيفية بناء مهارة Claude Code جاهزة للإنتاج
ما تعلمته من بناء وتوزيع أول مهارة (Skill) لي من الصفر.
1. مقدمة
يتوسع نظام مهارات Claude Code بسرعة كبيرة. بحلول مارس 2026، وصل مستودع anthropics/skills على GitHub إلى أكثر من 87,000 نجمة، وهناك المزيد من الأشخاص الذين يقومون ببناء ومشاركة المهارات كل أسبوع.
كيف يمكننا بناء مهارة من الصفر بطريقة منظمة؟ يستعرض هذا المقال عملية تصميم وبناء وتوزيع المهارة من البداية. سأستخدم تجربتي الخاصة في إطلاق مهارة لمراجعة التجارة الإلكترونية كمثال عملي طوال هذا الشرح.
2. ما هي مهارة Claude؟
مهارة Claude هي مجموعة من التعليمات التي تعلم Claude كيفية التعامل مع مهام أو سير عمل محدد. تعد المهارات واحدة من أقوى الطرق لتخصيص Claude ليناسب احتياجاتك الخاصة.
تعتمد المهارات على مبدأ الإفصاح التدريجي. يقوم Claude بجلب المعلومات على ثلاث مراحل:
- البيانات الوصفية (الاسم + الوصف): تكون دائماً في سياق Claude. حوالي 100 رمز (token). يقرر Claude ما إذا كان سيقوم بتحميل المهارة بناءً على هذا فقط.
- جسم ملف SKILL.md: يتم تحميله فقط عند تفعيل المهارة.
- الموارد المجمعة (scripts/, references/, assets/): يتم تحميلها عند الطلب فقط عند الحاجة إليها.
بهذا الهيكل، يمكنك تثبيت العديد من المهارات دون استهلاك نافذة السياق. إذا كنت تستمر في نسخ ولصق نفس التوجيه الطويل، فما عليك سوى تحويله إلى مهارة.
3. المهارات مقابل MCP مقابل الوكلاء الفرعيين (Subagents)
قبل بناء مهارة، دعني أوضح لك الفرق بين المهارات وMCP والوكلاء الفرعيين، حتى تتأكد من أن المهارة هي الخيار الصحيح.
- المهارات: تعلم Claude كيفية التصرف — سير عمل التحليل، معايير البرمجة، إرشادات العلامة التجارية.
- خوادم MCP: تمنح Claude أدوات جديدة — إرسال رسالة Slack، الاستعلام عن قاعدة بيانات.
- الوكلاء الفرعيون: تسمح لـ Claude بتنفيذ عمل مستقل في سياق منفصل.
تشبيه ساعدني: MCP هو المطبخ — السكاكين، الأواني، المكونات. المهارة هي الوصفة التي تخبرك بكيفية استخدامها. يمكنك الجمع بينهما. على سبيل المثال، تحدد مهارة مراجعة الكود الخاصة بـ Sentry سير عمل تحليل طلبات السحب (PR) في مهارة وتجلب بيانات الخطأ عبر MCP. ولكن في كثير من الحالات، تكون المهارة وحدها كافية للبدء.
4. التخطيط والتصميم
لقد قفزت مباشرة إلى كتابة ملف SKILL.md في المرة الأولى وواجهت مشاكل. إذا لم يكن الوصف مصمماً جيداً، فلن يتم تفعيل المهارة حتى. أنصحك بقضاء وقت في التصميم قبل كتابة التوجيهات أو الكود.
4أ. ابدأ بحالات الاستخدام
أول شيء يجب القيام به هو تحديد 2-3 حالات استخدام ملموسة. ليس "مهارة مفيدة" بشكل مجرد، بل عمل متكرر تلاحظه في الممارسة العملية.
دعني أشارك مثالاً خاصاً بي. لاحظت أنني وزملائي نكرر نفس مراجعات الأعمال الشهرية والربع سنوية. في التجارة الإلكترونية والتجزئة، تميل عملية تفكيك مؤشرات الأداء الرئيسية (KPIs) إلى اتباع نمط مشابه.
كانت تلك نقطة البداية. بدلاً من بناء "مهارة تحليل بيانات" عامة، حددتها كالتالي: "مهارة تأخذ بيانات CSV للطلبات، وتفكك مؤشرات الأداء الرئيسية إلى شجرة، وتلخص النتائج مع الأولويات، وتولد خطة عمل ملموسة."
هنا، من المهم تخيل كيف سيصيغ المستخدمون طلباتهم فعلياً:
- "قم بإجراء مراجعة لمتجري باستخدام ملف orders.csv هذا"
- "حلل بيانات المبيعات لآخر 90 يوماً، واشرح سبب انخفاض الإيرادات"
- "قارن الربع الثالث بالربع الرابع، وحدد أهم 3 أشياء يجب علي إصلاحها"
عندما تكتب توجيهات ملموسة كهذه أولاً، يصبح شكل المهارة واضحاً. المدخلات هي CSV. محور التحليل هو تفكيك مؤشرات الأداء الرئيسية. المخرجات هي تقرير مراجعة وخطة عمل. المستخدم ليس عالم بيانات — إنه شخص يدير عملاً تجارياً ويريد معرفة ما يجب فعله بعد ذلك.
5. أنماط التنفيذ
بمجرد تحديد التصميم، لنبدأ التنفيذ. أولاً، افهم هيكل الملف، ثم اختر النمط الصحيح.
5أ. هيكل الملف
الهيكل المادي للمهارة بسيط:
my-skill/ ├── SKILL.md # مطلوب. YAML frontmatter
+ تعليمات Markdown ├── scripts/ # اختياري. Python/JS للمعالجة الحتمية
├── references/ # اختياري. يتم تحميله بواسطة Claude عند الحاجة └── assets/
# اختياري. قوالب، خطوط، أيقونات، إلخ.
ملف SKILL.md هو الوحيد المطلوب. هذا وحده يصنع مهارة عاملة. حاول إبقاء SKILL.md أقل من 500 سطر. إذا أصبح أطول، انقل المحتوى إلى دليل references/ وأخبر Claude في SKILL.md بمكان البحث. لن يقرأ Claude ملفات المراجع إلا إذا وجهته إليها.
6. الاختبار
كتابة SKILL.md ليست النهاية. ما يجعل المهارة جيدة هو مقدار ما تختبره وتكرره. القاعدة الوحيدة لتوجيهات الاختبار: اكتبها بالطريقة التي يتحدث بها المستخدمون الحقيقيون.
المشكلة في توجيهات الاختبار النظيفة هي أنها لا تعكس الواقع. المستخدمون الحقيقيون يرتكبون أخطاء مطبعية، ويستخدمون اختصارات غير رسمية، وينسون أسماء الملفات. المهارة التي يتم اختبارها بتوجيهات نظيفة فقط ستتعطل بطرق غير متوقعة في الإنتاج.
7. التوزيع
بمجرد أن تصبح مهارتك جاهزة، تحتاج إلى إيصالها للمستخدمين. تعتمد أفضل طريقة على ما إذا كانت لك فقط، أو لفريقك، أو للجميع.
- تحميل ZIP (claude.ai): قم بضغط مجلد المهارة وارفعه عبر الإعدادات > تخصيص > المهارات.
- دليل .claude/skills/ (Claude Code): ضع المهارة في مستودع مشروعك تحت .claude/skills/. عندما يقوم زملاؤك باستنساخ المستودع، يحصل الجميع على نفس المهارة.