Agent Skills: المعيار العالمي لوكلاء البرمجة بالذكاء الاصطناعي

كل أداة برمجة بالذكاء الاصطناعي لديها ملف إعدادات خاص بها. Claude Code يستخدم CLAUDE.md، و Cursor يستخدم .cursorrules، و Copilot لديه ملفات التعليمات الخاصة به. إذا كنت تعمل عبر أدوات متعددة، ستجد نفسك تحافظ على نفس التعليمات بثلاث صيغ مختلفة. معيار Agent Skills و SKILL.md يضع حدًا لهذا التشتت.

مشكلة ملفات الإعدادات الضخمة

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

ملف CLAUDE.md نموذجي قد يحتوي على 2,000 سطر يغطي كل شيء من اتفاقيات Git إلى قرارات قاعدة البيانات. لكن عندما تطلب من الوكيل كتابة اختبار وحدة، يُحمّل كل الـ 2,000 سطر. هذا هدر في السياق وهدر في التكلفة.

والأسوأ أن هذه التعليمات محبوسة في أداة واحدة. انتقل من Cursor إلى Claude Code وعليك البدء من الصفر.

ما هي Agent Skills؟

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

كل مهارة تعيش في مجلد خاص بها مع ملف SKILL.md في جوهرها:

code-review/
├── SKILL.md          # التعليمات والبيانات الوصفية (مطلوب)
├── scripts/          # سكربتات الأتمتة
├── references/       # الوثائق الداعمة
└── assets/           # القوالب والموارد

نشرت Anthropic مواصفات Agent Skills كمعيار مفتوح في agentskills.io في ديسمبر 2025. وبحلول أبريل 2026، تبنّت أكثر من 30 أداة برمجة بالذكاء الاصطناعي هذا المعيار — بما في ذلك OpenAI Codex و Google Gemini CLI و GitHub Copilot و Cursor و JetBrains Junie وغيرها.

الكشف التدريجي: حمّل فقط ما تحتاجه

القرار المعماري الأقوى خلف Agent Skills هو الكشف التدريجي (Progressive Disclosure). بدلاً من تحميل كل شيء عند البدء، تستخدم المهارات نظامًا من ثلاث مستويات:

المستوى الأول: البيانات الوصفية (تُحمّل دائمًا)

عند البدء، يقرأ الوكيل فقط حقلي name و description من كل مهارة — حوالي 100 توكن لكل مهارة. إذا كان لديك 50 مهارة مثبتة، فالتكلفة الإجمالية حوالي 5,000 توكن. الوكيل يعرف ما تفعله كل مهارة دون قراءة تعليمة واحدة.

المستوى الثاني: التعليمات (تُحمّل عند التفعيل)

عندما يتطابق طلبك مع وصف المهارة، يقرأ الوكيل المحتوى الكامل لـ SKILL.md — عادة أقل من 5,000 توكن. هنا تعيش الإرشادات خطوة بخطوة وسير العمل وأفضل الممارسات.

المستوى الثالث: الموارد (تُحمّل حسب الحاجة)

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

هذا يعني أن 50 مهارة مثبتة تكلف توكنات أقل من ملف إعدادات ضخم واحد.

كتابة مهارتك الأولى

كل SKILL.md يبدأ بـ YAML frontmatter:

---
name: code-review
description: >
  Reviews code changes for quality, security, and style.
  Use when the user asks to 'review code', 'check this PR',
  'audit this change', or 'look at my diff'.
---

ثم يحتوي جسم Markdown على تعليماتك:

# مهارة مراجعة الكود
 
## سير العمل
 
1. اقرأ التغييرات في الكود
2. تحقق من الثغرات الأمنية (OWASP Top 10)
3. تحقق من معالجة الأخطاء والحالات الحدية
4. تحقق من نمط الكود وفق اتفاقيات المشروع
5. قدّم ملاحظات قابلة للتنفيذ مع مراجع الأسطر
 
## ما يجب الإبلاغ عنه
 
- ثغرات SQL injection أو XSS
- بيانات اعتماد مكتوبة مباشرة في الكود
- عدم التحقق من المدخلات عند حدود النظام
- الدوال التي تتجاوز 50 سطرًا
- الطرق العامة غير المُختبرة

احفظ هذا كـ .claude/skills/code-review/SKILL.md لـ Claude Code، أو .agents/skills/code-review/SKILL.md للتوافق عبر المنصات.

حقل الوصف هو كل شيء

إذا لم تتفعل مهارتك أبدًا، فالمشكلة في معظم الأحيان في الوصف — وليس في التعليمات. حقل الوصف هو آلية التشغيل للوكيل، وليس توثيقًا للبشر.

وصف ضعيف:

يساعد في جودة الكود

وصف قوي:

Reviews code changes for quality, security, and style.
Use when the user asks to 'review code', 'check this PR',
'audit this change', or 'look at my diff'.

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

التوافق عبر المنصات

اتفاقية مجلد .agents/skills/ أصبحت معيار التشغيل البيني. مهارة واحدة مكتوبة مرة واحدة تعمل عبر جميع الأدوات المتوافقة:

للحصول على أقصى قابلية للنقل، ضع مهاراتك في .agents/skills/ في جذر المستودع. كل أداة متوافقة تفحص هذا المجلد تلقائيًا.

يمكنك أيضًا تثبيت مهارات شخصية في ~/.agents/skills/ للتوفر العام عبر جميع المشاريع.

تضمين السكربتات للعمل الحتمي

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

deploy-checker/
├── SKILL.md
└── scripts/
    └── check_deploy.sh

في SKILL.md الخاص بك، أشِر إلى السكربت:

## فحص ما قبل النشر
 
شغّل سكربت جاهزية النشر:
 
```bash
bash .agents/skills/deploy-checker/scripts/check_deploy.sh
```
 
راجع المخرجات وأبلغ المستخدم عن أي فحوصات فاشلة.

السكربت يتولى العمل الحتمي. الوكيل يتولى التقييم والتواصل.

اعتبارات الأمان

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

قبل تثبيت أي مهارة من طرف ثالث:

• اقرأ كل سطر من SKILL.md وجميع السكربتات المضمنة
• تحقق من وجود استدعاءات شبكة أو أنماط وصول غير متوقعة
• ابحث عن جلب URL خارجي قد يكون ناقلاً لحقن الأوامر
• تحقق من مصداقية المصدر

تتضمن المواصفات حقل allowed-tools التجريبي الذي يحدد الأدوات التي يمكن للوكيل استخدامها:

---
name: readonly-analyzer
description: Analyzes code patterns without modifying files
allowed-tools: Read, Grep, Glob
---

هذا يحد من نطاق الضرر إذا تم اختراق المهارة.

أفضل الممارسات

اجعل المهارات مركزة. مهارة واحدة لكل مجال مهمة. مهارة مراجعة الكود ومهارة النشر يجب أن تكونا منفصلتين.

ابقَ تحت 5,000 توكن. إذا تجاوز SKILL.md هذا الحد، قسّمه إلى مهارات متعددة أو انقل المواد المرجعية الثقيلة إلى ملفات منفصلة.

اكتب بصيغة الأمر. المهارات تعليمات للوكلاء وليس توثيقًا للبشر. استخدم أوامر مباشرة: "شغّل مجموعة الاختبارات" بدلاً من "يجب تشغيل مجموعة الاختبارات".

اختبر التفعيل. اكتب 5-10 أوامر يجب أن تُفعّل مهارتك و 3-5 لا يجب أن تفعلها. تحقق من أن الوكيل يتفعل بشكل صحيح.

استخدم التحكم بالإصدارات. ضع .agents/skills/ في مستودعك. مهارات فريقك المشتركة تتطور جنبًا إلى جنب مع الكود.

النظام البيئي المتنامي

نظام Agent Skills البيئي يتوسع بسرعة. مستودعات مجتمعية مثل awesome-agent-skills على GitHub تجمع مهارات منتقاة، بينما أسواق مثل SkillsMP تقدم الاكتشاف والتوزيع. وتحافظ Anthropic على مستودع anthropics/skills الخاص بها مع تطبيقات مرجعية.

شركات مثل Canva و Stripe و Notion و Zapier نشرت مهارات رسمية، مما يتيح للوكلاء التفاعل مع منصاتها باستخدام أفضل الممارسات المحددة من فرق المنصات نفسها.

من الضخامة إلى النمطية

Agent Skills تمثل نفس التحول الذي حوّل البرمجيات من التطبيقات الضخمة إلى الخدمات المصغرة. بدلاً من ملف إعدادات ضخم واحد يحاول تغطية كل شيء، تُركّب مجموعة من المهارات المركزة التي تتفعل عند الطلب.

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

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

مواصفات Agent Skills متاحة على agentskills.io. التطبيقات المرجعية ومهارات المجتمع متاحة على github.com/anthropics/skills.