أمثلة عملية على استخدام Skills: أضف مهارة، نادِ عليها، وشاهدها تعمل

📚 تنقل السلسلة: المقال السابق 26 ما هي الـ Skill شرح لك المفاهيم بالتفصيل - ما هو ملف SKILL.md وكيف يقرر حقل description متى يستخدمها Claude. هذا المقال ينتقل للتطبيق العملي المباشر: سنقوم بفحص المهارات المتاحة لديك، واستدعاء إحداها بعبارة بسيطة، ومتابعة تنفيذها بالكامل لتتعلم كيفية استخدام المهارات الجاهزة.

لنفترض أنك بحاجة لإعداد مخطط هيكلي لمشروعك لعرضه على رئيسك في العمل. في الوضع الطبيعي، ستحتاج لفهم العلاقات وتصميم المخطط باستخدام Mermaid وتعديل الألوان وتصدير المخطط كصورة PNG، وهذا يتطلب منك نصف يوم عمل تقريباً. ولكن مع Claude Code، يمكنك ببساطة كتابة "ساعدني في رسم مخطط هيكلي لهذا المشروع" - وسيتولى Claude المهمة بالكامل.

فلن يطلب منك أي معلومات إضافية، بل سيقوم بتفعيل مهارة تدعى baoyu-diagram وتنسيق المخطط بناءً على نظام ألوان غامق محدد مسبقاً وتوليد ملف SVG ثم تحويله إلى صورة PNG بدقة عالية @2x، وكل ذلك في أقل من 5 دقائق، وستجد الصور بانتظارك في مجلد docs/assets/.

في تلك اللحظة ستدرك القيمة الحقيقية للمهارات (skills): فهي لا تهدف لجعل Claude "أكثر ذكاءً"، بل تضمن "تنفيذ المهام المتكررة بنفس الطريقة والخطوات الموثوقة في كل مرة". تحويل نصف يوم عمل إلى 5 دقائق يكمن في وجود هذه الخطوات المكتوبة مسبقاً.

أصبحت تعرف الآن ما هي المهارة من المقال السابق. وسنقوم في هذا المقال بأمر واحد فقط: أن نخوض تجربة تحويل نصف يوم العمل إلى 5 دقائق بأنفسنا.

بعد قراءة هذا المقال، ستحصل على:

• كيفية معرفة المهارات المتاحة في جلستك الحالية بعبارة بسيطة لتجنب التخمين.
• قراءة وفهم ملف SKILL.md حقيقي، ومعرفة كيف يحدد حقل description شروط تفعيل المهارة.
• تفعيل المهارة بطريقتين: "التفعيل التلقائي باللغة الطبيعية" و "الاستدعاء المباشر باستخدام الاسم عبر /" ومتابعة المخرجات.
• خطوات فحص المهارة عند عدم تفعيلها (عبارات عامة / عدم تطابق الوصف / عدم تفعيل المهارة أساساً).
• كيفية إضافة مهارة داخل المشروع لمشاركتها مع الفريق بالكامل ليعملوا بنفس الخطوات.

---

01 افهم المهارات المتاحة لديك أولاً

قبل البدء باستخدام المهارات، يجب عليك معرفة المهارات المتاحة للاستخدام حالياً.

من الأخطاء الشائعة محاولة تخمين اسم المهارة - "أعتقد أن هناك مهارة للرسم؟" ثم تتحدث مع Claude دون استجابة وتظن أن المهارة معطلة، بينما هي غير مثبتة في الواقع. معرفة المهارات المتوفرة أولاً توفر عليك الكثير من الوقت.

تشبيه: تصفح كتاب الطبخ لمعرفة الوصفات المتاحة قبل البدء بطهي الطعام. لن تدخل المطبخ وتقرر فجأة "سأطهو هذه الوجبة اليوم" دون أن تتأكد من وجود الوصفة وتوفر مكوناتها في الكتاب. المهارات هي بمثابة وصفات لـ Claude، وكل ملف SKILL.md يمثل وصفة محددة - تأكد من وجود الوصفة أولاً ثم ابدأ العمل.

طريقة الفحص بسيطة للغاية، اسأله بعبارة بسيطة داخل جلسة Claude Code:

ما هي المهارات المتاحة لدي؟

يتعرف Claude على السؤال باللغتين العربية والإنجليزية. النتيجة المتوقعة: سيعرض لك Claude قائمة بالمهارات المتاحة مع أسمائها ووصف مبسط لكل منها. وفي مستودعنا الحالي، ستجد مهارة الرسم متوفرة:

baoyu-diagram — توليد مخططات SVG احترافية بنظام ألوان غامق (مخططات هيكلية / تسلسلية / تدفقية...)

💡 خلاصة سريعة: قبل البدء، اسأل Claude "ما هي المهارات المتاحة لدي؟" لتتأكد من توفر المهارة المطلوبة أولاً وتتجنب محاولة استدعاء مهارات غير متوفرة.

هناك طريقتان إضافيتان لفحص المهارات:

قائمة /skills - اكتب /skills في صندوق الإدخال واضغط Enter لتظهر لك واجهة رسومية تعرض كافة المهارات وتتيح لك تفعيلها أو تعطيلها (اضغط Space للتبديل، واضغط Enter للحفظ). وهي طريقة ممتازة وأسهل من القائمة النصية.

أداة الفحص /doctor - أداة متقدمة: إذا قمت بتركيب عدد كبير من المهارات، فقد يتعذر على Claude قراءتها بالكامل وتجاوز المساحة المخصصة، مما يؤدي لاختصار بعض الأوصاف وعجز Claude عن رؤيتها كاملة. يعلمك أمر /doctor بمستوى استهلاك المساحة وما إذا كان هناك مهارات متأثرة. لا تحتاج إليها غالباً في البداية، ولكن إذا لاحظت توقف مهارة معينة عن العمل فجأة، فابدأ بتشغيل /doctor للتحقق.

---

02 تشريح مهارة حقيقية: كيف يبدو ملف SKILL.md

لا يكفي معرفة وجود المهارة، بل يجب فهم كيفية بنائها داخلياً لتعرف كيف يتم تفعيلها وما الذي تفعله.

دعنا نلقي نظرة على مهارة حقيقية مستخدمة في هذا المشروع وهي مهارة baoyu-diagram التي نعتمد عليها لتوليد المخططات.

موقع المهارة في المشروع:

.claude/skills/baoyu-diagram/
├── SKILL.md              # الملف الرئيسي للمهارة (مطلوب)
├── references/           # وثائق تفصيلية لتنسيق المخططات (تحمل عند الحاجة)
│   ├── architecture.md
│   ├── flowchart.md
│   └── sequence.md
└── scripts/
    └── main.ts           # برمجية تحويل SVG إلى PNG (يتم تشغيلها ولا تدخل في السياق)

هل لاحظت البنية؟ المهارة هي عبارة عن مجلد يحتوي على ملف SKILL.md كمدخل رئيسي، مع إمكانية وجود وثائق مرجعية وبرمجيات مساعدة بجانبه. ملف SKILL.md مطلوب دائماً، وبقية الملفات اختيارية لتسهيل العمل (تساعد المراجع في تقليص حجم الملف الرئيسي وتُحمل عند الحاجة فقط، والبرمجيات لتشغيل المهام المطلوبة).

عند فتح ملف SKILL.md الخاص بالمهارة، ستجد في البداية بيانات محصورة بين علامتي ---، وتدعى frontmatter (بيانات التعريف المكتوبة في أعلى الملف):

---
name: baoyu-diagram
description: Create professional, dark-themed SVG diagrams of any type — architecture diagrams, flowcharts, sequence diagrams... Also trigger when the user says "画个图" "画一个架构图" "diagram" "flowchart" "ارسم مخطط" "ارسم شكل"...
version: 1.117.3
---

وما يأتي بعد علامة --- الثانية هو نص المهارة المكتوب بصيغة Markdown (ويحتوي على القواعد والألوان وتفاصيل التصميم وأوامر التحويل).

وهنا نصل لنقطة أساسية شرحناها في المقال السابق ويمكنك رؤيتها عملياً الآن: يمثل حقل description المعيار الأساسي الذي يعتمد عليه Claude لمعرفة "هل يجب استخدام هذه المهارة الآن أم لا" (ويمكن الاستعانة بحقل اختياري آخر وهو when_to_use لتحديد شروط التفعيل، ويتم اقتصاصهما معاً عند 1536 حرفاً كحد أقصى).

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

تشبيه: عبارة 'مناسب للعزائم والوجبات السريعة' المكتوبة في أعلى وصفة الطبخ. فعندما تبحث في الكتاب عن وصفة للعزائم، ستلفت انتباهك هذه العبارة وتعرف أن الوصفة مناسبة لطلبك. حقل description يمثل هذه العبارة للمهارة - يقارن Claude حديثك مع حقل الوصف لجميع المهارات، ويقوم بتفعيل المهارة التي تطابق كلماتك بشكل أكبر.

تذكر هذه السلسلة جيداً لفهم آلية العمل والتحقق من الأخطاء:

طلبك ← مقارنة الطلب مع حقول description للمهارات ← مطابقة المهارة وتفعيلها ← تحميل وقراءة ملف SKILL.md ← تنفيذ المهمة بناءً على الخطوات المحددة.

كلما كان حقل description واضحاً ومطابقاً للعبارات الواقعية التي تستخدمها، زادت دقة التفعيل. ولذا عند فحص المهارات التي لا تعمل، نبدأ بمراجعة هذا الحقل أولاً.

توضح هذه الصورة كيفية تحول عبارة بسيطة إلى مهمة منفذة عبر المهارة: طلبك ← مقارنة الطلب مع حقل description لكل مهارة ← تحميل وقراءة ملف SKILL.md المختار ← تنفيذ المهمة والحصول على المخرجات. فهمك لهذه السلسلة يسهل عليك معرفة مكان الخطأ عند توقف المهارة.

💡 خلاصة سريعة: المهارة هي مجلد يحتوي على ملف SKILL.md رئيسي، ويمثل حقل description في الأعلى مفتاح التفعيل - يقارن Claude كلماتك معه ويفتح صفحة المهارة عند وجود مطابقة.

---

03 تجربة المهارة الأولى: استدعاء تلقائي باللغة الطبيعية

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

وهذا هو الممتع في المهارات - فلا تحتاج لحفظ أوامر معقدة， بل يتولى Claude اختيار المهارة المناسبة تلقائياً.

الخطوة الأولى: تشغيل Claude Code من جذر المشروع:

claude

النتيجة المتوقعة: الدخول إلى الجلسة وظهور صندوق الإدخال في الأسفل.

الخطوة الثانية: كتابة طلبك بعبارة عادية دون ذكر اسم المهارة baoyu-diagram صراحة:

ساعدني في رسم مخطط يوضح دورة عمل وكيل الذكاء الاصطناعي "فكر ← تصرف ← لاحظ"

النتيجة المتوقعة: بمجرد رؤية كلمة "رسم مخطط"، سيقوم Claude بمقارنة الطلب مع أوصاف المهارات المتوفرة، ويجد مطابقة مع مهارة baoyu-diagram التي تحتوي على الكلمات "ارسم مخطط" و "diagram"، فيقوم بتفعيلها تلقائياً، ويبدأ بتنفيذ الخطوات: قراءة الوثيقة المرجعية الخاصة بالمخططات التدفقية من مجلد references/flowchart.md وتنسيق الأشكال والألوان بدقة وتوليد ملف .svg ثم تحويله إلى صورة .png.

بعد الانتهاء، سيعلمك بمكان حفظ الملفات الناتجة:

تم توليد المخططات بنجاح:
  docs/claude-code/assets/27-agent-loop.svg
  docs/claude-code/assets/27-agent-loop@2x.png

رؤية هذه الملفات تعني نجاح تفعيل المهارة وإتمام المهمة بنجاح. وكل ذلك تم بعبارة بسيطة دون الحاجة لتحديد أي تفاصيل إضافية يدوياً.

يوضح الجدول التالي الفرق الشاسع بين العمل بوجود مهارة وبدونها:

المقارنة	❌ بدون استخدام المهارة	✅ باستخدام المهارة
صياغة الطلب	تحتاج لشرح الألوان والخطوط والأحجام وتنسيق التصدير بدقة وتفصيل...	عبارة بسيطة مثل "ساعدني في رسم مخطط"
ثبات المخرجات	قد تختلف الألوان والتنسيقات في كل مرة وتفقد الهوية الموحدة	الحصول على مخرجات ثابتة وتتبع نفس نظام التصميم في كل مرة
الحفظ والتذكر	تضطر لحفظ وتكرار الخطوات والأوامر في كل مرة	لا تحتاج لحفظ أي خطوات أو أوامر

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

الاستدعاء المباشر للمهارة بالاسم

إذا كنت متأكداً من رغبتك في استخدام مهارة محددة، يمكنك استدعاؤها مباشرة بالاسم عبر علامة /:

/baoyu-diagram ارسم مخطط تسلسلي لعملية تسجيل دخول المستخدم

النتيجة المتوقعة: سيتم تجاوز مرحلة مقارنة الوصف وتفعيل مهارة baoyu-diagram مباشرة لتنفيذ الطلب المكتوب بعد الاسم.

متى تستخدم كل طريقة؟

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

💡 خلاصة سريعة: هناك طريقتان لتشغيل المهارة - التحدث بعبارات عادية ليختارها Claude تلقائياً، أو استدعاؤها بالاسم عبر / مباشرة؛ الطريقة الأولى ممتازة للاستكشاف، والثانية للتشغيل المباشر والسريع.

---

04 المهارة لا تعمل؟ خطوات فحص المشكلة وتصحيحها

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

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

الخطوة الأولى: مراجعة صياغة طلبك (السبب الأكثر شيوعاً).

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

الحل: استخدم كلمات مشابهة للكلمات الموجودة في حقل الوصف، وأعد كتابة الطلب بكلمات مباشرة وواضحة:

ساعدني في رسم مخطط هيكلي

يساعد استخدام أفعال وكلمات مباشرة مثل "رسم" و "مخطط" في زيادة نسبة التعرف والتفعيل بشكل كبير. ابدأ بهذه الخطوة دائماً.

الخطوة الثانية: التحقق من توفر المهارة في الجلسة.

استخدم الأمر الذي تعلمناه في القسم 01 للتحقق من توفر المهارة:

ما هي المهارات المتاحة لدي؟

النتيجة المتوقعة: إذا لم تجد المهارة في القائمة، فهذا يعني أنها غير مثبتة أو لم يتم قراءتها (مثال: مهارة على مستوى المشروع لم توافق على ثقتها بعد، أو أنك قمت بتشغيل البرنامج من دليل آخر). في هذه الحالة، يجب عليك تركيب المهارة أو تحميلها أولاً قبل محاولة تشغيلها (سنشرح إضافة مهارات المشاريع في القسم 05).

الخطوة الثالثة: استدعاء المهارة بالاسم كحل بديل.

إذا تأكدت من وجود المهارة في القائمة ولم تنجح محاولات التفعيل التلقائي بعد تعديل العبارات، فلا تضيع وقتك واستدعِ المهارة بالاسم مباشرة عبر /:

/baoyu-diagram ارسم مخطط هيكلي للمشروع

يضمن استدعاء المهارة عبر / تشغيلها مباشرة (نظراً لتجاوز مرحلة التقييم التلقائي لـ Claude). وتساعدك هذه الخطوة في تحديد مكان المشكلة: فإذا عملت المهارة بالاسم فهذا يعني أنها سليمة برمجياً وأن المشكلة تكمن في ضعف حقل description الخاص بها، ويمكنك تحسينه لاحقاً.

الجدول التالي يلخص خطوات الفحص والتصحيح:

المشكلة	السبب المحتمل	الحل المقترح
المهارة لا تعمل ويقوم Claude بالمهمة بالطريقة المعتادة	صياغة طلبك بعيدة عن كلمات حقل الوصف	أعد كتابة الطلب بكلمات مباشرة وواضحة (مثل رسم ومخطط)
استمرار المشكلة بعد تعديل العبارات	المهارة غير متوفرة أو لم يتم تحميلها في الجلسة	اسأل "ما هي المهارات المتاحة لدي؟" وتأكد من تركيبها وحجم المساحة المستهلكة
توفر المهارة في القائمة مع فشل التفعيل التلقائي	ضعف كلمات حقل الوصف لمطابقة طلبك	استخدم استدعاء الاسم عبر / مباشرة كحل سريع، وقم بتحسين حقل الوصف لاحقاً

⚠️ قد تواجه أحياناً مشكلة "التفعيل الزائد للمهارة" - أي قيام المهارة بالعمل عند كل طلب بسيط دون حاجة حقيقية لها. والحل هنا هو كتابة حقل description بشكل أدق وتفصيلي (وتجنب الكلمات العامة الواسعة)، أو إضافة خيار disable-model-invocation: true في حقل التعريف لمنع تفعيلها تلقائياً وجعلها تعمل بالطلب المباشر عبر / فقط. سنشرح كيفية تعديل المهارات في المقال القادم.

💡 خلاصة سريعة: عند توقف المهارة عن العمل اتبع خطوات الفحص الثلاثة - تأكد من وضوح العبارة أولاً، ثم تحقق من توفر المهارة في القائمة، واستخدم الاستدعاء المباشر بالاسم عبر / كحل سريع.

---

05 مشاركة المهارات مع الفريق: مهارات المشاريع (Project Skills)

تعلمنا الآن كيفية استخدام وتجربة المهارات. ولكن المهارات التي قمنا بتركيبها في دليل ~/.claude/skills/ تتوفر على جهازك الشخصي فقط، ولن يجدها بقية المطورين عند سحب الكود.

لمشاركة الخطوات وتوحيد سير العمل مع بقية أعضاء الفريق، يجب علينا استخدام مهارات المشاريع (Project Skills).

تشبيه: كتابة الوصفة وطباعتها في كتاب المشاريع المشترك للشركة بدلاً من كتابتها في مذكرتك الخاصة. حيث يتمكن كل من يسحب كود المشروع من استخدام نفس المهارات والوصول إليها مباشرة. المهارة الشخصية هي مذكرتك الخاصة، ومهارة المشروع هي ملفات مشتركة تُرفع مع كود المشروع للجميع.

يوضح الجدول التالي الفروق بين المهارات الشخصية ومهارات المشاريع:

المقارنة	المهارات الشخصية (Personal Skills)	مهارات المشاريع (Project Skills)
موقع الحفظ	مجلد ~/.claude/skills/<name>/SKILL.md	مجلد المشروع .claude/skills/<name>/SKILL.md
من يمكنه استخدامها	أنت فقط وفي كافة مشاريعك على جهازك الحالي	جميع المطورين الذين يملكون نسخة من المشروع
المشاركة والرفع	لا يتم رفعها أو مشاركتها	يتم رفعها ومشاركتها عبر git
حالات الاستخدام	خطواتك وطرق عملك الشخصية اليومية	توحيد خطوات العمل المشتركة (النشر، التنسيق، ومستندات الفحص)

لتفعيل مهارات المشاريع ومشاركتها، اتبع الخطوات الثلاث التالية:

الخطوة الأولى: حفظ ملفات المهارة داخل مجلد المشروع تحت مسار .claude/skills/:

مجلد-مشروعك/
└── .claude/
    └── skills/
        └── team-commit/
            └── SKILL.md

الخطوة الثانية: إضافة المجلد ورفعه إلى نظام إدارة النسخ كبقية الملفات البرمجية:

git add .claude/skills/
git commit -m "feat: إضافة مهارة مخصصة لفحص التزام الفريق team-commit"

الخطوة الثالثة: سحب الكود من بقية المطورين لتفعيلها تلقائياً لديهم - وهي الميزة الأهم لمهارات المشاريع: فبمجرد سحب الكود وتشغيل Claude Code لديهم، ستتوفر المهارة في جلستهم مباشرة دون الحاجة لأي خطوات تركيب إضافية. وسيتمكن الفريق بالكامل من تشغيل نفس المهام بنفس الخطوات المحددة.

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

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

💡 خلاصة سريعة: لمشاركة المهارة مع الفريق، احفظها داخل مجلد المشروع .claude/skills/ وارفعها إلى git؛ وتأكد من مراجعة المهارات عند سحب مشاريع خارجية قبل تأكيد الثقة بها.

---

06 تطبيق عملي: إنشاء أول مهارة شخصية وتجربتها

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

سنقوم بإنشاء مهارة بسيطة تدعى explain-casual تجعل Claude يشرح الأكواد البرمجية بأسلوب مبسط وممتع كأنه يتحدث معك في مقهى.

الخطوة الأولى: إنشاء مجلد المهارة الشخصية (في الدليل الرئيسي لتعمل في كافة مشاريعك).

على أنظمة Mac / Linux:

mkdir -p ~/.claude/skills/explain-casual

على نظام Windows (PowerShell):

mkdir $HOME\.claude\skills\explain-casual

النتيجة المتوقعة: إنشاء مجلد باسم explain-casual تحت مسار المهارات الشخصية.

الخطوة الثانية: كتابة ملف SKILL.md. افتح محررك المفضل واكتب النص التالي في ملف ~/.claude/skills/explain-casual/SKILL.md:

---
description: يشرح الأكواد البرمجية بأسلوب مبسط وشيق كأنك تتحدث في مقهى. ويتم تفعيله عندما يطلب المستخدم "اشرح لي الكود ببساطة" أو "ماذا يفعل هذا الكود" أو "اشرح هذا التابع".
---

## المهمة المطلوبة

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

1. اشرح وظيفة الكود الإجمالية في جملة واحدة أولاً.
2. اختر أهم الأسطر واشرح وظيفة كل منها بعبارة مبسطة.
3. في النهاية اذكر: هل هناك أي ملاحظات أو ثغرات محتملة قد تؤدي لخطأ في التشغيل؟

ملاحظة هامة: قمنا بكتابة كلمات شائعة في حقل description يسهل استخدامها عند الطلب مثل "اشرح لي الكود ببساطة" و "ماذا يفعل هذا الكود". وهو ما يساعد Claude على مطابقة الكلمات وتفعيل المهارة تلقائياً.

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

claude

بمجرد الدخول، اكتب:

ما هي المهارات المتاحة لدي؟

النتيجة المتوقعة: ستشاهد المهارة explain-casual متوفرة في القائمة مع الوصف الذي كتبته لها. وهذا يعني نجاح تركيب وتحميل المهارة بنجاح.

الخطوة الرابعة: اختبار التفعيل التلقائي باللغة الطبيعية (دون كتابة اسم المهارة). ارسل له كوداً بسيطاً واطلب شرحه:

اشرح لي الكود ببساطة:
def average(numbers):
    return sum(numbers) / len(numbers)

النتيجة المتوقعة: سيقوم Claude بمطابقة عبارة "اشرح لي الكود ببساطة" مع وصف مهارة explain-casual ويقوم بتفعيلها مباشرة، ويبدأ بالشرح وفق الخطوات المحددة: شرح الوظيفة الإجمالية أولاً، ثم شرح السطر الأساسي، وفي النهاية ينبهك لثغرة احتمال إرسال مصفوفة فارغة مما يسبب خطأ القسمة على صفر (وهي تلبية للملاحظة الثالثة في مهمة المهارة). ويكون أسلوب الحديث مبسطاً وشيقاً بدلاً من الشرح الجاف المعتاد.

الخطوة الخامسة: تجربة الاستدعاء بالاسم. اكتب الطلب التالي:

/explain-casual def average(numbers): return sum(numbers) / len(numbers)

النتيجة المتوقعة: الحصول على نفس النتيجة السابقة ولكن عبر التفعيل المباشر وتمرير الكود كمعلمة للمهارة دون الحاجة لتقييم الطلب.

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

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

💡 خلاصة سريعة: تجربة بناء مهارة بسيطة وتفعيلها (إنشاء المجلد، كتابة ملف SKILL.md مع تفاصيل الوصف، إعادة تشغيل الجلسة وفحص القائمة، واختبار التشغيل التلقائي وبالاسم) تساعدك على فهم المهارات بشكل ممتاز وتؤهلك لاستخدام المهارات الجاهزة وتعديلها.

---

07 ملخص

ركزنا في هذا المقال على الجانب العملي واستخدام المهارات لتسريع العمل وتوحيد الخطوات. لنراجع النقاط الأساسية معاً:

العمل المطلوب	الخطوات المتعبة	نقاط هامة
معرفة المهارات المتوفرة	كتابة "ما هي المهارات المتاحة لدي؟" أو استخدام قائمة /skills	تأكد من توفر المهارة قبل استخدامها
قراءة وتفحص المهارة	الاطلاع على ملف SKILL.md الخاص بها	يمثل حقل description في الأعلى مفتاح التفعيل التلقائي
تفعيل وتشغيل المهارة	استخدام عبارات مطابقة للوصف، أو كتابة الاسم مباشرة عبر /	التفعيل التلقائي ممتاز للاستكشاف، والاسم للتشغيل المباشر
فحص المهارات المعطلة	تعديل العبارات ← التحقق من القائمة ← الاستدعاء بالاسم للتبويب	أغلب المشاكل تعود لعدم وضوح العبارات وصياغتها
مشاركة المهارات مع الفريق	حفظها في مجلد المشروع .claude/skills/ ورفعها لـ git	تأكد من فحص مهارات المشاريع الخارجية قبل تأكيد ثقة بيئة العمل

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

تحويل نصف يوم عمل لـ 5 دقائق أصبح بين يديك الآن، ومفتاح الحل هو استخدام المهارات المناسبة لتوفير الوقت والجهد.

---

المقال القادم 28 "إنشاء المهارات المخصصة (Skill Creator)" - تعلمنا في هذا المقال كيفية استخدام المهارات الجاهزة وفهم بنيتها، وسنتعلم في المقال القادم كيفية كتابة وإنشاء مهاراتنا الخاصة. فإذا كانت لديك مهام متكررة تضطر لكتابة خطواتها وتنسيقاتها لـ Claude في كل مرة، فسنوضح لك في المقال القادم كيفية استخدام أداة skill-creator الرسمية لحفظ وتثبيت هذه الخطوات والمهام في مهارة مخصصة ومستقلة، لتنتقل من مرحلة "مستخدم المهارات" إلى "صانع المهارات المتمكن".

---

قراءات موصى بها

• متغيرات البيئة: لوحة التحكم الخفية للبرنامج
• وضع الصوت: الحديث مع Claude بدلاً من الكتابة يدوياً
• دليل الإضافات والملحقات: حزم ومشاركة تهيئاتك الخاصة