إذا كنت تلصق التعليمات نفسها في Claude Code مرة بعد مرة، فبإمكان الـ skill (المهارة) أن تحفظها لك. يشرح هذا الدليل ما هي مهارة الوكيل، وأين توضع ملفاتها، وكيف تكتب مهارة صغيرة وتختبرها. ويتناول أيضًا تثبيت المهارات من أسواق الإضافات، والأخطاء التي تمنع المهارة من التحميل.
راجعنا كل ما يلي مقابل وثائق Anthropic الرسمية في نوفمبر 2026. يتغير Claude Code كثيرًا، لذا تبقى الوثائق المرفقة هي المرجع النهائي.
ما هي مهارة الوكيل
المهارة مجلد يحتوي على ملف اسمه SKILL.md. يتكون الملف من جزأين: في الأعلى بيانات YAML أمامية (frontmatter) بين علامتي ---، تضم الحقلين name وdescription. وتحتها تعليمات Markdown عادية يتبعها Claude عند تشغيل المهارة.
ويمكن لمجلد المهارة أن يضم ملفات إضافية، مثل ملاحظات مرجعية أو قوالب أو سكربتات.
تُحمَّل المهارات على مراحل، وهو ما تسميه Anthropic الإفصاح التدريجي (progressive disclosure). عند بدء التشغيل، لا يحمّل Claude سوى اسم كل مهارة ووصفها. وتُحمَّل التعليمات الكاملة عند استدعاء المهارة، أما الملفات المرفقة فلا تُحمَّل إلا إذا فتحها Claude. لذلك يمكنك تثبيت مهارات كثيرة دون أن تملأ نافذة السياق.
ما تحتاج إليه
- Claude Code مثبتًا مع تسجيل الدخول
- طرفية (Terminal) ومحرر نصوص
- مشروع git للتجربة (المهارة في المثال تكتب رسائل الـ commit)
الخطوة 1: اختر مكان المهارة
المكان الذي تحفظ فيه المهارة يحدد الجلسات التي تراها. أكثر موقعين ستستخدمهما هما:
- شخصي:
~/.claude/skills/<skill-name>/SKILL.md. متاحة في كل مشاريعك على هذا الجهاز. - المشروع:
.claude/skills/<skill-name>/SKILL.mdداخل المستودع. متاحة في الجلسات داخل ذلك المستودع. وإذا أضفتها إلى commit فسيحصل عليها فريقك أيضًا.
وهناك أيضًا مواقع للمؤسسات وأخرى متداخلة وثالثة للإضافات. وإذا تشاركت مهارة شخصية ومهارة مشروع الاسم نفسه، فالأولوية للشخصية.
تنبيه واحد: المهارات الشخصية في ~/.claude/skills/ لا تقرؤها الجلسات السحابية ولا Cowork. ولهذه الحالات توصي الوثائق بتفعيل المهارة في حسابك على claude.ai أو إضافتها إلى المستودع عبر commit.
الخطوة 2: أنشئ المجلد
سننشئ مهارة شخصية اسمها commit-message.
mkdir -p ~/.claude/skills/commit-message
النتيجة المتوقعة: لا يطبع الأمر شيئًا، ويصبح المجلد الفارغ موجودًا.
الخطوة 3: اكتب ملف SKILL.md
أنشئ الملف ~/.claude/skills/commit-message/SKILL.md والصق فيه ما يلي. يجب أن يكون اسم الملف SKILL.md حرفيًا.
---
name: commit-message
description: Writes a clear git commit message from the staged changes. Use when the user asks for a commit message, wants to commit their work, or asks how to describe their changes.
---
# Commit message writer
1. Run `git diff --staged` to see what is staged.
2. If nothing is staged, say so and stop.
3. Write a subject line in the imperative mood, under 72 characters.
4. Leave one blank line, then add a short body that explains why the change was made.
5. Show the message in a code block. Do not run `git commit` unless the user asks.
بعض الملاحظات حول البيانات الأمامية:
- يصبح
nameهو الأمر الذي تكتبه. وإذا حذفته، يستخدم Claude Code اسم المجلد. descriptionهو ما يقرؤه Claude ليقرر هل يستخدم المهارة أم لا. اذكر أولًا ما تفعله المهارة، ثم متى تُستخدم.- يجب أن تكون علامة
---الافتتاحية في السطر الأول تمامًا من الملف، وإلا تعامل Claude Code مع الملف كله على أنه محتوى عادي.
يقبل Claude Code حقولًا أخرى، مثل disable-model-invocation وallowed-tools. لكن الرفع إلى claude.ai وواجهة Skills API لا يقبلان إلا ستة حقول: name وdescription وlicense وcompatibility وmetadata وallowed-tools. والاكتفاء بالحقلين name وdescription يجعل مهارتك قابلة للنقل.
الخطوة 4: اختبرها
جهّز تغييرًا صغيرًا في أي مشروع git (stage)، ثم شغّل Claude Code.
git add .
claude
يمكنك تشغيل المهارة بطريقتين. الأولى أن تطلب بكلمات عادية وتترك Claude يلتقطها من الوصف:
Can you write a commit message for what I've staged?
أو أن تستدعيها مباشرة باسمها:
/commit-message
النتيجة المتوقعة: ينفّذ Claude الأمر git diff --staged ويرد بسطر عنوان ونص قصير داخل كتلة كود.
لا تحتاج إلى إعادة التشغيل بعد التعديل. فـ Claude Code يراقب ~/.claude/skills/ ومجلد .claude/skills/ في المشروع، ويلتقط التغييرات في الجلسة الحالية.
الخطوة 5: أضف ملفات مساندة (اختياري)
مع نمو المهارة، انقل التفاصيل خارج SKILL.md. توصي الوثائق بإبقائه أقل من 500 سطر. وقد يبدو الهيكل هكذا:
commit-message/
├── SKILL.md
├── examples.md
└── scripts/
└── check-length.sh
اربط الملفات الإضافية من داخل SKILL.md ليعرف Claude متى يفتحها. أما السكربتات فتُنفَّذ ولا تُحمَّل في السياق.
الخطوة 6: ثبّت مهارات من سوق إضافات
لست مضطرًا إلى كتابة كل مهارة بنفسك. ففي Claude Code يمكن أن تأتي المهارات ضمن إضافات (plugins)، والإضافات تأتي من أسواق (marketplaces). ويُضاف سوق Anthropic الرسمي claude-plugins-official تلقائيًا في أول مرة تبدأ فيها جلسة تفاعلية.
ويمكن أيضًا إضافة مستودع المهارات العام التابع لـ Anthropic على GitHub بوصفه سوقًا. ويذكر ملف README فيه هذه الأوامر:
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
داخل الجلسة، يفتح الأمر /plugin install لوحة الإضافات لتراجع الإضافة وتختار نطاقها قبل تثبيتها. ومهارات الإضافات لها نطاق أسماء خاص، فالمهارة المسماة review في إضافة اسمها my-plugin تعمل بالأمر /my-plugin:review.
المهارات مقابل خوادم MCP مقابل CLAUDE.md
يحتوي CLAUDE.md على حقائق وقواعد ثابتة تُحمَّل في كل جلسة، مثل “use pnpm” (استخدم pnpm) أو “tests live in tests/” (الاختبارات موجودة في tests/). اجعله قصيرًا، لأنه حاضر في السياق دائمًا.
تحتوي المهارات على إجراءات ومواد مرجعية لا تهم إلا في بعض الأحيان. ونصيحة Anthropic أن تنشئ مهارة عندما يتحول قسم من CLAUDE.md إلى إجراء، أو عندما تجد نفسك تلصق قائمة التحقق نفسها في المحادثة مرارًا.
تربط خوادم MCP بين Claude والأدوات والبيانات الخارجية، مثل قاعدة بيانات أو نظام لتتبع المشكلات أو تطبيق تصميم. ويمكن للمهارة أن توضح لـ Claude كيف يستخدم تلك الأدوات جيدًا، لكنها لا توفر الاتصال بها.
المهارات خارج Claude Code
التنسيق نفسه يعمل في منتجات Claude كلها. فبحسب النظرة العامة من Anthropic، يمكن إنشاء مهارات مخصصة في Claude Code، أو رفعها عبر Claude API، أو إضافتها من إعدادات claude.ai. والمهارات المرفوعة إلى claude.ai يجب رفعها إلى الـ API بشكل منفصل.
ملاحظة حول الأمان
المهارة ليست مجرد نص. فقد تتضمن سكربتات، وقد توجّه Claude لتنفيذ أوامر واستدعاء أدوات. وتوصي Anthropic باستخدام المهارات من مصادر موثوقة فقط، أي تلك التي كتبتها بنفسك أو حصلت عليها من Anthropic. وإذا جربت مهارة من مكان آخر، فاقرأ كل ملفاتها أولًا، بما فيها السكربتات، وابحث عن أي اتصالات شبكية أو وصول إلى الملفات غير متوقع.
أخطاء شائعة وحلولها
Claude لا يستخدم المهارة من تلقاء نفسه
السبب المعتاد هو وصف مبهم. فعبارة “Helps with git” (يساعد في git) لا تعطي Claude الكثير ليطابقه. اكتب ما تفعله المهارة والعبارات التي سيقولها الناس فعلًا. ويمكنك أيضًا أن تسأل Claude “What skills are available?” (ما المهارات المتاحة؟) لتتأكد من أنها حُمّلت، وأن تستخدم /skill-name لتشغيلها مباشرة.
المهارة لا تظهر إطلاقًا
تحقق من المسار ومن حالة الأحرف. يجب أن يكون ~/.claude/skills/<skill-name>/SKILL.md، والملف داخل مجلده الخاص، لا ملقى مباشرة في skills/. وتذكر الوثائق أيضًا رموزًا لا يجوز أن يحتويها الاسم، مثل < و> أو مسافة في بدايته أو نهايته.
البيانات الأمامية معطوبة
إذا تعذّر تحليل YAML، يظل Claude Code يحمّل نص المهارة لكن ببيانات وصفية فارغة. ويبقى /skill-name يعمل، لكن Claude لا يستطيع مطابقة وصفك. شغّل Claude Code بالأمر claude --debug لترى الخطأ، أو نفّذ claude plugin validate ~/.claude/skills لتعثر على الملفات المعطوبة.
قواعد صيغة الاسم
في claude.ai والـ API، يجب ألا يحتوي name إلا على أحرف إنجليزية صغيرة وأرقام وشرطات، وألا يتجاوز 64 حرفًا، وألا يتضمن الكلمتين anthropic أو claude. ويمكن أن يصل description إلى 1,024 حرفًا. وتجنب أيضًا تسمية مجلد باسم synced، إذ يحجزه Claude Code للمهارات المنزّلة من claude.ai.
التغييرات لا تُلتقط
التعديلات على المهارات الموجودة تُحمَّل دون إعادة تشغيل. لكن إذا أنشأت مجلد مهارات رئيسيًا لم يكن موجودًا عند بدء الجلسة، فنفّذ /reload-skills. وللإضافات الجديدة، نفّذ /reload-plugins أو أعد تشغيل Claude Code.
المهارة تعمل أكثر من اللازم
اجعل الوصف أكثر تحديدًا. وإذا كنت تريد تشغيلها يدويًا فقط، فأضف disable-model-invocation: true إلى البيانات الأمامية.
الخلاصة
المهارة مجلد وملف SKILL.md ووصف جيد. ابدأ بمهمة واحدة تكررها كل أسبوع، ودوّن خطواتها، ثم اختبرها بطلب عادي وبالأمر /skill-name. وراجع أي شيء تثبّته قبل أن تثق به.
المزيد عن Claude: تصفّح كل أدلتنا عن Claude وAnthropic، مرتبة حسب المهمة.
المصادر والوثائق الرسمية
آخر تحقق من الروابط في 15 نوفمبر 2026.





اكتب ردًّا