Claude Code Skills: علّم مساعدك حيلًا جديدة بملف SKILL.md

هل لاحظت أنك تكتب الطلب نفسه لـ Claude Code مرة بعد مرة؟ «اشرح هذا الكود ببساطة، وبالعربي، وبمثال من الحياة». ماذا لو كتبت هذه التعليمات مرة واحدة فقط، ثم استدعيتها بكلمة؟ هذا بالضبط ما تفعله Skills. في هذا الدرس ستصنع أول Skill بيدك.

🎯 ماذا ستتعلم؟

بنهاية هذا الدرس ستكون قادرًا على:

شرح ما هي الـ Skill، وكيف تختلف عن ملف CLAUDE.md.
إنشاء Skill بملف SKILL.md في المكان الصحيح.
كتابة description يجعل Claude Code يستخدم الـ Skill في الوقت المناسب.
تشغيل الـ Skill بنفسك بأمر مثل /explain-simply.
تمرير arguments للـ Skill باستخدام $ARGUMENTS.

🧰 ماذا تحتاج قبل أن تبدأ؟

Claude Code مثبّت على جهازك، وتعرف كيف تبدأ جلسة. إن لم تفعل بعد، فاقرأ أولًا ما هو Claude Code؟ دليل التثبيت والبداية. وتذكّر أن حساب Claude يملكه شخص بالغ يتعلّم معك.

الفكرة ببساطة

تخيّل مطبخًا فيه طبّاخ ماهر. على الحائط لوحة قواعد يراها دائمًا: «اغسل يديك، ولا تستخدم الفول السوداني». هذه اللوحة تشبه ملف CLAUDE.md، فـ Claude Code يقرؤه في بداية كل جلسة.

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

إذن الـ Skill تعليمات جاهزة لمهمة محدّدة. يقرؤها Claude Code عند الحاجة فقط، فلا تزدحم ذاكرته بما لا يحتاجه الآن.

الخطوة 1: أين تعيش Skills؟

كل Skill مجلد خاص بها، وداخله ملف اسمه SKILL.md بأحرف كبيرة. وللمجلد مكانان أساسيان:

المكان	المسار	من يستخدمها؟
شخصية	`~/.claude/skills/<skill-name>/SKILL.md`	أنت، في كل مشاريعك على هذا الجهاز
خاصة بالمشروع	`.claude/skills/<skill-name>/SKILL.md`	كل من يعمل على هذا المشروع

الرمز ~ يعني مجلدك الشخصي على الجهاز. واسم الـ Skill يُكتب بأحرف إنجليزية صغيرة وشَرطات، مثل explain-simply.

الخطوة 2: اصنع مجلد الـ Skill

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

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

الأمر mkdir ينشئ مجلدًا، والخيار -p ينشئ المجلدات الناقصة في الطريق أيضًا.

💡 على ويندوز: في PowerShell اكتب الأمر نفسه بدون -p، فهو ينشئ المجلدات الناقصة تلقائيًا.

الخطوة 3: اكتب ملف SKILL.md

افتح محرّر نصوص، واحفظ هذا المحتوى في ملف داخل المجلد الجديد. سمِّ الملف SKILL.md بالضبط:

---
name: explain-simply
description: يشرح الكود لمبتدئ بالعربية البسيطة مع مثال من الحياة اليومية. استخدمها عندما يطلب المستخدم شرح كود أو يقول لم أفهم.
---

اشرح الكود المطلوب لطالب مبتدئ:

1. ابدأ بتشبيه من الحياة اليومية في جملة أو جملتين.
2. اشرح ماذا يفعل كل جزء مهم، بجمل قصيرة.
3. اختم بسؤال صغير يتأكد به الطالب أنه فهم.

اكتب بالعربية الفصحى البسيطة، واترك أسماء الأوامر بالإنجليزية.

الملف له جزءان:

frontmatter: الجزء بين سطرَي --- في الأعلى. فيه name وهو اسم الأمر، وdescription وهو وصف الـ Skill.
التعليمات: كل ما تحت ذلك. هذه هي «الوصفة» التي سيتبعها Claude Code.

الخطوة 4: شغّل الـ Skill

ادخل إلى أي مشروع وابدأ جلسة جديدة بالأمر claude. الآن تستطيع تشغيل الـ Skill بطريقتين.

الطريقة الأولى: Claude Code يختارها وحده. فهو يقرأ description كل Skill. فإن طابقه طلبُك، استخدمها تلقائيًا. جرّب أن تكتب:

لم أفهم ماذا تفعل الحلقة في ملف game.py، اشرحها لي

الطريقة الثانية: أنت تستدعيها بنفسك. اكتب / ثم اسم الـ Skill:

/explain-simply

لاحظ قوة description هنا. فهو الذي يخبر Claude Code متى يستخدم الـ Skill. لذلك اكتب فيه الكلمات التي ستقولها فعلًا، مثل «شرح» و«لم أفهم».

الخطوة 5: أعطِ الـ Skill arguments

أحيانًا تريد أن تخبر الـ Skill بشيء إضافي. مثلًا: Skill تصنع اختبارًا قصيرًا، وأنت تختار موضوعه كل مرة. هنا نستخدم arguments.

أنشئ Skill جديدة في المسار ~/.claude/skills/quiz/SKILL.md:

---
name: quiz
description: يصنع اختبارًا قصيرًا من 3 أسئلة اختيار من متعدد حول موضوع برمجي.
argument-hint: [الموضوع]
---

اصنع اختبارًا من 3 أسئلة اختيار من متعدد عن: $ARGUMENTS

اجعل لكل سؤال 3 اختيارات، وضع الإجابات الصحيحة في النهاية.

الآن اكتب في جلسة Claude Code:

/quiz الحلقات في بايثون

سيستبدل Claude Code الكلمة $ARGUMENTS بكل ما كتبته بعد اسم الـ Skill. فتصبح التعليمات: «اصنع اختبارًا… عن: الحلقات في بايثون». والحقل argument-hint يُظهر لك تلميحًا بما تكتبه بعد الأمر.

الخطوة 6: من يحق له تشغيل الـ Skill؟

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

disable-model-invocation: true

بهذا السطر لن يشغّلها Claude Code وحده أبدًا. تعمل فقط عندما تكتب أنت اسمها بعد /.

🚀 للمتقدمين: يمكن للـ Skill أن تشغّل أمرًا قبل أن يقرأها Claude Code، وتضع ناتجه مكانه. اكتب سطرًا يبدأ بعلامة ! ثم الأمر بين علامتَي backtick، مثل !`git diff HEAD`. فيرى Claude Code التغييرات الحقيقية في مشروعك بدل السطر نفسه. ويمكنك أيضًا وضع ملفات مساعدة بجانب SKILL.md، مثل examples.md، ويقرؤها Claude Code عند الحاجة فقط.

⚠️ أخطاء شائعة

1. شيء قبل سطر --- الأول.

❌ (سطر فارغ)
---
name: explain-simply

✅ الحل: يجب أن يكون --- هو السطر الأول في الملف تمامًا، بلا أي سطر فارغ أو مسافة قبله.

2. وضع الملف مباشرة داخل مجلد skills.

❌ ~/.claude/skills/SKILL.md

✅ الحل: كل Skill تحتاج مجلدًا باسمها: ~/.claude/skills/explain-simply/SKILL.md.

3. description غامض.

❌ description: مهارة مفيدة

✅ الحل: اكتب ماذا تفعل الـ Skill ومتى تُستخدم: «يشرح الكود لمبتدئ… استخدمها عندما يطلب المستخدم شرح كود». الـ description الغامض يجعل Claude Code لا يعرف متى يستخدمها.

🧪 جرّب بنفسك

التحدي 1 (سهل): في Skill explain-simply، غيّر التعليمات لتجعل التشبيه دائمًا من عالم كرة القدم.

💡 اضغط لرؤية الحل

غيّر الخطوة الأولى في التعليمات إلى:

1. ابدأ بتشبيه من عالم كرة القدم في جملة أو جملتين.

ثم احفظ الملف. إن كانت الجلسة مفتوحة وما زالت تستخدم النسخة القديمة، فابدأ جلسة جديدة وجرّب.

التحدي 2 (متوسط): اصنع Skill اسمها timetable تأخذ أيام الأسبوع كـ arguments، وتصنع جدول مذاكرة بسيطًا لها.

💡 اضغط لرؤية الحل

أنشئ الملف ~/.claude/skills/timetable/SKILL.md:

---
name: timetable
description: يصنع جدول مذاكرة أسبوعيًا بسيطًا لطالب.
argument-hint: [الأيام]
---

اصنع جدول مذاكرة لهذه الأيام: $ARGUMENTS

خصّص لكل يوم مادتين، ولا تتجاوز ساعتين في اليوم، وأضف استراحة قصيرة.

ثم جرّب: /timetable الأحد والثلاثاء والخميس

التحدي 3 (للمتقدمين): عدّل Skill quiz بحيث لا يشغّلها Claude Code وحده أبدًا، بل تعمل فقط عندما تكتب /quiz.

💡 اضغط لرؤية الحل

---
name: quiz
description: يصنع اختبارًا قصيرًا من 3 أسئلة اختيار من متعدد حول موضوع برمجي.
argument-hint: [الموضوع]
disable-model-invocation: true
---

اصنع اختبارًا من 3 أسئلة اختيار من متعدد عن: $ARGUMENTS

اجعل لكل سؤال 3 اختيارات، وضع الإجابات الصحيحة في النهاية.

✅ اختبر نفسك

ما اسم الملف الذي يجب أن يكون داخل مجلد كل Skill؟ (أ) skill.txt (ب) SKILL.md (ج) CLAUDE.md
صح أم خطأ: Claude Code يقرأ تعليمات كل Skills كاملة في بداية كل جلسة.
إذا كتبت /quiz الدوال، فماذا تصبح قيمة $ARGUMENTS؟

💡 اضغط لرؤية الإجابات

(ب) SKILL.md.
خطأ. يرى description فقط، ويقرأ التعليمات كاملة عندما يحتاج الـ Skill.
تصبح الدوال.

📝 الخلاصة

الـ Skill تعليمات جاهزة لمهمة محدّدة، يقرؤها Claude Code عند الحاجة فقط.
ملف CLAUDE.md يُقرأ دائمًا، أما Skills فتُقرأ عند استخدامها.
كل Skill مجلد فيه SKILL.md، في مجلدك الشخصي أو في مجلد المشروع.
الـ description الواضح يجعل Claude Code يستخدم الـ Skill تلقائيًا، وتستطيع تشغيلها بنفسك بالأمر /skill-name.
$ARGUMENTS تمرّر للـ Skill ما تكتبه بعد اسمها.

⏭️ الخطوة التالية

صنعت أول Skills لك بيدك! فكّر الآن في طلب تكرّره كثيرًا، وحوّله إلى Skill. وفي الدرس التالي ستتعلّم كيف تعمل مع Claude Code بذكاء: Claude Code Best Practices. وتستطيع متابعة مسار Claude درسًا بعد درس. وإن أردت أن تطبّق ما تعلّمته على مشروع حقيقي، فجرّب Skill quiz على دروس مسار بايثون.