ما هي مهارة الوكيل (SKILL.md) وكيف تفحص واحدة

المهارة هي مجلد يحتوي على ملف SKILL.md يوجد في المكان الذي يبحث فيه وكيل البرمجة الخاص بك. يقرأ الوكيل الملف فقط عندما يطابق طلبك محتواه. حتى ذلك الحين، تكلّف المهارة نحو مئة توكن، بينما يسافر الموجّه (prompt) مع كل رسالة تلصقه فيها.

من المحتمل أنك صادفت الكلمة في ملف README: "ثبّت المهارة، ثم اطلب من الوكيل أن...". لا شيء غامض يحدث. فيما يلي: ما يوجد بالداخل، ومتى يدخل نافذة السياق، وكيف تفحص مهارة قبل أن تسمح لها بالدخول إلى جهازك.

ما هي المهارة، وكيف تختلف عن الموجّه#

تصف وثائق Agent Skills من Anthropic (تم التحقق منها في 30 أكتوبر 2026) المهارة بأنها مورد قابل لإعادة الاستخدام قائم على نظام الملفات: مجلد يحتوي على ملف SKILL.md، بالإضافة إلى سكربتات وقوالب وملفات مرجعية اختيارية. يبدأ SKILL.md بترويسة YAML صغيرة (اسم ووصف) ثم يستمر بتعليمات عادية.

فكّر في زميل جديد. الموجّه هو أنك تقف خلف كرسيه وتكرر القواعد كل صباح. أما المهارة فهي ملف تجميع على الرف عليه ملصق على الكعب: "أسلوب رسائل الـ commit. اقرأه عندما يطلب منك أحدهم عمل commit." لا يأخذه إلا عند الحاجة.

حقلان في الترويسة مطلوبان، وللصيغة قواعد. في صيغة Skills الخاصة بـ Claude يكون name بحد أقصى 64 حرفًا: أحرف صغيرة وأرقام وشرطات، ولا يمكن أن يحتوي على الكلمتين "anthropic" أو "claude". لا يمكن أن يكون description فارغًا، ويُحدّ بـ 1,024 حرفًا، ويجب أن يقول ما تفعله المهارة ومتى تُستخدم.

كيف تدخل المهارة إلى نافذة السياق#

تسمّي الوثائق هذا الكشف التدريجي: يقرأ الوكيل المهارة على ثلاث مراحل، ولا تُدفع تكلفة كل مرحلة إلا إذا وصل إليها.

• المستوى 1، يُحمَّل دائمًا. اسم ووصف كل مهارة مثبّتة، نحو 100 توكن لكل مهارة.
• المستوى 2، عند التفعيل. متن SKILL.md، أقل من 5,000 توكن.
• المستوى 3، عند الحاجة فقط. الملفات والسكربتات المرفقة. عندما يشغّل الوكيل سكربتًا، لا تدخل شيفرة السكربت إلى السياق، بل مخرجاته فقط.

أرقام التوكنات هي تقديرات الوثائق، وليست أعدادًا دقيقة.

إليك لماذا يهم هذا لفاتورتك. لنفترض أنك ثبّتت 20 مهارة. 20 × 100 = 2,000 توكن ترافقك من الرسالة الأولى. يعيد الوكيل إرسال سياقه في كل خطوة (مثال الـ 20 خطوة يوضح السبب)، لذا تحمل جلسة من 50 خطوة 50 × 2,000 = 100,000 توكن إدخال من ملصقات المهارات. على DeepSeek-V4-Flash يكون ذلك $0.0015 بالأسعار الحالية.

والآن العكس. لو لُصقت تلك العشرون مهارة كموجّه واحد كبير، لكان كل متن موجودًا في كل طلب: حتى 20 × 5,000 = 100,000 توكن لكل طلب، لا لكل جلسة. هذه الفجوة هي جوهر التحميل عند الطلب. إذا كان مصطلح "نافذة السياق" لا يزال غامضًا، هذا الشرح يغطي ما يملؤها.

تعيش المهارات في السياق، لذا يحتاج النموذج خلف الوكيل إلى مساحة لها. يمتلك DeepSeek-V4-Flash على CheapTokens (المعرّف deepseek-ai/DeepSeek-V4-Flash-0731) نافذة سياق بسعة 380K وحتى 32,768 توكن إخراج لكل إجابة، بسعر واحد في أي وقت من اليوم، وواجهة برمجية متوافقة مع OpenAI وAnthropic. بالنسبة لوكيل الطرفية، اتبع كيفية ربط Claude Code بـ CheapTokens؛ ولأي أداة أخرى، ابدأ من الوثائق. صفحة النموذج نفسه هنا.

اكتب مهارة بسيطة في دقيقتين#

القراءة أسهل بعد كتابة واحدة. تجعل هذه المهارة الوكيل يكتب رسائل commit بصيغة ثابتة. في Claude Code، تعيش المهارات الشخصية في ~/.claude/skills/ ومهارات المشروع في .claude/skills/، لذا يمكن لمهارة مشروع أن ترحل مع المستودع.

mkdir -p ~/.claude/skills/commit-message-style
nano ~/.claude/skills/commit-message-style/SKILL.md   # or any editor

الصق هذا في الملف:

---
name: commit-message-style
description: Writes git commit messages in this project's format. Use when the user asks to commit, to write a commit message, or to summarize staged changes.
---

# Commit message style

1. Run `git diff --staged` and read it.
2. First line: `type(scope): summary`, at most 72 characters. Types: feat, fix, docs, refactor, test.
3. Blank line, then up to three bullets that say why the change was made, not what changed.
4. Do not put file names in the first line.

الآن افتح الوكيل في مستودع فيه تغييرات مجهّزة واطلب: "اكتب رسالة commit لما جهّزته". يرى الوكيل الوصف، ويقرر أنه يطابق، ويقرأ القواعد الأربع ويتبعها. إذا تجاهل المهارة، فانظر إلى description أولًا: يجب أن يسمّي الحالة، هنا "commit"، بالكلمات التي ستستخدمها فعلًا.

ملاحظة واحدة: لا تتزامن المهارات بين claude.ai وواجهة API وClaude Code. المهارة التي أنشأتها في مكان واحد يجب إضافتها إلى الأماكن الأخرى بشكل منفصل.

المهارة وAGENTS.md وMCP: أيّها أيّ#

يُخلط بين هذه الثلاثة طوال الوقت. ملف القواعد مثل AGENTS.md أو CLAUDE.md يُقرأ في بداية الجلسة ويحمل حقائق عن المشروع (كيف يمكن أن يفسد ذلك الملف في مجلد Downloads). يمنح خادم MCP الوكيل أدوات وبيانات جديدة للوصول إليها (MCP بلغة مبسطة). أما المهارة فهي إجراء: كيف تؤدي نوعًا واحدًا من المهام، تُحمَّل عندما تظهر تلك المهمة.

افحص مهارة طرف ثالث قبل التثبيت#

المهارة نص يتبعه الوكيل، وأحيانًا شيفرة يشغّلها الوكيل. تقول الوثائق إن تستخدم المهارات من مصادر موثوقة فقط، وأن تدقق كل ملف مرفق (SKILL.md والسكربتات والموارد)، وأن تبحث عن اتصالات شبكة أو وصول إلى ملفات غير متوقع. المهارات التي تجلب عناوين URL خارجية أكثر خطورة. في Claude Code تمتلك المهارة نفس وصول الشبكة الذي يمتلكه أي برنامج على حاسوبك، لذا تعامل مع التثبيت كتثبيت برمجية.

نموذج جيد هو universal-modder، مجموعة أدوات لتعديل الألعاب. يصف README الخاص به (تم التحقق منه في 30 أكتوبر 2026) مجموعة مهارات بترخيص MIT بصيغة Agent Skills، وأداة سطر أوامر Python تُسمى um، وخادم MCP لتوليد الأصول عبر fal، وقاعدة معرفة مشتركة من ملاحظات ميدانية. تغطي المهارة الرئيسية mod-any-game الاستطلاع والهندسة العكسية وتوليد الأصول والاختبار داخل اللعبة والتغليف. يسرد README كلاً من Claude Code وCodex وCursor وGemini CLI وGitHub Copilot وOpenCode كأدوات مدعومة، ويقول إن المجموعة ترفض تجاوز مكافحة الغش أو DRM. في Claude Code تُثبَّت بـ /plugin marketplace add rehan-remade/universal-modder، ويحتاج توليد الأصول إلى مفتاح API منفصل لـ fal.

لاحظ ما تحتويه تلك القائمة: مهارات وبرنامج سطر أوامر وخادم. قراءة SKILL.md واحد ستغطي شريحة فقط مما تثبّته. لذا راجع الأجزاء:

القاعدة الأساسية موجودة في كيفية تخزين مفتاح API بأمان. لا تُظهر صفحة المستودع تاريخ آخر commit، لذا تحقق من مدى حداثة تحديث المشروع قبل أن تعتمد عليه.