المهارات: خبرة عند الطلب
- تعريف ما هي المهارة وكيف تختلف عن حشو كل شيء داخل CLAUDE.md
- قراءة وكتابة ملف SKILL.md — الواجهة الأمامية إضافةً إلى التعليمات — وفهم لماذا يكون الوصف هو المُحفّز
- شرح الكشف التدريجي ولماذا يتيح توسّع مهارات كثيرة دون إثقال السياق
- معرفة الأماكن الثلاثة التي تقيم فيها المهارات: شخصية، ومشروع، ومُحزّمة داخل إضافة
- الاختيار الصحيح بين المهارة، وأمر الشرطة المائلة، والوكيل الفرعي، وMCP
- تجنّب الأخطاء الأربعة الشائعة التي تمنع المهارات من التحفّز
تُحزّم المهارة خبرة — تعليمات إضافةً إلى سكربتات وموارد اختيارية — يحمّلها Claude فقط عندما تكون ذات صلة. فبدلًا من حشو كل شيء داخل CLAUDE.md، تمنح Claude مكتبة من القدرات يسحبها عند الطلب.
التشريح
المهارة هي مجلد به ملف SKILL.md: واجهة أمامية YAML + تعليمات.
---
name: pdf-forms
description: Use when the user needs to fill, read, or generate PDF forms.
---
# PDF Forms
Steps and rules for working with PDF forms…
(optionally reference scripts/ or resources/ in this folder)
- الوصف هو المُحفّز — يقرؤه Claude ليقرر متى يفعّل المهارة. اكتبه على هيئة "Use when…"، محددًا بما يكفي ليُحمَّل في الوقت الصحيح ولا يُحمَّل في غيره.
الكشف التدريجي (لماذا تتوسع المهارات)
لا يحمّل Claude المتن الكامل لكل مهارة مقدمًا — بل يرى name + description الخفيفين، ولا يسحب التعليمات الكاملة (ويشغّل السكربتات) إلا عندما يطابق طلب ما. هذا يبقي السياق خفيفًا حتى مع تثبيت مهارات كثيرة.
أين تقيم
- ~/.claude/skills/<name>/SKILL.md — تبقى ملكك، ومتاحة عبر كل مشاريعك.
- .claude/skills/<name>/SKILL.md — أدرجها في git فيحصل الفريق كله على القدرة.
- احزم المهارات داخل إضافة لتوزيعها على الفريق. راجع الإضافات والأسواق.
يأتي AILmanac مزوّدًا بـ 7 حزم مهارات جاهزة — انسخ واحدة لتجربتها.
مثال عملي: مهارة تُحفّز نفسها
أنشئ ~/.claude/skills/release-notes/SKILL.md:
---
name: release-notes
description: Use when the user asks to write release notes or a changelog from git history.
---
# Release Notes
1. Run `git log <last-tag>..HEAD --oneline` to get the commits.
2. Group them into Features / Fixes / Breaking changes.
3. Write user-facing notes — what changed for *users*, not commit messages.
4. Output Markdown ready to paste into a GitHub release.
لاحقًا تكتب الموجّه أدناه. لم يكن لدى Claude هذه الخطوات في السياق إطلاقًا — لكن الطلب يطابق حقل description، فيسحب SKILL.md الكامل، ويشغّل git log، وينتج ملاحظات مجمَّعة. لم تستدعِ شيئًا بالاسم؛ الوصف هو الذي قام بالتوجيه. أضف ملف scripts/ في المجلد نفسه فتستطيع المهارة تشغيله كجزء من الخطوة 1.
حفّز المهارة بالنية — دون الحاجة إلى اسم
Draft release notes since v1.4.
المهارة مقابل الأمر مقابل الوكيل الفرعي مقابل MCP
| الأداة | ما هي | أنت أم Claude يُحفّز |
|---|---|---|
| أمر الشرطة المائلة | موجّه محفوظ | أنت تستدعيه |
| المهارة | خبرة عند الطلب + سكربتات | Claude يحمّلها عند الصلة |
| الوكيل الفرعي | وكيل مُفوَّض له سياقه الخاص | Claude يفوّض |
| MCP | اتصال بأدوات/بيانات خارجية | يوفّر أدوات للاستدعاء |
- تريد إطلاقه عند الطلب ← أمر شرطة مائلة.
- ينبغي أن يعرف Claude الإجراء ويطبّقه عند الصلة ← مهارة.
- ينبغي أن يحدث العمل في سياق منفصل ← وكيل فرعي.
- تحتاج إلى الوصول إلى نظام خارجي ← MCP.
أخطاء شائعة
- وصف لا يُحفّز. "Helps with PDFs" غامض جدًا؛ أما "Use when the user needs to fill, read, or generate PDF forms" فيخبر Claude بالضبط متى يحمّله. الوصف هو آلية التفعيل بأكملها — اكتبه للمطابقة، لا للبشر.
- وضع كل شيء في CLAUDE.md بدلًا من ذلك. يُحمَّل CLAUDE.md في كل جلسة ويكلّف سياقًا دائمًا؛ أما المهارة فتُحمَّل فقط عند الصلة. انقل الإجراءات الظرفية إلى مهارات واحتفظ بـ CLAUDE.md لقواعد المشروع الصحيحة دائمًا.
- مهارة عملاقة واحدة. مهارات صغيرة كثيرة موصوفة بدقة توجِّه أفضل من مهارة واحدة شاملة — الكشف التدريجي لا يفيد إلا إذا كان كل وصف محددًا.
- نسيان أنها قابلة للمشاركة. مهارة مشروع في .claude/skills/ مُدرَجة في git تمنح الفريق كله القدرة؛ أما المهارة الشخصية في ~/.claude/skills/ فتبقى لك.