تخطَّ إلى المحتوى
الإثنين, نوفمبر 16, 2026أخبار تقنية مستقلة ومراجعات وأدلة عملية
نبذة
الأحدث /

مهارات الوكلاء وخوادم MCP مشروحة: كيف تثبّتها وتحدّثها وتصلحها في OpenCode وClaude Code وCodex ووكلاء ذكاء اصطناعي آخرين

اقرأ الدليل
وكلاء الذكاء الاصطناعيGM / 997

مهارات الوكلاء وخوادم MCP مشروحة: كيف تثبّتها وتحدّثها وتصلحها في OpenCode وClaude Code وCodex ووكلاء ذكاء اصطناعي آخرين

شرح مبسّط لمهارات الوكلاء وخوادم MCP: تثبيتها وتحديثها وإصلاحها في OpenCode وClaude Code وCodex، مع أداة npx skills CLI خطوة بخطوة.

Agent skills and MCP servers explained: a tech.grahammiranda.com title card with SKILL.md, npx skills, MCP servers and .agents/skills, and a terminal running npx skills check and opencode mcp add

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

يشرح هذا الدليل الاثنين بلغة بسيطة، ثم يعرض عليك كيفية تثبيتهما وتحديثهما وإزالتهما واستكشاف مشكلاتهما في OpenCode وClaude Code وCodex وGemini CLI وCursor وGitHub Copilot وHermes Agent. ومعظم ذلك يعمل بالطريقة نفسها في كل مكان، لأن الاثنين صارا معيارين مفتوحين. وفي جانب المهارات، هناك أداة سطر أوامر صغيرة واحدة تربط كل شيء معًا، npx skills، وسأمرّ عليها أمرًا بأمر.

لست مطوّرًا بحكم التدريب. أدير شركة تقنية معلومات صغيرة في ألمانيا وأبني البرمجيات بوكلاء الذكاء الاصطناعي، لذلك تعلّمت معظم هذا بالطريقة التي ستتعلّمها بها على الأرجح: بكسر الأشياء. والجزء 6 مبني على جلسات طرفية خاصة بي على جهاز Mac وRaspberry Pi، بما في ذلك المرة التي أخبرتني فيها الأداة أن كل مهاراتي محدّثة بينما لم تنجح في فحص مهارة واحدة.

كل ما يلي تم التحقق منه مقابل الوثائق الرسمية لكل وكيل، وبالنسبة إلى المهارات CLI، مقابل الكود المصدري المنشور للإصدارات 1.5.18 إلى 1.8.1، في 15 نوفمبر 2026. تتغيّر هذه الأدوات أسبوعيًا: فقد أصدرت الـ CLI نسختين هذا الأسبوع وحده، ووصل OpenCode إلى 2.3.0 في 13 نوفمبر. وأرقام الإصدارات والسلوكيات موسومة حيث يُرجّح أن تتغيّر. تحقّق منها قبل أن تعتمد عليها.

الإفصاح: لم ترعَ أي شركة مذكورة في هذا المقال العمل ولم تراجعه ولم توافق عليه، ولا يحتوي على روابط تابعة. والمنتجات تُذكر في النص فقط؛ والصور تستخدم شعاراتي الخاصة.


TL;DR — مهارات الوكلاء وخوادم MCP في عشر نقاط

  • المهارة مجلد يحتوي على SKILL.md ملف: اسم ووصف في الأعلى، وتعليمات أسفله، وسكربتات أو ملفات مرجعية اختيارية. ولا يقرأ الوكلاء إلا الوصف حتى تحتاج المهمة إلى المهارة، لذا تكلّف المهارة غير المستخدمة نحو 100 رمز من انتباه الوكيل.
  • يمنح خادم MCP الوكيل أدوات جديدة، مثل GitHub أو متصفح أو وثائق حيّة. ويمكن أن ترافق أوصاف الأدوات كل طلب، لذا لا تصل إلا الخوادم التي تستخدمها. ويؤجّل Claude Code أوصافها الآن حتى الحاجة إليها، ويجمّعها OpenCode حسب الخادم.
  • القاعدة العملية: قواعد العمل الخاصة بكل مهمة توضع في AGENTS.md؛ والمعرفة اللازمة لبعض المهام تصبح مهارة؛ والوصول الحي إلى نظام يحتاج إلى خادم MCP؛ وإذا وُجدت أداة سطر أوامر جيدة بالفعل، فإن مهارة تعلّم الوكيل تلك الأداة غالبًا أرخص من خادم.
  • كلاهما معياران مفتوحان تحت مؤسسة Agentic AI Foundation التابعة لمؤسسة Linux: MCP منذ ديسمبر 2025، ومهارات الوكلاء منذ 22 أكتوبر 2026. والمهارة المكتوبة لوكيل واحد تعمل عادة في الوكلاء الآخرين.
  • .agents/skills هو المجلد المشترك. Codex وOpenCode وCursor وGemini CLI وGitHub Copilot كلها تقرأ .agents/skills في مشروع و ~/.agents/skills في مجلدك الرئيسي. ولا يقرأ Claude Code إلا .claude/skills، ويقرأ Hermes Agent ~/.hermes/skills بالإضافة إلى أي مجلدات تضيفها.
  • npx skills هو npm للمهارات. أداة CLI مفتوحة المصدر من Vercel (الإصدار 1.8.1) تثبّت المهارات في 79 وكيلًا: npx skills add owner/repo, -g لكل مشروع، -a opencode -a claude-code لاختيار الوكلاء، npx skills ls لعرض القائمة، و npx skills remove لإلغاء التثبيت.
  • لمعرفة ما إذا كانت مهاراتك محدّثة، شغّل npx skills@latest check. منذ الإصدار 1.7.5 (2 نوفمبر 2026) صار يكتفي بالإبلاغ؛ npx skills update يثبّت. وفي الإصدارات السابقة، check كان يشغّل التحديث بصمت.
  • لا تثق بعلامة الصح الخضراء وحدها. عندما أوقف حد GitHub البالغ 60 طلبًا مجهولًا في الساعة كل عملية تحقّق على جهاز Mac، ظلّت أداة CLI تطبع “All global skills are up to date”. شغّل gh auth login أو عيّن GITHUB_TOKEN، واقرأ أسطر ✗.
  • لا تستخدم sudo مع المهارات أو الوكلاء، ولا تشغّل أداة CLI من مجلدك الرئيسي. يملك root مجلدًا رئيسيًا منفصلًا، لذا sudo يُنشئ مخزن مهارات ثانيًا غير مرئي؛ ومن ~ تظنّ أداة CLI أن مجلدك الرئيسي مشروع.
  • تعامل مع المهارات وخوادم MCP مثل البرامج التي تثبّتها. وجد تدقيق أُجري في فبراير 2026 على 3,984 مهارة عامة عيوبًا أمنية في 36.82% منها، وأكّد وجود حمولات خبيثة في 76 منها. اقرأ قبل أن تثبّت، وفضّل المهارات من صانعي الأداة أنفسهم، وثبّت الإصدارات، وأبقِ الأدوات المحفوفة بالمخاطر على وضع “ask”.

المكوّنات الأربعة الأساسية في لمحة

المكوّن ما هو في سطر واحد تصوّره على أنه متى يقرأه الوكيل كم تبلغ تكلفته مثال
AGENTS.md (CLAUDE.md في Claude Code) ملف Markdown بقواعد العمل الخاصة بمشروع واحد دليل الموظفين في بداية كل جلسة، بالكامل طوله كاملًا في كل طلب “استخدم الإملاء البريطاني. شغّل الاختبارات قبل أن تقول إنك انتهيت.”
مهارة مجلد يحتوي على SKILL.md وصفة، إضافة إلى سكربتات ومراجع اختيارية بطاقة وصفة في مُجلَّد الاسم والوصف في البداية؛ والوصفة كاملة فقط عندما تحتاجها المهمة نحو 100 رمز لكل مهارة حتى تُستخدم “كيف نكتب ملاحظات الإصدار”
خادم MCP برنامج صغير يمنح الوكيل أدوات جديدة مجموعة من المفاتيح والمحوّلات قائمة الأدوات في البداية (ما لم يؤجّلها وكيلك)؛ والأدوات الفردية عند استدعائها أوصاف الأدوات، غالبًا في كل طلب مشكلات GitHub، متصفح حقيقي، وثائق المكتبات الحالية
إضافة أو امتداد حزمة من المهارات وخوادم MCP وأحيانًا خطافات حزمة ترحيب يعتمد على ما بداخلها مجموع أجزائها Superpowers، حزمة بداية من أحد المورّدين
مهارات الوكلاء وخوادم MCP مشروحة: AGENTS.md كدليل مرجعي يُحمَّل دائمًا، والمهارات كبطاقات وصفات تُحمَّل عند الطلب، وخوادم MCP كأدوات لـGitHub ومتصفح ووثائق حية، والإضافات كحزم
أربع لبنات بناء، وكيل واحد. الدليل مفتوح دائمًا، وبطاقات الوصفات تُسحب من الرف عند الحاجة، وخوادم MCP هي مفاتيح كل ما هو خارج الطرفية.

جدول المحتويات


الجزء 1 — مهارات الوكلاء وخوادم MCP بلغة بسيطة

صورة الموظف الجديد

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

وكلاء الذكاء الاصطناعي يحتاجون الشيء نفسه بالضبط، ولكل جزء الآن اسم قياسي:

  • الدليل هو AGENTS.md (يسمّي Claude Code نسخته CLAUDE.md).
  • الوصفات هي المهارات.
  • المفاتيح هي خوادم MCP.
  • أطقم الترحيب هي إضافات، تُسمى امتدادات في بعض الوكلاء.

وبقية هذا الدليل تدور حول الوصفات والمفاتيح، لأن معظم الالتباس يكمن هناك’.

ما هي المهارة

المهارة مجلد. بداخله ملف واحد مطلوب، SKILL.md، واختياريًا أي شيء آخر تحتاجه المهمة:

release-notes/
├── SKILL.md          ← مطلوب: الاسم، الوصف، التعليمات
├── references/       ← اختياري: مستندات أطول، تُقرأ عند الحاجة فقط
├── scripts/          ← اختياري: كود يمكن للوكيل تشغيله
└── assets/           ← اختياري: قوالب، صور، ملفات بيانات

الـ SKILL.md يحتوي الملف على ترويسة قصيرة بين --- سطرين (تُسمى هذه الترويسة front matter)، ثم تعليمات بسيطة:

---
name: release-notes
description: يكتب ملاحظات "ما الجديد" في App Store من الالتزامات الأخيرة. استخدمه عند طلب ملاحظات إصدار أو سجل تغييرات أو نص "ما الجديد".
---

# ملاحظات الإصدار

1. اقرأ الالتزامات منذ آخر وسم git.
2. أبقِ فقط التغييرات التي سيلاحظها المستخدم.
3. اكتب من ثلاث إلى خمس نقاط قصيرة بإنجليزية بسيطة، بإجمالي أقل من 400 حرف.

يطلب المعيار المفتوح حقلين. أما تسمية فيجوز أن يستخدم أحرفًا صغيرة وأرقامًا وشرطات فقط، وبحد أقصى 64 حرفًا، ويجب أن يطابق اسم المجلد. أما الوصف فيبلغ 1,024 حرفًا كحد أقصى، وينبغي أن يوضح ما تفعله المهارة ومتى تُستخدم، لأن الوصف هو ما يقرر به الوكيل ما إذا كان سيفتح المهارة أصلًا.

لماذا يمكنك تثبيت عشرات المهارات: حيلة الطبقات الثلاث

تُحمَّل المهارات على طبقات، وهو ما يسميه المعيار الكشف التدريجي. فكّر في رف كتب:

  1. أغلفة الكتب الخلفية. عند بدء جلسة’، لا يقرأ الوكيل سوى اسم كل مهارة ووصفها. وتخصص المواصفة نحو 100 توكن لكل مهارة لهذا الغرض. (التوكن تقريبًا كلمة قصيرة أو جزء من كلمة’، وهو الوحدة التي تحسب بها النماذج ذاكرتها العاملة.)
  2. الفصل. وعندما تطابق مهمة وصف مهارة’، يقرأ الوكيل الملف الكامل لـ SKILL.md. توصي المواصفة بإبقائه تحت 5,000 توكن و500 سطر.
  3. الملحق. لا تُحمَّل ملفات المراجع والسكربتات إلا إذا أشارت التعليمات إليها.

ولهذا السبب’ تكلّف مئة مهارة غير مستخدمة أقل بكثير من دليل قواعد واحد طويل. لكنها ليست مجانية’: فالأوصاف تتراكم، والوكلاء يضعون حدًا لها. يحدّ Codex قائمة مهاراته الأولية بنسبة 2% من ذاكرة النموذج’ العاملة (8,000 حرف إذا لم يستطع’ تحديد الحجم)، ويقطع Claude Code نص كل مهارة’ في القائمة عند 1,536 حرفًا. ثبّت ما ستستخدمه’.

ما هو خادم MCP

MCP، أي بروتوكول سياق النموذج (Model Context Protocol)، معيار مفتوح لربط وكلاء الذكاء الاصطناعي بالأدوات والبيانات. قدّمته Anthropic في نوفمبر 2024 وسلّمته إلى مؤسسة Agentic AI’ الجديدة التابعة لمؤسسة Linux في ديسمبر 2025، إلى جانب AGENTS.md من OpenAI’ وgoose من Block’.

إلى خادم MCP هو برنامج صغير يقول لوكيلك: “هذه هي الأدوات التي أقدمها”. وقد يقدم خادم GitHub create_issue و search_code؛ ويقدم خادم متصفح navigate و take_screenshot؛ ويقدم خادم توثيق query_docs. ووكيلك هو عميل MCP: يعرض للطراز قائمة الأدوات، وعندما يريد الطراز استخدام أداة، يتحقق الوكيل من أذوناتك، ويطلب من الخادم تشغيلها، ثم يمرّر النتيجة مرة أخرى.

تأتي الخوادم في نوعين:

  • خوادم محلية تعمل على حاسوبك أنت. يشغّلها الوكيل بأمر مثل npx @playwright/mcp@latest ويتواصل معها عبر إدخال البرنامج وإخراجه (الاسم التقني هو stdio).
  • خوادم بعيدة تعمل على حواسيب المزوّد. تتصل بها عبر عنوان ويب، مثل https://mcp.context7.com/mcp، وعادةً تسجّل الدخول عبر متصفحك أو تلصق مفتاح API. الاسم التقني للاتصال هو Streamable HTTP.

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

AGENTS.md والإضافات، باختصار

AGENTS.md ملف Markdown عادي في المجلد الجذر لمشروعك يقرأه الوكيل في بداية كل جلسة: غرض المشروع، وأوامره، وأموره غير القابلة للتفاوض. يقرأه OpenCode وCodex وCursor وGitHub Copilot مباشرة. أما Claude Code فيقرأ CLAUDE.md بدلًا منه، وتقترح وثائقه ملفًا CLAUDE.md يستورد الملف الآخر ببساطة بسطر نصه @AGENTS.md. ولأنه يُحمَّل في كل مرة، أبقِه قصيرًا وانقل أي شيء خاص بمهمة معيّنة إلى المهارات.

الإضافات تجمع الأجزاء الأخرى. إضافة Claude Code قد تحتوي على مهارات، ووكلاء فرعيين، وخطّافات (سكربتات تعمل عند وقوع أحداث)، وخوادم MCP وLSP. ولدى Codex وCursor وGitHub Copilot CLI وHermes Agent إضافات أيضًا، ويسمّيها Gemini CLI امتدادات. يغطيها الجزء 9.

معجم مصغّر

الكلمة معناها هنا
الوكيل (أو هارنس) البرنامج الذي تتحدث إليه: OpenCode وClaude Code وCodex وغيرها. يشغّل الطراز، ويقرأ الملفات، ويستدعي الأدوات
الطراز الذكاء الاصطناعي الذي يقوم بالتفكير، مثل GLM أو Claude أو GPT
نافذة السياق ذاكرة عمل الطراز لطلب واحد. كل ما تحمّله يتنافس عليها
الرمز الوحدة التي تعدّ بها الطرازات النص؛ تقريبًا كلمة قصيرة أو جزء منها
مهارة مجلد يحتوي على SKILL.md ملف يعلّم الوكيل مهمة واحدة
البيانات الأمامية الترويسة في أعلى SKILL.md، بين --- سطرين
خادم MCP برنامج يقدّم للوكيل أدوات عبر بروتوكول سياق الطراز (Model Context Protocol)
الأداة إجراء واحد يقدّمه خادم MCP، مثل create_issue
stdio / Streamable HTTP كيف يتواصل الوكيل مع خادم محلي وخادم بعيد
OAuth تدفّق “تسجيل الدخول باستخدام…” في متصفحك الذي يمنح الوكيل رمزًا دون أن تلصق كلمة مرور
نطاق المشروع / النطاق العام مثبّتة لمشروع واحد فقط، أو لكل مشروع على حاسوبك
ملف القفل إيصال يسرد ما ثبّته، ومن أين، وبصمة لكل مهارة
رابط رمزي اختصار إلى مجلد. يحتفظ skills CLI بنسخة حقيقية واحدة ويربط الوكلاء بها

الجزء 2 — مهارة أم خادم MCP أم AGENTS.md؟ اختبار الأسئلة الخمسة

حين تريد أن يؤدي الوكيل أمرًا ما على نحو أفضل، اطرح هذه الأسئلة بالترتيب وتوقف عند أول “نعم”. السؤال الرابع هو الوحيد الذي يتبعه سؤال إضافي:

  1. هل يجب أن ينطبق على كل مهمة في هذا المشروع بلا استثناء؟ ضعه في AGENTS.md. “استخدم الإملاء البريطاني” و“شغّل الاختبارات قبل أن تقول إنك انتهيت” مكانهما هنا.
  2. هل يجب أن يكون مفروضًا، لا مجرد اقتراح؟ استخدم قاعدة صلاحيات أو خطافًا. المهارات و AGENTS.md تعليمات، ويمكن للنموذج أن يتجاهل التعليمات. “لا تدفع إلى main أبدًا” يحتاج إلى deny قاعدة.
  3. هل هي معرفة عملية تهم في بعض المهام فقط؟ اكتب مهارة أو ثبّتها. روتين الإصدار، وقوائم المراجعة، ونبرة علامتك، وسير عملك القائم على الاختبار أولًا، كلها مهارات.
  4. هل يحتاج الوكيل وصولًا حيًا إلى نظام خارج ملفاته؟ تقارير الأعطال خلف تسجيل دخول، أو متصفح يستطيع تشغيله، أو تطبيق إدارة مشاريع. إن كان الأمر كذلك، اطرح السؤال الخامس قبل أن تلجأ إلى خادم.
  5. هل توجد أداة سطر أوامر جيدة لذلك النظام أصلًا؟ إن كان الجواب نعم، فمهارة تعلّم الوكيل تلك الأداة تتفوق عادة على الخادم: الوكيل يعرف أصلًا كيف يشغّل الأوامر، وCLI لا يكلّف شيئًا حتى يُستخدم، ويمكن تصفية مخرجاته قبل أن تصل إلى النموذج. وإن لم توجد أداة CLI جيدة، أو كان وكيلك لا يستطيع تشغيل الأوامر، أو كانت المهمة تفاعلية (مثل تشغيل متصفح)، فأضف خادم MCP.

إليك الاختبار مطبّقًا على عشر رغبات يومية:

تريد أن يقوم الوكيل بـ… استخدم لماذا
استخدام الإملاء البريطاني دائمًا AGENTS.md ينطبق على كل مهمة
عدم الدفع إلى الفرع main أبدًا قاعدة صلاحيات يجب فرضه، لا اقتراحه
كتابة ملاحظات الإصدار بالطريقة التي تحبها مهارة معرفة عملية، تُحتاج أحيانًا
اتباع سير عمل صارم قائم على الاختبار أولًا مهارة (لدى Superpowers واحدة) إجراء لبعض المهام
قراءة مسائل GitHub وإيداعها مهارة تعلّم gh، أو خادم MCP الخاص بـ GitHub gh أرخص؛ والخادم يناسب الوكلاء الذين لا يستطيعون تشغيل الأوامر
البحث عن الوثائق الحالية لمكتبة برمجية خادم MCP (Context7) أو أداة CLI الخاصة به مع مهارة (ctx7) بيانات حية في الحالتين
تنقّل في تطبيق الويب الخاص بك وخُذ لقطات شاشة خادم MCP (Playwright) يحتاج إلى متصفح يعمل ويستطيع الوكيل التحكم به
تحقّق من أعطال الليلة الماضية خادم MCP (Sentry) بيانات حيّة خلف تسجيل الدخول
أنشئ تقرير PDF من قالبك مهارة فيها سكربت والقالب بداخلها assets/ إجراء مع أداة مرفقة
أبعِدها عن .env ملفاتك قاعدة صلاحيات يجب فرضه

المهارات وخوادم MCP ليست منافسة. بعض أفضل الإعدادات تجمع بينهما: المهارة تشرح وقت و كيف كيفية استخدام أدوات الخادم، والخادم يقوم بالعمل. بل يسمح Codex للمهارة بأن تعلن خوادم MCP التي تعتمد عليها، في ملف اختياري agents/openai.yaml الذي نزّلته.

مهارة أم خادم MCP أم AGENTS.md: مسار من خمسة أسئلة يوجّه قواعد كل مهمة إلى AGENTS.md، والقواعد الملزمة إلى الأذونات، والمعرفة العملية إلى المهارات، والوصول الحي إلى النظام إلى مهارة CLI أو خادم MCP
خمسة أسئلة تُطرح بالترتيب. معظم الطلبات تتبيّن أنها مهارات؛ والخادم يستحق مكانه عندما يحتاج الوكيل إلى وصول حيّ ولا توجد أداة سطر أوامر جيدة.

الجزء 3 — أين يبحث كل وكيل عن المهارات

كل وكيل يبحث في نوعين من المواقع. مجلدات المشروع تعيش داخل مستودعك، فترحل المهارات مع الكود ويحصل عليها زملاؤك أيضًا. المجلدات الشخصية تعيش في مجلدك الرئيسي وتنطبق على كل مشروع على حاسوبك. معظم الأدوات تسمّي التثبيتات الشخصية عامة.

في 2026 اتّفقت الوكلاء على موقع مشترك واحد: .agents/skills في مشروع و ~/.agents/skills في مجلدك الرئيسي. ضع مهارة هناك فيجدها معظم الوكلاء دون أي عمل إضافي.

الوكيل مجلدات المشروع المجلدات الشخصية استدعِ مهارة بنفسك جدير بالمعرفة
OpenCode .opencode/skills, .agents/skills, .claude/skills ~/.config/opencode/skills, ~/.agents/skills, ~/.claude/skills اذكُر @skill-id في الموجّه الخاص بك المعرّف هو اسم المجلد. تحكّم في المهارات عبر skill إذن
Claude Code .claude/skills ~/.claude/skills /skill-name لا يقرأ .agents/skills. تظهر مهارات الإضافة بصيغة /plugin-name:skill-name
Codex .agents/skills، في كل مجلد من نقطة انطلاقك حتى جذر المستودع ~/.agents/skills، بالإضافة إلى /etc/codex/skills للمسؤولين $skill-name، أو /skills يأتي مع نسخة مدمجة من $skill-installer
Gemini CLI .agents/skills, .gemini/skills ~/.agents/skills, ~/.gemini/skills /skills list؛ يطلب النموذج إذنك قبل تفعيل واحدة .agents/skills تفوز عندما تتشارك مهارتان الاسم نفسه
Cursor .agents/skills, .cursor/skills (ويقرأ .claude/skills و .codex/skills) ~/.agents/skills, ~/.cursor/skills /skill-name A المسارات الحقل يقيّد المهارة بالملفات المطابقة
GitHub Copilot .github/skills, .agents/skills, .claude/skills ~/.copilot/skills, ~/.agents/skills يحمّل المهارات عند الحاجة يعمل في Copilot CLI ووكيل السحابة ووضع الوكيل في VS Code وJetBrains
Hermes Agent .hermes/skills, .agents/skills، بعد أن تشغّل hermes skills trust ~/.hermes/skills، بالإضافة إلى أي مجلدات مذكورة في skills.external_dirs /skill-name، وحتى خمسة على التوالي يفحص كل تثبيت من المركز بحثًا عن محتوى ضار

المسارات من وثائق كل وكيل في 15 نوفمبر 2026. الوكلاء يضيفون مواقع بانتظام؛ تحقق من صفحة المهارات لدى وكيلك إذا لم يظهر شيء.

ثلاثة تفاصيل تجنّبك الارتباك

  • Claude Code هو الاستثناء. إنه يقرأ فقط .claude/skills و ~/.claude/skills. تتولى أداة skills CLI هذا عنك بإنشاء رابط من مجلد Claude Code إلى النسخة المشتركة. إذا نسخت المهارات يدويًا، ستحتاج إلى وضعها (أو رابط رمزي) في مجلد Claude Code بنفسك.
  • يحتفظ Hermes Agent بمكتبته الخاصة. مجلده الأساسي هو ~/.hermes/skills. لجعله يقرأ المجلد المشترك أيضًا، أضفه في ~/.hermes/config.yaml:

yaml skills: external_dirs: - ~/.agents/skills

أو ثبّت باستخدام skills CLI وأدرج -a hermes-agent. اختر نهجًا واحدًا لا الاثنين، وإلا ستحصل على كل مهارة مرتين. – الأسماء المكررة تسبب مفاجآت صامتة. لكل وكيل قاعدته الخاصة في أي نسخة تفوز. يسجّل OpenCode مجلداته بترتيب ثابت وتفوز الأخيرة، مع مجلد مشروعك .opencode/skills في آخر المطاف. يفعل Claude Code العكس: المهارة الشخصية تتغلب على مهارة المشروع بالاسم نفسه. يفضّل Gemini CLI مساحة العمل على المستخدم و .agents على .gemini، وCodex يعرض كليهما ببساطة. الحل ممل وموثوق: لا تحتفظ بمهارتين بالاسم نفسه.

لدى OpenCode إضافتان تستحقان المعرفة. ملف Markdown واحد في أعلى مجلد المهارات (مثل skills/review.md) يُحتسب أيضًا كمهارة، و المهارات مصفوفة في opencode.jsonc يمكنه إضافة مجلدات إضافية أو حتى كتالوج ويب للمهارات. أما دليل OpenCode الخاص بي فيغطي أذونات المهارات فيه بمزيد من العمق.

أين يبحث وكلاء الذكاء الاصطناعي عن المهارات: مجلد .agents/skills المشترك الذي يقرأه Codex وOpenCode وCursor وGemini CLI وGitHub Copilot، مع روابط إلى .claude/skills الخاص بـClaude Code و~/.hermes/skills الخاص بـHermes Agent
مجلد مشترك واحد يغطي معظم الوكلاء. يحتاج Claude Code دائمًا إلى رابط، ويحتاج Hermes Agent إلى رابط للمهارات العامة؛ وأداة skills CLI تنشئ كليهما.

الجزء 4 — المهارات CLI: npm لمهارات الوكلاء، خطوة بخطوة

يمكنك تثبيت المهارات بنسخ المجلدات، وهذا مقبول لمهارة أو اثنتين. بعد ذلك تحتاج إلى مدير حزم: شيء يعرف أين يبحث كل وكيل، ويحتفظ بنسخة واحدة بدل خمس، ويتذكر من أين جاءت كل مهارة، ويخبرك عند وجود إصدار أحدث. هذا ما المهارات تفعله. إنها أداة سطر أوامر مفتوحة المصدر (MIT) من Vercel Labs، تشغّلها بـ npx skills، ودليل مهاراتها العامة موجود على skills.sh.

الحقائق المهمة في 15 نوفمبر 2026:

  • الإصدار 1.8.1، صدر في 11 نوفمبر. إنها سريعة التطور: الانتقال من 1.7.5 إلى 1.8.1 استغرق تسعة أيام.
  • تحتاج إلى Node.js 22.20 أو أحدث.
  • تدعم 79 وكيلًا، من بينها OpenCode وClaude Code وCodex وCursor وGemini CLI وGitHub Copilot وHermes Agent.
  • تثبّت من GitHub (owner/repo)، أو GitLab، أو Azure Repos، أو أي عنوان Git، أو مجلد محلي، أو رابط تنزيل مباشر إلى SKILL.md أو أرشيف.

الخطوة 0 — تحقق من Node.js، واطلب دائمًا أحدث إصدار

node --version      # يحتاج إلى v22.20.0 أو أحدث

إذا ظهر إصدار أقدم أو ظهرت رسالة “command not found”، فثبّت إصدار LTS الحالي من nodejs.org. على Mac مع Homebrew، brew install node يعمل أيضًا. على Raspberry Pi، غالبًا ما يكون الإصدار في قائمة حزم نظام التشغيل نفسه قديمًا جدًا، لذا استخدم برامج التثبيت المرتبطة من الصفحة نفسها.

ثم اجعل عادة واحدة تلقائية: اكتب npx skills@latest بدلًا من npx skills لأي أمر يتحقق أو يحدّث. أما npx فقد يعيد استخدام نسخة نزّلها قبل أسابيع، ومع هذه الأداة، الإصدار الذي تشغّله يغيّر ما تفعله الأوامر (يشرح الجزء 5 أكبر مثال على ذلك).

الخطوة 1 — انظر قبل أن تثبّت

npx skills@latest add vercel-labs/agent-skills --list

--list يعرض كل مهارة في المستودع مع وصفها ولا يثبّت شيئًا. ثم افتح المستودع في المتصفح واقرأ SKILL.md لأي شيء أنت على وشك تثبيته، إضافة إلى أي نصوص برمجية بجانبه. على skills.sh، تعرض صفحة كل مهارة أيضًا نتائج التدقيق الأمني (الجزء 11).

الخطوة 2 — ثبّت مهارة للوكلاء الذين تستخدمهم

# مهارة واحدة، لـ OpenCode وClaude Code، في المشروع الحالي
npx skills add vercel-labs/agent-skills --skill web-design-guidelines -a opencode -a claude-code

# المهارة نفسها لكل مشروع على هذا الحاسوب
npx skills add vercel-labs/agent-skills --skill web-design-guidelines -g -a opencode -a claude-code

# ثبّت وسم إصدار أو commit كاملًا، لتكون التحديثات متعمدة
npx skills add owner/[email protected] --skill my-skill

اترك --skill و -a وتسألك الأداة تفاعليًا: أي مهارات، وأي وكلاء، وهل تريد الربط أو النسخ. وإليك أين ينتهي كل شيء:

النطاق النسخة الحقيقية الوحيدة روابط للوكلاء الذين لديهم مجلد خاص بهم سجل ما ثبّته
المشروع (الافتراضي) ./.agents/skills/<name> مثلًا ./.claude/skills/<name> لـ Claude Code ./skills-lock.json
عام (-g) ~/.agents/skills/<name> مثلًا ~/.claude/skills/<name>, ~/.hermes/skills/<name> ~/.agents/.skill-lock.json

يحتفظ CLI بـ نسخة حقيقية واحدة في .agents/skills، وهي النسخة التي يقرأها معظم الوكلاء مباشرة، وينشئ روابط (روابط رمزية، أي اختصارات في الأساس) للوكلاء الذين يبحثون في مكان آخر. نسخة واحدة تعني تحديثًا واحدًا. إذا لم يتعامل نظامك مع الروابط الرمزية جيدًا، وهو ما قد يحدث على Windows، فأضف --copy للحصول على نسخ مستقلة بدلًا من ذلك.

الخطوة 3 — اعرف ما هو مثبَّت

npx skills ls              # مهارات هذا المشروع
npx skills ls -g           # مهاراتك العامة
npx skills ls -a opencode  # فقط ما يحصل عليه OpenCode
npx skills ls --json       # قابل للقراءة آليًا، للسكربتات

بالنسبة لمهارات المشروع، تعرض الإصدارات الحالية أيضًا حالة: متعقَّبة (تطابق ملف القفل)، معدَّلة (قمت أنت أو الوكيل بتعديلها)، غير متعقَّبة (لا يوجد لها إدخال في ملف القفل، مثل مهارة كتبتها يدويًا) أو مفقودة (موجودة في ملف القفل ولكنها غير موجودة على القرص).

الخطوة 4 — ابحث عن المهارات

npx skills find                    # بحث تفاعلي
npx skills find seo                # البحث بكلمة مفتاحية
npx skills find react --owner vercel   # مستودعات مؤسسة واحدة فقط

أو تصفّح skills.sh، الذي يرتّب المهارات حسب عدد عمليات التثبيت ويجمعها حسب الموضوع. المهارة الأكثر تثبيتًا فيه اليوم هي find-skills من مستودع Vercel نفسه، وهي تعلّم وكيلك أن يبحث عن المهارات بنفسه. أعداد التثبيت تتغير يوميًا، لذا اعتبر الترتيب مجرد تلميح، لا مراجعة.

الخطوة 5 — جرّب مهارة دون تثبيتها

npx skills use vercel-labs/agent-skills@web-design-guidelines

يطبع هذا موجّهًا جاهزًا لتلك المهارة، يمكنك تمريره عبر أنبوب أو لصقه في وكيل على الحاسوب نفسه. أضف --agent claude-code وسيبدأ CLI تشغيل Claude Code وقد حُمّلت المهارة. هذه طريقة جيدة لاختبار مهارة قبل أن تصبح جزءًا من إعدادك.

الخطوة 6 — أزل المهارات

npx skills remove web-design-guidelines            # من هذا المشروع
npx skills rm --global web-design-guidelines       # من مهاراتك العامة
npx skills remove --agent claude-code my-skill     # من وكيل واحد فقط
npx skills remove vercel-labs/agent-skills         # كل ما يأتي من ذلك المصدر
npx skills remove                                  # اختر من قائمة

npx skills remove --all يزيل كل مهارة مسجَّلة في ملف القفل ويتخطى المجلدات التي لم يثبّتها، مثل المهارات التي كتبتها بنفسك، لذا لن يحذف عملك الخاص.

الخطوة 7 — أنشئ مهارتك الخاصة

npx skills init my-skill فيُنشئ my-skill/SKILL.md من قالب. يستعرض الجزء 10 مثالًا كاملًا.

الأداة كلها على بطاقة واحدة

أريد أن… الأمر
معرفة ما يقدّمه المستودع npx skills@latest add owner/repo --list
ثبّت مهارة واحدة في هذا المشروع npx skills add owner/repo --skill name
ثبّت لكل مشروع add -g
اختر الوكلاء add -a opencode -a claude-code (أو --agent '*' للجميع)
ثبّت دون أي أسئلة add -y
ثبّت إصدارًا محددًا npx skills add owner/[email protected] --skill name
اعرض المهارات المثبّتة npx skills ls · npx skills ls -g
بحث npx skills find keyword
تحقّق من التحديثات (للقراءة فقط) npx skills@latest check · add -g أو -p
ثبّت التحديثات npx skills update · -g · -p · -y · أو سمِّ المهارات
أزل npx skills remove name · add -g للنطاق العام
استعد مهارات المشروع من ملف القفل الخاص به npx skills install
ابدأ مهارة جديدة npx skills init name

أوامر skills 1.8.1. npx skills install (اسم بديل لـ experimental_install) و experimental_sync الأمر الخاص بالمهارات المشحونة داخل حزم npm موسوم بأنه تجريبي وقد يتغيّر.

ورقة مرجعية لأوامر npx skills في CLI: أوامر add وlist وfind وuse وcheck وupdate وremove وinit مع أكثر خياراتها فائدة، ومواضع التثبيت في المشروع وعلى المستوى العام، وملفَّي القفل
واجهة skills CLI في بطاقة واحدة. عادتان تقومان بمعظم العمل: --list قبل أن تثبّت، و @latest كلما تحقّقت أو حدّثت.

ما هو ملف القفل، وهل ينبغي أن أودعه في Git؟

ملف القفل إيصال. يسجّل لكل مهارة من أين جاءت و بصمة لمجلدها (تقنيًا تجزئة: رمز قصير يتغيّر كلما تغيّر أي ملف في المجلد). تحتفظ واجهة CLI بنوعين:

  • skills-lock.json في المشروع. أودعه في Git. على حاسوب آخر، أو لزميل في الفريق، npx skills install يستعيد المهارات نفسها بالضبط، و --frozen-lockfile (الافتراضي في CI) يرفض المتابعة إذا اختلف أي شيء. هذا يجعل مهارات المشروع قابلة لإعادة الإنتاج، مثل package-lock.json يفعل للشيفرة.
  • ~/.agents/.skill-lock.json لمهاراتك العامة. إنه يخص حساب المستخدم لديك (أو يوجد في $XDG_STATE_HOME/skills/.skill-lock.json إذا كنت قد ضبطت هذا المتغير). لا تحرّره يدويًا، ولاحظ أن لكل مستخدم على الحاسوب ملفه الخاص، وهذا ما يهم في الجزء 6.

القياس عن بُعد، باختصار

ترسل واجهة سطر الأوامر بيانات استخدام مجهولة الهوية. وفقًا لتوثيقها، تُضمَّن أسماء مستودعات GitHub والمهارات فقط عندما يؤكد GitHub أن المستودع عام؛ وقد تُذكر أنواع أخرى من المصادر أيضًا. لإيقاف ذلك، أضف export DISABLE_TELEMETRY=1 (أو DO_NOT_TRACK=1) إلى ملف تعريف الصدفة. وهذا يعطّل أيضًا عمليات فحص التدقيق الأمني التي تجريها واجهة سطر الأوامر للمهارات العامة، فقرّر أيّهما تفضّل.

مثبّتات أخرى ستقابلها

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

الأداة مثال من المفيد معرفته
GitHub CLI (gh skill، الإصدار 2.90 أو أحدث، بنسخة معاينة) gh skill install owner/repo skill-name --agent claude-code gh skill preview يعرض المهارة قبل تثبيتها؛ --pin يثبّت إصدارًا محددًا
Hermes Agent hermes skills install <identifier> يتضمن مركزه skills.sh، وكل تثبيت يخضع لفحص أمني
Gemini CLI gemini skills install <git-url> --scope workspace لمشروع واحد؛ يطلب الموافقة ما لم تمرّر --consent
Codex $skill-installer <name> مهارة نظام مدمجة
Claude Code /plugin install name@marketplace تجمع الإضافات المهارات مع خوادم MCP والخطافات (الجزء 9)

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


الجزء 5 — “حُدِّثت حزمة مهاراتي قبل يومين. كيف أعرف أنني أملكها؟”

كان هذا سؤالي بالضبط عندما Superpowers، مكتبة المهارات الشائعة من Jesse Vincent، أعلنت عن تحديث. npx skills ls يسرد الأسماء لا الإصدارات، لذا لا يمكنه إخبارك. وإليك كيف تعرف واجهة سطر الأوامر فعليًا.

كيف يعمل الفحص

عندما تثبّت مهارة، تخزّن واجهة سطر الأوامر بصمة مجلدها في ملف القفل. وعندما تفحص، تسأل المصدر (عادة GitHub) عن بصمة المجلد نفسه اليوم. البصمة نفسها: محدّث. مختلفة: هناك تحديث. لا يقارن أرقام الإصدارات أو التواريخ، ولهذا يعمل حتى مع المهارات التي لا تحتوي على أي منهما.

cd /tmp                        # or a project folder, but never your home folder
npx skills@latest check -g     # your global skills

cd ~/code/my-app
npx skills@latest check -p     # this project's skills

نتيجة نموذجية في الإصدار 1.8.1 تبدو هكذا:

↑ brainstorming has an update
↑ writing-plans has an update
2 skill(s) can be updated; run npx skills update to install

check كما يبلّغ عن مهارات المشروع التي لم تعد ملفاتها مطابقة لملف القفل (لديها تغييرات محلية)، ويخرج برمز خطأ كلما كان أي شيء قديمًا أو معدّلًا، فيمكنك استخدامه لإيقاف بناء CI انحرف عن المسار.

check تغيّر في نوفمبر، لذا شغّل أحدث إصدار

منذ الإصدار 1.7.5 (2 نوفمبر 2026)، check يبلّغ فقط. في الإصدارات الأقدم، من 1.5.18 على الأقل وحتى 1.7.4، check كان مجرد اسم آخر للأمر update: فقد كان يسأل “نطاق التحديث؟” ويثبّت التحديثات أثناء ذلك. إذا كنت قد استخدمت npx skills check قبل نوفمبر وتساءلت لماذا كان “يحدّث” الأشياء، فهذا هو السبب. استخدم npx skills@latest check وستحصل على السلوك للقراءة فقط.

تفصيلان آخران يوقعان الناس في الخطأ:

  • check يختار نطاقًا واحدًا من تلقاء نفسه. إذا كان المجلد الذي أنت فيه يحتوي على skills-lock.json ملف، أو .agents/skills مجلد يحتوي على مهارة، فإنه يفحص مشروعك مهارات المشروع؛ وإلا فإنه يفحص عامة المهارات العامة. أضف -g أو -p لتحديد أيها تقصد.
  • لا يوجد خيار “تحديث كل شيء من مستودع واحد”. إما أن تحدّث كل شيء في نطاق، أو تسمّي المهارات.

ثم حدّث

npx skills update                      # يسأل: المشروع أم العام أم كليهما
npx skills update -g                   # كل المهارات العامة
npx skills update -p                   # كل مهارات المشروع
npx skills update brainstorming writing-plans -g   # هذه فقط
npx skills update -y                   # بلا أسئلة: المشروع إن كنت فيه، وإلا العام

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

إذا ثبّتته كإضافة، فحدّثه كإضافة

كثير من حزم المهارات تُوزّع الآن كإضافات، وSuperpowers مثال جيد. يسرد ملف README الخاص به مسار تثبيت مختلفًا لكل وكيل تقريبًا:

الوكيل تثبيت Superpowers حسب ملف README كيف يتحدّث
Claude Code /plugin install superpowers@claude-plugins-official تلقائيًا، من سوق Anthropic الرسمي
Codex CLI /plugins، ابحث عن “superpowers”، ثم تثبيت الإضافة عبر مدير الإضافات
Cursor /add-plugin superpowers في محادثة الوكيل عبر مدير الإضافات
Gemini CLI gemini extensions install https://github.com/obra/superpowers gemini extensions update superpowers
GitHub Copilot CLI copilot plugin marketplace add obra/superpowers-marketplace، ثم copilot plugin install superpowers@superpowers-marketplace عبر مدير الإضافات
Hermes Agent hermes plugins install obra/superpowers --enable عبر مدير الإضافات
OpenCode أضف "superpowers@git+https://github.com/obra/superpowers.git" إلى قائمة الإضافات في opencode.json، كما يوضح دليل التثبيت الخاص به في OpenCode عند إعادة التشغيل؛ امسح ذاكرة الحزم المؤقتة في OpenCode إذا لم تظهر نسخة جديدة، أو أضف #v5.0.3من هذا النمط لتثبيت الإصدار

من ملف README الخاص بـ Superpowers ودليل التثبيت الخاص به في OpenCode، تم التحقق في 15 نوفمبر 2026.

ثبّتت Superpowers على جهاز Mac باستخدام npx skills -g، لذا تتحدّث نسختي عبر skills CLI. هذا لا مشكلة فيه. المشكلة هي تثبيت الحزمة نفسها عبر قناتين: ينتهي بك الأمر إلى نسختين من كل مهارة بالأسماء نفسها، ودون أي طريقة لمعرفة أيّهما سيختار الوكيل.

كيف يعمل npx skills check: يخزّن ملف القفل بصمة لكل مجلد مهارة، ويقارنها check بالمجلد نفسه في المصدر الأصلي ويبلّغ عن التحديثات، ويقوم update بتثبيتها
check يقارن البصمات، لا أرقام الإصدارات. منذ 1.7.5 صار يكتفي بالعرض؛ update هو الأمر الذي يغيّر شيئًا فعليًا.

الجزء 6 — خمس مشكلات حقيقية من Mac وRaspberry Pi، وكيف تحلّها

كل ما في هذا الجزء حدث لي في صيف 2026، على الإصدار 1.5 من CLI. وقد جرى التحقق من كل مشكلة منذ ذلك الحين مقابل الشيفرة المصدرية للإصدار الحالي 1.8.1، لتعرف أيّها أُصلح وأيّها ما زال يلدغ. مخرجات الطرفية حقيقية؛ اختصرتها وأزلت أسماء الأجهزة.

المشكلة 1: “كل المهارات العامة محدّثة”، بينما لم يُفحص شيء

على جهاز Mac، npx skills check أنتج هذا:

graham@mac my-app % npx skills check
◇  Update scope
│  Both
Checking for skill updates…
Global Skills
Checking skills from source: anthropics/skills
│  GitHub API request limit reached; checking existing gh authentication…
  ✗ Failed to fetch tree for anthropics/skills
Checking skills from source: vercel-labs/skills
  ✗ Failed to fetch tree for vercel-labs/skills
…                                  (six more sources, every one ✗)
Checking skills from source: obra/superpowers
  ✗ Failed to fetch tree for obra/superpowers
✓ All global skills are up to date

ما الذي حدث. لفحص مستودع، يطلب CLI من API الخاص بـ GitHub قائمة ملفات المستودع. ويسمح GitHub بـ 60 طلبًا مجهولًا في الساعة لكل عنوان إنترنت، وقد كان حصادي لتلك الساعة مستنفدًا بالفعل (الأداة تقول ذلك في السطر الأول)، لذا فشل كل بحث. السطر الأخير يحسب فقط التحديثات التي وجدتها، ولم تجد شيئًا، فطبعت علامة صح خضراء. الإصدار القديم كان يحاول أيضًا استعارة تسجيل دخول GitHub CLI في الخلفية (هذا هو سطر “checking existing gh authentication”)؛ وبما أن كل طلب ظل فاشلًا، فلا بد أنه لم يكن هناك تسجيل دخول ليُستعار.

هل أُصلح؟ جزئيًا. الإصدار 1.8.1 يحاول أكثر قبل أن يستسلم: مجهولًا أولًا، ثم رمزًا من بيئتك، ثم تسجيل دخول GitHub CLI نفسه عبر gh api، وللفحوصات التحديث تنزيل Git عادي كملاذ أخير. لكن شيفرة 1.8.1 المصدرية تُظهر أنه حين يظل مصدر ما غير قابل للفحص، فإن سطر الملخص لا يزال يحسب التحديثات التي وجدها فقط. لا يزال من الممكن أن تظهر علامة صح خضراء تحت علامات خطأ حمراء، لذا اقرأ أسطر ✗.

الحل. امنح CLI تسجيل دخول، فيرتفع الحد إلى 5,000 طلب في الساعة:

  1. الأسهل: ثبّت GitHub CLI وشغّل gh auth login. الإصدارات الحالية من skills CLI تطلب gh لإجراء استدعاء API ولا ترى بيانات اعتمادك أبدًا.
  2. أو استخدم رمزًا: أنشئ رمز وصول شخصي محدد الصلاحيات بصلاحية قراءة فقط على المستودعات العامة، ثم أضفه إلى ملف إعدادات الصدفة (~/.zshrc على جهاز Mac، ~/.bashrc على جهاز Raspberry Pi):

bash export GITHUB_TOKEN="github_pat_…" # read-only, public repositories

افتح طرفية جديدة بعد ذلك. تعامل مع الرمز ككلمة مرور: لا تلصقه أبدًا في محادثة أو مهارة أو ملف تقوم بعمل commit له. 3. الترقية وإعادة الفحص: npx skills@latest check -g.

المشكلة 2: sudo منحتني مخزنين للمهارات وخطأ npm

على جهاز Raspberry Pi كنت’ قد اعتدت على كتابة sudo su أولًا. وهذا ما أنتجه:

graham@pi:~ $ sudo su
root@pi:/home/graham# npx skills update
npm error config prefix cannot be changed from project config: /home/graham/.npmrc.
◇  Update scope
│  Both
Checking for skill updates…
Global Skills
…
Found 6 global update(s)
…
Project Skills
Updating for: Universal, Claude Code, Hermes Agent
Refreshing 7 skill(s)…

وبعد لحظة، عدت كمستخدمي العادي:

graham@pi:~ $ ls ~/.agents/skills | wc -l
7
graham@pi:~ $ sudo ls /root/.agents/skills | wc -l
37

ما الذي حدث. sudo su يحوّلك إلى root، ولـ root مجلد home خاص به، /root. تُخزَّن المهارات لكل مستخدم، لذا فإن مهارات root’ العامة تعيش في /root/.agents/skills ومهاراتي في /home/graham/.agents/skills. كل تثبيت عام قمت’ به يومًا كـ root ذهب إلى مخزن root’: 37 مهارة هناك، و7 في مخزني. وإذا كانت وكلاؤك تعمل بحساب مستخدمك العادي، وهو الإعداد المعتاد، فكل ما في مخزن root’ غير مرئي لها.

خطأ npm له السبب نفسه. بصفة root، يكون ملف إعدادات npm’ الشخصي هو /root/.npmrc، لذا فإن /home/graham/.npmrc الموجود في المجلد الذي كنت فيه يُقرأ بصفته مشروعك ملف إعدادات بدلًا من ذلك. يرفض كود npm’ نفسه أن يسمح لملف مشروع بتغيير prefix ذلك الإعداد، ويسجّل هذا الخطأ تحديدًا. وهناك’ خطر ثالث لن’ تراه فورًا: أي شيء يكتبه root داخل مجلد home الخاص بك يصبح مملوكًا لـ root، ولا يستطيع’ مستخدمك العادي تحديثه لاحقًا.

الحل.

  1. اخرج من root: type exit. من الآن فصاعدًا، شغّل CLI ووكلاءك بحسابك أنت.
  2. اعرف أي مستخدم تستخدمه وكلاؤك. أي مجلد home يحتوي على إعداداتها هو المجلد المهم:

bash ls -d ~/.claude ~/.config/opencode ~/.hermes 2>/dev/null sudo ls -d /root/.claude /root/.config/opencode /root/.hermes 2>/dev/null

  1. أعد تثبيت مهارات root بحسابك أنت، من مصادرها الأصلية. نسخ الملفات سينقل معه ملكية root’ وسجلات قديمة. إعادة التثبيت تكتب ملف قفل نظيفًا. أولًا، اسرد المصادر التي استخدمها root:

bash sudo grep '"source"' /root/.agents/.skill-lock.json | sort -u

ثم، من مجلد مشروع أو /tmp، شغّل npx skills add <owner/repo> -g -a <your agents> لكل واحد ما زلت تريده. 4. أعد مجلداتك إلى ملكيتك، في حال كتب root فيها:

bash sudo chown -R "$(id -un)":"$(id -gn)" ~/.agents ~/.claude ~/.hermes ~/.config/opencode 2>/dev/null

  1. فقط عندما يعمل كل شيء وأنت المستخدم، احذف نسخة root’s بأمر sudo rm -rf /root/.agents.

إذا كنت تستخدم sudo لأن عمليات تثبيت npm العامة تفشل بدونه، فأصلح ذلك بدلًا من ذلك: وجّه بادئة npm’s إلى مجلد تملكه (npm config set prefix ~/.npm-global، ثم أضف ~/.npm-global/bin إلى PATH). هذا’ على الأرجح ما كان يفعله prefix السطر في .npmrc الخاص بي.

المشكلة 3: شغّله من مجلدك الرئيسي فيصبح “مشروعًا”

بالعودة إلى حسابي، في مجلدي الرئيسي:

graham@pi:~ $ npx skills check
Need to install the following packages:
[email protected]
Ok to proceed? (y) y
…
Global Skills
No global skills tracked in lock file.
Install skills with npx skills add <package> -g
Project Skills
Updating for: Universal, Claude Code, Hermes Agent
Refreshing 7 skill(s)…

ما الذي حدث. تعتبر أداة CLI أن المجلد مشروع إذا احتوى على skills-lock.json ملف أو .agents/skills مجلد يحتوي على مهارة. مجلدك الرئيسي يحتوي على ~/.agents/skills، لأن المهارات العامة تعيش هناك’، لذا من ~ ترى أداة CLI مشروعًا. وإذا شغّلت يومًا npx skills add في مجلدك الرئيسي دون -g، فقد أنشأت هناك تثبيتًا حقيقيًا لمشروع، بملف ~/skills-lock.json، ومجلد مهاراته هو المجلد نفسه الذي يستخدمه التثبيت العام. هذا’ ما حدث على جهاز Pi: سبع مهارات مسجّلة كـ“مشروع” في مجلدي الرئيسي، ولا شيء إطلاقًا في ملف القفل العام الخاص بي.

لرسالة “لا توجد مهارات عامة مسجّلة في ملف القفل” ثلاثة أسباب شائعة: أنك لم تثبّت قط باستخدام -g، أو أنك ثبّت باستخدام -g بمستخدم مختلف (root، عبر sudo)، أو أن ملف القفل حُذف. وإذا قرأت في مكان آخر’ أن أمر generate-lock يعيد بناءه، فهو غير موجود: لا يوجد’ أمر بهذا الاسم’ في الإصدار 1.5 أو 1.8.

الحل.

  • شغّل أداة CLI من مجلد مشروع أو /tmp, ولا تشغّلها أبدًا من ~، ومرّر’ -g أو -p حتى لا يكون عليها’ أن تخمّن.
  • لفكّ تشابك “مشروع” في المجلد الرئيسي، أعد تثبيت المهارات التي تريدها باستخدام -g من مجلد آخر (فهي تصل إلى المكان نفسه، ومسجّلة الآن في ملف القفل العام)، ثم احذف ~/skills-lock.json. لا تشغّل’ npx skills remove من ~ لهذا الغرض: في مجلدك الرئيسي، مجلد المشروع والمجلد العام هما المجلد نفسه.

المشكلة 4: “لم يتم العثور على مهارات مطابقة” بسبب النقطتين الرأسيتين

graham@pi:~ $ npx skills remove ckm:banner-design ckm:brand ckm:design \
  ckm:design-system ckm:slides ckm:ui-styling
◇  Found 7 unique installed skill(s)
■  No matching skills found for: ckm:banner-design, ckm:brand, ckm:design, ckm:design-system, ckm:slides, ckm:ui-styling

ما الذي حدث. تلك المهارات تظهر باسم ckm:banner-design، لكن علامة النقطتين الرأسيتين حرف محفوف بالمخاطر في اسم مجلد، لذا حفظتها CLI باسم ckm-banner-design: فهي تحوّل الاسم إلى أحرف صغيرة، وتحوّل كل ما ليس حرفًا أو رقمًا أو نقطة أو شرطة سفلية إلى شرطة. الإصدار 1.5.18 كان يقارن ما كتبته بأسماء المجلدات حرفيًا، فلم يتطابق شيء.

هل أُصلح؟ نعم. الإصدارات الحالية تحوّل مدخلاتك بالطريقة نفسها قبل المقارنة، لذا ckm:brand و ckm-brand كلاهما يعمل، وعندما لا يتطابق أي شيء، يطبع 1.8.1 الأسماء التي تُجمَع تم تثبيتها.

الحل. التشغيل npx skills ls (أو ls ~/.agents/skills) لترى الأسماء الحقيقية، أو شغّل npx skills remove بدون وسائط واختر من القائمة. تحقّق من النطاق أيضًا: من داخل مجلد مشروع، إزالة مهارة مسجّلة’ في قفلك العام تخبرك الآن بأن تضيف -g.

المشكلة 5: ست مهارات تفشل، وواحدة من المستودع نفسه تعمل

Refreshing 7 skill(s)…
✗ Failed to check for deleted skills from nextlevelbuilder/ui-ux-pro-max-skill
Updating ckm:banner-design…
  ✗ Failed to update ckm:banner-design
…                                  (five more ✗)
Updating ui-ux-pro-max…
  ✓ Updated ui-ux-pro-max

ما الذي حدث. لتحديث مهارة، يبحث CLI عنها في مستودعها المصدر مرة أخرى. ست من مهاراتي السبع من ذلك المستودع لم يُعثر’ عليها، بينما السابعة حُدّثت بلا مشكلة. عندما تفشل معظم المهارات من مصدر واحد وتنجح واحدة، تكون المفقودة عادةً قد أُعيدت تسميتها أو نُقلت أو حُذفت من المنبع. ملف README لذلك المستودع’ يصف اليوم مهارة واحدة، ui-ux-pro-max، ويذكر اللافتات وهوية العلامة والشرائح فقط كميزات في طبقة مدفوعة، وهو ما يتفق مع مغادرة الست للمستودع المجاني.

الحل. انظر ماذا يقدّم المصدر الآن، ثم أزل ما’ اختفى:

npx skills add nextlevelbuilder/ui-ux-pro-max-skill --list
npx skills remove ckm-banner-design ckm-brand ckm-design ckm-design-system ckm-slides ckm-ui-styling

الإصدارات الحالية من CLI تلاحظ المهارات المحذوفة من المنبع وتعرض تنظيفها أثناء التحديث، وتزيل المهارات المفقودة من ملف القفل عند إلغاء التثبيت. وبينما أنت’ هناك، ابحث عن التكرارات: إن كانت لديك أيضًا مهارة brand عادية بجوار ckm-brand، فاحتفظ بواحدة. مهارتان بأوصاف شبه متطابقة تُربك اختيار الوكيل’ وتهدر ميزانية قائمته.

إضافة: Claude Code’ لا يرى مهارة ثبّتها CLI

  • تحقّق من الرابط. Claude Code يقرأ مجلداته الخاصة فقط، لذا ls -la ~/.claude/skills (أو .claude/skills في المشروع) يجب أن يُظهر المهارة، عادةً كرابط إلى .agents/skills. عدة إصدارات من 1.5 أصلحت أخطاءً حول روابط’ Claude Code (1.5.16 و1.5.20)، لذا إن كانت مفقودة’، أعد التثبيت بـ npx skills@latest add … -a claude-code.
  • تحقّق من أن الملف يبدأ بشكل صحيح. علامة الفتح --- للبيانات الأمامية يجب أن تكون أول سطر تمامًا من SKILL.md، وإلا يعامل Claude Code الملف كله كنص عادي.
  • أعد التحميل. Claude Code يلتقط المهارات المعدّلة فورًا، لكن مجلد مهارات أُنشئ بعد بداية الجلسة يحتاج /reload-skills. ثم /skills يسرد ما تم تحميله.
استكشاف أخطاء npx skills: خمسة أخطاء حقيقية وإصلاحاتها، من رسالة «كل شيء محدَّث» الخاطئة بعد تجاوز حد معدل GitHub إلى sudo ينشئ مخزن مهارات ثانيًا، ومجلد المنزل يُعامَل كمشروع، ومهارات حُذفت من المصدر الأصلي
خمسة أخطاء، وخمس إصلاحات. معظمها يعود إلى القاعدتين نفسيهما: اقرأ أسطر ✗، ولا تشغّل CLI أبدًا بصلاحيات root أو من مجلدك الرئيسي.

الجزء 7 — خوادم MCP بلا مصطلحات معقّدة

ما الذي يحدث عند توصيل خادم

  1. تضيف الخادم إلى إعدادات الوكيل لديك: أمر لخادم محلي، أو عنوان ويب لخادم بعيد.
  2. عند بدء الجلسة، يشغّل الوكيل الخادم المحلي أو يتصل بالخادم البعيد، ويسجّل الدخول إذا كان الخادم يتطلب ذلك.
  3. يسرد الخادم أدواته، ويمرّر الوكيل أوصافها إلى النموذج.
  4. عندما تحتاج مهمة ما إلى أداة، يطلبها النموذج، فيتحقق وكيلك من قواعد الأذونات لديك (وقد يسألك)، وينفّذ الخادم العمل، وتعود النتيجة إلى المحادثة.

محلي أم بعيد؟

خادم محلي (stdio) خادم بعيد (Streamable HTTP)
يعمل على حاسوبك، ويشغّله الوكيل على حواسيب المزوّد
تضيف أمرًا، مثل npx @playwright/mcp@latest عنوانًا، مثل https://mcp.context7.com/mcp
تسجيل الدخول عادةً مفتاح API في متغيّر بيئة عادةً OAuth في متصفحك، أو مفتاح في ترويسة
يحتاج Node.js أو Python أو Docker، بحسب الخادم اتصالًا بالإنترنت
الأفضل لـ أشياء على جهازك: متصفح، وملفات، وقاعدة بيانات محلية خدمات سحابية: GitHub وSentry والتوثيق وأدوات المشروع
ما يجب الحذر منه يعمل بكامل أذونات مستخدمك تذهب بياناتك إلى ذلك المزوّد

قد ترى في الأدلة الأقدم نوعًا ثالثًا هو SSE. توثيق Claude Code يعدّه مهجورًا؛ استخدم عنوان HTTP عندما يقدّم الخادم كليهما.

كلمة عن الإصدارات

مواصفة MCP الحالية، الصادرة في 28 يوليو 2026، هي أكبر مراجعة منذ إطلاق البروتوكول: جوهرها الآن بلا حالة، ما يتيح تشغيل الخوادم البعيدة خلف موازنات تحميل عادية. نادرًا ما تحتاج إلى الاهتمام بذلك، لأن العملاء والخوادم يتفقون على المراجعة التي يتخاطبون بها وتواصل الخوادم الأقدم العمل. OpenCode هو الموضع الوحيد الذي قد ترى فيه ذلك: لكل خادم protocol إعداد (legacy افتراضيًا، auto، أو 2026-07-28)، وتجميع الاتصالات لا يعمل إلا مع أحدث مراجعة.

فاتورة السياق، وكيف تُبقيها صغيرة

كل أداة يقدّمها خادم ما تأتي مع وصف مكتوب للنموذج. وبكلمات OpenCode’s نفسها، “أدوات MCP تستهلك سياق النموذج، لذا أضف الخوادم التي تحتاجها فقط.” هناك وكيلان الآن يخفّفان التكلفة افتراضيًا:

  • يستخدم Claude Code البحث عن الأدوات. في بداية الجلسة لا يحمّل سوى أسماء الأدوات وتعليمات كل خادم، ثم يجلب التعريف الكامل للأداة عندما يبحث Claude عنها فعليًا.
  • يستخدم OpenCode نمط Code Mode، وهو يجمّع أدوات كل خادم خلف مدخل واحد بدلًا من سرد كل أداة على حدة. وهو مفعّل ما لم تضبط "codemode": false لخادم معيّن.

وفي كل مكان آخر، وفوق تلك الإعدادات الافتراضية، هذه هي أدوات التحكم المتاحة لك:

الوكيل إيقاف خادم إخفاء الأدوات التي لا تريدها
OpenCode "disabled": true، أو /mcps لجلسة واحدة A deny قاعدة على <server>_<tool> في الأذونات
Claude Code claude mcp remove <name> (/mcp يعرض الحالة) A deny قاعدة صلاحية على mcp__<server>__<tool>; ENABLE_TOOL_SEARCH يحدّد مقدار ما يُحمّل مسبقًا
Codex enabled = false enabled_tools و disabled_tools
Gemini CLI gemini mcp disable <name> (أضف --session لجلسة واحدة) includeTools و excludeTools
Cursor مفتاح تشغيل الخادم ضمن Customize (يمكن للمشرفين ضبط قوائم سماح للأدوات)
Hermes Agent enabled: false tools.include و tools.exclude

قاعدتي: خادمان إلى خمسة خوادم تستخدمها كل أسبوع أفضل من عشرين قد تستخدمها يومًا ما. أزل الباقي؛ يمكنك إضافة ما أزلته في دقيقة واحدة.

أربعة خوادم تستحق التجربة أولًا

الخادم ما الذي يمنحه لوكيلك النوع العنوان أو الأمر تسجيل الدخول
Context7 توثيق محدّث خاص بكل إصدار للمكتبات وأطر العمل الشائعة عن بُعد https://mcp.context7.com/mcp لا حاجة لأي شيء؛ مفتاح API مجاني يرفع الحدود
GitHub (رسمية) المشكلات وطلبات السحب والبحث في الشيفرة وActions عن بُعد https://api.githubcopilot.com/mcp/ OAuth حيث يدعمه وكيلك، أو رمز وصول شخصي
Playwright متصفح حقيقي يستطيع الوكيل فتحه والنقر فيه والتقاط لقطات شاشة منه محلي npx @playwright/mcp@latest لا شيء
Sentry أخطاءك وأعطالك الفعلية عن بُعد https://mcp.sentry.dev/mcp OAuth

أين تجد المزيد:

  • السجل الرسمي MCP Registry، الذي يديره مساهمو البروتوكول’، يسرد الخوادم المنشورة.
  • توثيق أدواتك’ نفسه. معظم الخدمات تنشر الآن خادمًا رسميًا؛ ابحث في توثيقها عن “MCP”.
  • فهرس وكيلك’. لدى Hermes Agent hermes mcp catalog، وكثير من إضافات Claude Code تجلب خوادمها الخاصة.

فضّل الخوادم التي تنشرها الشركة التي تدير الخدمة. خادم عشوائي اسمه “github-mcp-pro” يستحق الريبة نفسها التي تستحقها إضافة متصفح عشوائية.

الخيار الأخف: أداة سطر أوامر مع مهارة

قبل أن تضيف خادمًا، تحقق مما إذا كانت أداة سطر أوامر تؤدي المهمة. Context7 نفسه يقدم الطريقين: خادم MCP أعلاه، أو أداة CLI صغيرة مع مهارة (npx ctx7 setup --opencode، التي تحتاج Node.js 22.13 أو أحدث). أداة GitHub’ الخاصة gh مع مهارة قصيرة تغطي معظم ما يفعله خادمه.

الخادم منطقي عندما لا يستطيع وكيلك تشغيل الأوامر (تطبيق دردشة سطح مكتب، مثلًا)، أو لا تملك الخدمة أداة CLI جيدة، أو كانت المهمة تفاعلية مثل قيادة متصفح. أداة CLI مع مهارة منطقية عندما تكون الأداة موجودة بالفعل: لا تكلف شيئًا حتى تُستخدم، ويمكن تقليم مخرجاتها قبل أن تصل إلى النموذج. مقالي دليل OpenCode الخاص بي يقدم الحجة نفسها لتطوير التطبيقات.


الجزء 8 — أضف خادم MCP في ستة وكلاء: وصفات جاهزة للنسخ واللصق

كل وصفة تضيف الخادمين نفسيهما: Context7 (عن بُعد) و Playwright (محلي). استبدل أي خادم آخر بالطريقة نفسها. وحين يملك الوكيل أمرًا وملف إعدادات معًا، يكتب الأمر الملف لك ببساطة.

OpenCode

opencode mcp add context7 --url https://mcp.context7.com/mcp
opencode mcp add playwright -- npx @playwright/mcp@latest
opencode mcp list

أضف --global لجعل خادم متاحًا في كل مشروع. في opencode.jsonc يبدو الإعداد نفسه هكذا:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "context7": {
        "type": "remote",
        "url": "https://mcp.context7.com/mcp",
        "oauth": false
        // With a free API key, add:
        // "headers": { "Authorization": "Bearer {env:CONTEXT7_API_KEY}" }
      },
      "playwright": {
        "type": "local",
        "command": ["npx", "@playwright/mcp@latest"]
      }
    }
  }
}
  • تُدرج الأسرار كـ {env:NAME}؛ OpenCode لا يوسّع متغيّرًا عاديًا $NAME.
  • الخوادم البعيدة تجرب OAuth تلقائيًا؛ oauth: false مخصّصة للخوادم التي تستخدم مفتاحًا أو لا تستخدم شيئًا. سجّل الدخول باستخدام opencode mcp auth <name>، وعبر SSH، الصق عنوان URL الخاص بالاستدعاء العكسي من صفحة المتصفح التي فشلت في موجّه الأوامر.
  • داخل الجلسة، /mcps يتصل بالخوادم أو يقطع الاتصال بها أو يسجّل الدخول إليها.
  • تتحول كل أداة إلى إجراء إذن باسم <server>_<tool>، لذا { "action": "playwright_*", "resource": "*", "effect": "ask" } يجعل كل إجراء في المتصفح يطلب الإذن أولًا.

Claude Code

claude mcp add --transport http context7 https://mcp.context7.com/mcp
claude mcp add playwright -- npx @playwright/mcp@latest
claude mcp list

الـ -- يفصل خيارات Claude Code’s عن أمر الخادم’s الخاص. الخوادم افتراضيًا في النطاق المحلي (أنت، في هذا المشروع). أضف --scope user لكل مشاريعك، أو --scope project لكتابة .mcp.json ملف يمكنك إيداعه لفريقك:

{
  "mcpServers": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp"
    },
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest"]
    }
  }
}
  • .mcp.json يوسّع ${VAR} و ${VAR:-default}، لذا تبقى المفاتيح في بيئتك، لا في Git.
  • /mcp داخل الجلسة يعرض حالة كل خادم’ ويتولى تسجيل الدخول عبر OAuth.
  • يسأل Claude Code قبل استخدام خوادم من مشروع’ .mcp.json، حتى لا يستطيع مستودع مستنسخ’ إضافة خوادمه بصمت.

Codex

يحتفظ Codex بالخوادم في ~/.codex/config.toml، أو في .codex/config.toml داخل مشروع قمت’ بوسمه كموثوق:

[mcp_servers.context7]
url = "https://mcp.context7.com/mcp"

[mcp_servers.playwright]
command = "npx"
args = ["@playwright/mcp@latest"]
  • يمكن أيضًا إضافة الخوادم البعيدة باستخدام codex mcp add context7 --url https://mcp.context7.com/mcp، و codex mcp login <name> يشغّل تسجيل الدخول عبر OAuth.
  • أما بالنسبة للمفتاح، bearer_token_env_var = "CONTEXT7_API_KEY" يقرأه من بيئتك.
  • اضبط الخادم باستخدام enabled_tools و disabled_tools; startup_timeout_sec (10 ثوانٍ افتراضيًا) يساعد الخوادم البطيئة على البدء.

Gemini CLI

gemini mcp add -t http context7 https://mcp.context7.com/mcp
gemini mcp add playwright npx @playwright/mcp@latest
gemini mcp list

gemini mcp add يكتب في إعدادات المشروع’ افتراضيًا؛ أضف -s user لكل مشروع. في settings.json:

{
  "mcpServers": {
    "context7": { "httpUrl": "https://mcp.context7.com/mcp" },
    "playwright": { "command": "npx", "args": ["@playwright/mcp@latest"] }
  }
}
  • httpUrl مخصص لـ Streamable HTTP؛ url يعني نوع SSE الأقدم.
  • اترك trust معطّلًا. عند ضبطه على true، فإنه يتخطى كل تأكيد لذلك الخادم.
  • يُزيل Gemini CLI المتغيرات التي تبدو كأسرار (أسماء تحتوي على TOKEN أو SECRET أو PASSWORD أو KEY) من بيئة الخادم’ ما لم تُدرجها في env الكتلة.
  • يحتاج OAuth إلى متصفح على الجهاز نفسه. في مجلد غير موثوق، تبقى الخوادم المحلية غير متصلة حتى تُشغّل gemini trust.

Cursor

يقرأ Cursor .cursor/mcp.json في مشروع و ~/.cursor/mcp.json لكل شيء:

{
  "mcpServers": {
    "context7": { "url": "https://mcp.context7.com/mcp" },
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "args": ["@playwright/mcp@latest"]
    }
  }
}
  • تحتاج الخوادم المحلية إلى "type": "stdio".
  • تُدرج الأسرار كـ ${env:NAME}.
  • شغّل الخوادم وأوقفها باستخدام مفاتيح التبديل الخاصة بها ضمن تخصيص.

Hermes Agent

يقرأ Hermes mcp_servers في ~/.hermes/config.yaml:

mcp_servers:
  context7:
    url: "https://mcp.context7.com/mcp"
  playwright:
    command: "npx"
    args: ["@playwright/mcp@latest"]
  • التشغيل /reload-mcp بعد التعديل، و hermes mcp test context7 لترى بالضبط ما أجاب به الخادم.
  • لخدمات OAuth، أضف auth: oauth إلى إدخال HTTP. على جهاز بلا واجهة رسومية، يوفّر Hermes اللصق العكسي أو تمرير منافذ SSH أو تدفق تسجيل الدخول عبر الجهاز.
  • يمرر Hermes إلى الخوادم المحلية فقط المتغيرات التي تُدرجها في env إضافةً إلى حد أدنى آمن، وليس بيئة الصدفة كاملة.
  • تظهر الأدوات بالصيغة mcp_<server>_<tool>؛ صفِّها باستخدام tools.include أو tools.exclude.

تحقق من أنه يعمل، في أي وكيل

اطرح سؤالًا لا يجيب عنه إلا الخادم: “استخدم Context7 للبحث عن كيفية تعريف مسار في الإصدار الحالي من Next.js، وأخبرني أي أداة استدعيت.” ثم اطلب شيئًا مرئيًا: “افتح example.com باستخدام Playwright وصِف الصفحة.” إذا قال الوكيل إنه لا يملك مثل هذه الأدوات، فاعرض قائمة الخوادم (opencode mcp list, claude mcp list, gemini mcp list, hermes mcp test) وابحث عن اتصال فاشل أو تسجيل دخول لم يكتمل.

كيف تضيف خادم MCP في OpenCode وClaude Code وCodex وGemini CLI وCursor وHermes Agent: الخادم Context7 نفسه بصيغة الأمر أو الإعدادات الخاصة بكل وكيل، مع أمر لخادم محلي
خادم واحد، ست لهجات. الأفكار متطابقة؛ لا يتغير سوى أسماء الملفات والأقواس.

الجزء 9 — الإضافات: المهارات وخوادم MCP في صندوق واحد

تثبيت عشر مهارات وثلاثة خوادم واحدة تلو الأخرى يصبح مملًا. الإضافات تجمعها، ومعظم الوكلاء لديها الآن نظام إضافات من نوع ما.

إضافات Claude Code

يمكن أن تحتوي إضافة Claude Code على مهارات ووكلاء فرعيين وخطافات وخوادم MCP وخوادم لغات. تأتي الإضافات من الأسواق، وهي مجرد فهارس مستضافة في مستودع Git:

/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills

في جلسة، /plugin install يفتح أولًا تفاصيل الإضافة’ حتى ترى بالضبط ما تضيفه قبل أن تختار النطاق: أنت (كل المشاريع)، أو هذا المستودع للجميع، أو هذا المستودع لك وحدك. من الطرفية، claude plugin install <name>@<marketplace> يفعل الشيء نفسه دون جلسة.

ثلاث ميزات تستحق المعرفة:

  • تكلفة السياق مرئية. بالنسبة إلى الإضافات في سوق Anthropic’ الرسمي، يقدّر جزء التفاصيل ما تضيفه الإضافة إلى كل رسالة وما تضيفه عند الاستخدام. claude plugin details <name> يعرض الرقم لكل جلسة لأي شيء مثبَّت.
  • التحديثات. يحدّث سوق Anthropic’ الرسمي الإضافات تلقائيًا؛ أما أسواق الطرف الثالث فلا تفعل، إلا إذا فعّلتها. claude plugin update <name>@<marketplace> يحدّث إضافة واحدة يدويًا.
  • تُعلَّم الإضافات غير المستخدمة. يجمع تبويب «المثبَّتة» الإضافات التي لم تستخدمها’ مؤخرًا، ما يسهّل التنظيف الشامل.

الإضافات في أماكن أخرى

  • Codex يوزّع المهارات القابلة لإعادة الاستخدام عبر الإضافات (/plugins في CLI)، ويمكن أن تحمل الإضافة أيضًا اتصالات خوادم MCP.
  • Gemini CLI يسميها «إضافات»: gemini extensions install <git-url> و gemini extensions update <name>.
  • GitHub Copilot CLI (copilot plugin install) و Hermes Agent (hermes plugins install) لديها أوامر إضافات، و Cursor لديها /add-plugin في دردشة Agent.
  • OpenCode الإضافات هي حزم JavaScript أو TypeScript مدرجة في قائمة الإضافات إعداد في تهيئته، ويمكنها تسجيل المهارات والأدوات. تُثبَّت Superpowers بهذه الطريقة.

القاعدتان اللتان تُبقِيان إعداد الإضافات سليمًا

  1. قناة واحدة لكل حزمة. إذا كانت حزمة مهارات موجودة كإضافة وك مهارات عادية، فاختر واحدة منهما. وجود نسختين يعني أسماء مكررة ووكيلًا يختار أيّهما يرى أولًا.
  2. حدِّث من حيث ثبّت. لا يعرف skills CLI شيئًا عن الإضافات، ولا يعرف مديرو الإضافات شيئًا عن ~/.agents/skills.

الجزء 10 — اكتب مهارتك الأولى في عشر دقائق

أفضل مهارة أولى هي التي تحل مهمة تكررها. إليك واحدة مبنية من الجزء 6: مهارة تتيح لأي وكيل التحقق من تحديثات مهاراتك بأمان، دون استخدام sudo أو الوثوق بعلامة صحّ خضراء دون تفكير.

الخطوة 1 — أنشئ المجلد

mkdir -p ~/skills-drafts && cd ~/skills-drafts
npx skills init skills-housekeeping

يُنشئ ذلك skills-housekeeping/SKILL.md من قالب. استبدل محتواه بهذا:

---
name: skills-housekeeping
description: Checks installed agent skills for updates and problems with the npx skills CLI, and explains the results in plain English. Use when asked whether skills are up to date, to update skills, or when an installed skill seems to be missing.
metadata:
  author: graham-miranda
  version: "1.0"
---

# تدبير المهارات

## القواعد
- لا تشغّل أي أمر باستخدام sudo أبدًا.
- لا تشغّل `npx skills update` أو `npx skills remove` دون السؤال أولًا.
- شغّل الأوامر من /tmp أو من مجلد مشروع، وليس من مجلد المنزل أبدًا.

## التحقق
1. شغّل `cd /tmp && npx skills@latest check -g` للمهارات العامة.
2. إذا كان المشروع الحالي يحتوي على ملف skills-lock.json، فشغّل أيضًا `npx skills@latest check -p` في مجلد المشروع.
3. اعتبر كل سطر يبدأ بـ ✗ «لم يُفحص»، حتى لو قال سطر لاحق إن كل شيء محدَّث.

## التقرير
- اسرد المهارات التي لها تحديثات، والمهارات التي فيها تغييرات محلية، وأي شيء تعذّر فحصه.
- إذا فشل أي فحص، اقترح `gh auth login` أو GITHUB_TOKEN بصلاحية قراءة فقط للمستودعات العامة.
- اسأل قبل التحديث. ثم شغّل `npx skills update -g` (أو `-p`) وأبلغ بما تغيّر.

الخطوة 2 — افحصها وفق المعيار

  • الاسم: skills-housekeeping يستخدم أحرفًا لاتينية صغيرة وشرطات فقط، وهو أقل من 64 حرفًا، ويطابق اسم المجلد. الثلاثة كلها مطلوبة.
  • الوصف: يقول ما ما تفعله المهارة و وقت متى تستخدمها، ويحتوي على الكلمات التي يكتبها الناس فعليًا (“محدَّثة”، “تحديث المهارات”، “مفقودة”). الوصف هو الجزء الوحيد الذي يراه الوكيل قبل أن يقرر، لذا هو الذي يقوم بمعظم العمل. يسمح المعيار بـ 1,024 حرفًا كحد أقصى؛ استهدف جملة أو جملتين.
  • الطول: أقل بكثير من الحد الموصى به وهو 500 سطر. عندما تكبر المهارة، انقل التفاصيل إلى references/ وأشِر إليها من التعليمات.

ينشر مشروع Agent Skills أداة تحقق مرجعية، skills-ref، تتحقق من الترويسة وقواعد التسمية: skills-ref validate ./skills-housekeeping.

الخطوة 3 — ثبّتها لكل الوكلاء دفعة واحدة

يثبّت skills CLI من مجلد محلي أيضًا:

npx skills add ./skills-housekeeping -g -a opencode -a claude-code -a codex

هذا يضع النسخة الحقيقية في ~/.agents/skills/skills-housekeeping (يقرأها OpenCode و Codex مباشرة) ويضيف رابطًا في ~/.claude/skills لـ Claude Code.

الخطوة 4 — اختبره

اسأل بعبارات بسيطة: “هل مهاراتي محدَّثة؟” المهارة الموصوفة وصفًا جيدًا تُلتقط تلقائيًا. وإن لم يحدث ذلك، نادِها باسمها لاستبعاد مشكلة في التحميل: @skills-housekeeping في OpenCode، /skills-housekeeping في Claude Code، $skills-housekeeping في Codex. وإن كانت تُحمَّل بالاسم ولا تُحمَّل من تلقاء نفسها أبدًا، فالمشكلة في الوصف: أضف العبارات التي تستخدمها فعلًا.

الخطوة 5 — شاركها

ادفع المجلد إلى مستودع GitHub، ويُفضَّل داخل skills/ مجلد (skills/skills-housekeeping/SKILL.md). بعد ذلك يستطيع أي شخص تثبيتها بـ npx skills add your-name/your-repo. يجد CLI المهارات في skills/ وفي مجلدات الوكلاء الشائعة، حتى ثلاثة مستويات في العمق.

إضافات خاصة بكل وكيل، ومتى تتجنبها

عدة وكلاء تفهم حقولًا إضافية في المقدمة. لدى Claude Code disable-model-invocation (أنت وحدك من يمكنه تشغيل المهارة) و context: fork (تشغيلها داخل وكيل فرعي)؛ ولدى Cursor المسارات (فقط للملفات المطابقة)؛ ويستطيع OpenCode إخفاء مهارة عن النموذج بـ metadata على opencode/autoinvoke: false. إنها مفيدة، لكن الحقول القياسية هي التي تنتقل. توثيق Claude Code نفسه يذكر أنه خارج Claude Code، في عمليات الرفع إلى claude.ai أو Skills API، لا تُقبل إلا الحقول القياسية، وأي شيء آخر يُعد خطأً. أما المهارات التي تشاركها فالتزم بـ تسمية, الوصف, license, compatibility, metadata والحقل التجريبي allowed-tools.

تشريح مهارة الوكيل: الترويسة الأمامية في SKILL.md تُقرأ عند بدء التشغيل مقابل نحو 100 رمز (token)، والتعليمات تُقرأ عند مطابقة مهمة، والمراجع والسكربتات والأصول تُقرأ فقط عند الحاجة
ثلاث طبقات: الملصق والوصفة والملحق. الأولى وحدها تُحمَّل دائمًا، ولهذا تُهمّ الأوصاف الجيدة أكثر من التعليمات الطويلة.

الجزء 11 — البقاء آمنًا: المهارات والخوادم برمجيات

من السهل أن تظن أن المهارة “مجرد ملف Markdown”. لكنها ليست كذلك في الحقيقة. إنها تعليمات سيتبعها وكيلك بصلاحياتك، وغالبًا مع نصوص برمجية سيشغّلها على جهازك. وخادم MCP محلي هو برنامج يعمل تحت حسابك.

أرقام هذا العام مقلقة. دراسة ToxicSkills من Snyk، المنشورة في فبراير 2026، فحصت 3,984 مهارة وكيل عامة: 36.82% منها بها ثغرة أمنية واحدة على الأقل، و13.4% بها ثغرة حرجة، و76 منها احتوت على حمولات خبيثة مؤكدة. تركّزت المشكلة على ClawHub، السوق المجتمعي لـ OpenClaw، حيث وجد تدقيق سابق لـ 2,857 مهارة، نقله Snyk أيضًا، 341 مهارة خبيثة، أي نحو 12% من السجل آنذاك. وعلى النقيض، لم تُفعِّل أكثر 100 مهارة شيوعًا على skills.sh أيًا من فحوص حقن الموجّهات أو الشيفرة الخبيثة لدى Snyk. الشهرة ليست دليلًا، لكنها تساعد.

لـ MCP نسخته الخاصة من هذا الخطر. تحذّر وثائق Claude Code من أن الخوادم التي تجلب محتوى من الخارج قد تعرّضك لـ حقن الموجّه: صفحة ويب أو تعليق على مشكلة أو تقرير عن عطل يحتوي نصًا موجّهًا إلى وكيلك لا إليك.

عشر عادات تحافظ على سلامتك

  1. اقرأ قبل أن تثبّت. استخدم npx skills add owner/repo --list, gh skill preview، أو افتح ببساطة SKILL.md وسكربتاته على GitHub.
  2. فضّل صانعي الأدوات والمؤلفين المعروفين. مهارات Expo لـ Expo، ومهارات Vercel لـ Next.js، وخادم MCP الرسمي لأي مورّد لخدمته الخاصة.
  3. تحقّق من عمليات التدقيق. كل مهارة على skills.sh تعرض نتائج ثلاثة أدوات فحص: Gen Agent Trust Hub وSocket وSnyk. وتعني “Pending” أن أحدًا لم يفحصها بعد.
  4. ثبّت أي شيء مهم على إصدار محدّد. npx skills add owner/[email protected]، أو gh skill install … --pin v1.2.3، لتأتي التحديثات عندما تختار أنت.
  5. راجع التحديثات كما تراجع الشيفرة. npx skills check، ثم اقرأ التغييرات على GitHub، ثم npx skills update.
  6. ضع بوّابة على مهارات الطرف الثالث. في OpenCode، تستخدم القواعد skill إجراءً، وتفوز آخر مطابقة:

jsonc "permissions": [ { "action": "skill", "resource": "*", "effect": "ask" }, { "action": "skill", "resource": "skills-housekeeping", "effect": "allow" }, { "action": "playwright_*", "resource": "*", "effect": "ask" } ]

يفحص Hermes Agent كل تثبيت من المركز، و --force لا يمكنه تجاوز حكم “خطير”. ويسأل Gemini CLI عن موافقتك قبل تفعيل أي مهارة. 7. امنح الخوادم أقل صلاحية تكفي. رموز مميزة للقراءة فقط ومحدّدة بدقة؛ رمز منفصل لكل خادم؛ أدوات الكتابة والحذف على “ask” أو مستبعدة. 8. أبعِد الأسرار عن المهارات وعن الإعدادات الملتزَم بها في المستودع. استخدم متغيرات البيئة ({env:NAME} في OpenCode، ${VAR} في Claude Code عبر ملف .mcp.json, ${env:NAME} في Cursor)، ولا تلصق المفاتيح أبدًا. 9. كن حذرًا مع إعدادات مشاريع الآخرين. يمكن أن يجلب المستودع المستنسخ إعداداته الخاصة .mcp.json أو مهاراته. يسأل Claude Code قبل استخدام خوادم المشروع، ويُبقي Gemini CLI الخوادم المحلية غير موصولة في المجلدات غير الموثوقة، ولا يحمّل Hermes Agent مهارات المشروع إلا بعد hermes skills trust. لا تنقر على تلك المطالبات دون انتباه. 10. أزل ما لا تستخدمه. كل مهارة وخادم غير مستخدمين هما سطح هجوم تدفع ثمنه من نافذة السياق.

قائمة تحقق أمنية لمهارات الوكلاء وخوادم MCP: أرقام Snyk عن ToxicSkills لـ3,984 مهارة عامة وعشر عادات آمنة، من القراءة قبل التثبيت وتثبيت نسخ محددة من الإصدارات إلى رموز بأقل صلاحية
المهارة تعليمات يتبعها وكيلك بصلاحياتك. ثبّتها بالعناية نفسها التي تمنحها لأي برنامج آخر.

الجزء 12 — روتين أسبوعي من دقيقتين

تنحرف المهارات والخوادم مع الوقت. وروتين صغير يبقيها مضبوطة:

# المهارات العامة، من مجلد محايد
cd /tmp && npx skills@latest check -g

# كل مشروع تعمل عليه فعليًا
cd ~/code/my-app && npx skills@latest check -p

# بعد قراءة ما تغيّر في المصدر:
npx skills update -g

مرة في الشهر، خذ خمس دقائق إضافية:

  • شذّب القائمة. npx skills ls -g وأزل ما لم تستخدمه. في Claude Code، تعرض لوحة الإضافات الإضافات التي لم تستخدمها مؤخرًا.
  • اعرض قائمة خوادمك. opencode mcp list, claude mcp list, gemini mcp list أو hermes mcp test لكل منها. أزل أي شيء نسيت إضافته.
  • بدّل الرموز التي منحتها للخوادم، خصوصًا تلك القادرة على الكتابة.

جهازان، إعداد واحد

أشغّل الوكلاء على Mac وعلى Raspberry Pi، وثلاث عادات تُبقيها متزامنة:

  1. النهج نفسه على الجهازين: مستخدمك العادي، ولا تستخدم أبدًا sudo، وأن يُشغَّل CLI من مجلد مشروع أو /tmp.
  2. مهارات المشروع تنتقل مع Git. التزم .agents/skills و skills-lock.json؛ وعلى الجهاز الآخر، npx skills install يستعيد الإصدارات نفسها بالضبط.
  3. المهارات العامة تأتي من سكربت. احفظ npx skills add … -g الأوامر في ملف shell صغير، وتشغّله على كل جهاز. ويعمل أيضًا توثيقًا لما تعتمد عليه.

على جهاز بلا شاشة مثل Pi، اضبط GITHUB_TOKEN في ~/.bashrc حتى لا تصل فحوص التحديثات إلى حد الطلبات المجهولة. تسجيلات الدخول عبر المتصفح تحتاج إلى عناية: يتيح OpenCode لصق عنوان URL الخاص بالاستدعاء في موجّهه، ويقدّم Hermes Agent اللصق العكسي أو تمرير منفذ SSH أو تدفّق جهاز، بينما يحتاج تدفّق OAuth في Gemini CLI إلى متصفح على الجهاز نفسه.


الجزء 13 — أي إعداد تختار؟ خمسة سيناريوهات

1. “لقد بدأت للتو مع OpenCode.”

ثبّت ثلاث مهارات كحد أقصى و خادم MCP واحد. Context7 خادم أول جيد، ومهارة الإصدار أو المراجعة التي تناسب طريقة عملك مهارة أولى جيدة. أبقِ مهارات الأطراف الثالثة على سؤال في أذونات OpenCode حتى تثق بها. مقالي دليل OpenCode الخاص بي يغطي بقية الإعداد.

2. “أستخدم OpenCode وClaude Code جنبًا إلى جنب، وربما Hermes Agent أيضًا.”

ثبّت المهارات عالميًا عبر CLI وسمِّ كل وكيل: npx skills add owner/repo -g -a opencode -a claude-code -a hermes-agent. نسخة واحدة، ثلاثة وكلاء. لا تتشارك خوادم MCP ملف إعدادات موحّدًا، لذا أضف كل خادم إلى كل وكيل واحفظ القائمة في مكان تجده. مقالي مقارنة OpenCode وHermes Agent وOpenClaw يشرح أين يتفوق كل وكيل، ومقالي مقارنة هارنسات البرمجة بالذكاء الاصطناعي يغطي 28 منها جنبًا إلى جنب.

3. “فريقي يتشارك مستودعًا.”

استخدم نطاق المشروع: ثبّت .agents/skills, skills-lock.json، وإعدادات MCP (opencode.jsonc, .mcp.json أو .cursor/mcp.json) من دون أي أسرار فيها. كل شخص يحفظ المفاتيح في بيئته الخاصة. في CI، npx skills install --frozen-lockfile يفشل إذا انحرفت مهارات أي شخص، و npx skills check -p يفشل عندما تكون هناك تحديثات في الانتظار.

4. “وكلائي يعملون على Raspberry Pi أو خادم.”

مستخدم عادي واحد، ولا sudo، أبدًا. اضبط GITHUB_TOKEN، فضّل الخوادم البعيدة التي تقبل رمزًا في ترويسة (أو تتيح تسجيل الدخول عبر الجهاز)، وشغّل الفحص الأسبوعي من /tmp. الجزء 6 هو قائمتك المرجعية.

5. “يجب ألا يغادر كودي جهازي.”

استخدم خوادم MCP المحلية فقط، وتجاوز خوادم التوثيق والبحث في الكود البعيدة. أوقف قياس الاستخدام في CLI (DISABLE_TELEMETRY=1)، واقرأ كل مهارة تثبّتها، وتذكّر أن النموذج نفسه قد يظل نموذجًا سحابيًا: فالخصوصية تعتمد على مكان النموذج تشغيله أيضًا. دليلي إلى تشغيل نماذج LLM على MacBook يغطي ما يكلّفه المسار المحلي بالكامل فعلاً.


الأسئلة الشائعة

ما هي مهارات الوكلاء؟

مهارات الوكيل هي مجلدات تعلّم وكيل الذكاء الاصطناعي كيفية أداء مهمة معيّنة. يحتوي كل منها على SKILL.md ملف فيه اسم ووصف وتعليمات خطوة بخطوة، إضافة إلى نصوص وملفات مرجعية اختيارية. لا يقرأ الوكيل في بداية الجلسة سوى الأوصاف، ويحمّل التعليمات الكاملة للمهارة عندما تتطابق مهمة معها. تتبع المهارات معيارًا مفتوحًا، لذا يعمل معظمها في OpenCode وClaude Code وCodex وCursor وGemini CLI وGitHub Copilot وHermes Agent على حد سواء.

ما هو خادم MCP؟

خادم MCP برنامج صغير يمنح وكيل الذكاء الاصطناعي أدوات جديدة عبر Model Context Protocol، وهو معيار مفتوح تستضيفه الآن مؤسسة Agentic AI Foundation التابعة لمؤسسة Linux Foundation. تعمل الخوادم المحلية على حاسوبك ويشغّلها الوكيل؛ أما الخوادم البعيدة فتعمل على حواسيب مزوّد ويُوصَل إليها عبر عنوان ويب، عادةً بتسجيل دخول من المتصفح. من الأمثلة خادم GitHub الرسمي، وContext7 للتوثيق الحالي، وPlaywright للتحكم في المتصفح.

ما الفرق بين مهارات الوكيل وخوادم MCP؟

المهارة تمنح الوكيل الخبرة: تعليمات مكتوبة حول كيفية أداء مهمة، تُحمّل عند الحاجة فقط. وخادم MCP يمنح الوكيل القدرات: أدوات تصل إلى أنظمة خارج الطرفية، مثل GitHub أو متصفح أو متتبّع الأعطال. استخدم المهارة للإجراءات والأعراف، وخادم MCP للوصول الحيّ إلى نظام، و AGENTS.md للقواعد التي تنطبق على كل مهمة. وإذا وُجدت أداة سطر أوامر جيدة، فمهارة تعلّمها غالبًا أرخص من خادم.

هل تعمل المهارات بالطريقة نفسها في OpenCode وClaude Code وCodex؟

في الغالب، لأن الثلاثة تتبع معيار Agent Skills. والفرق في المكان الذي تبحث فيه. يقرأ Codex وOpenCode المجلدين المشتركين .agents/skills و ~/.agents/skills ؛ ويقرأ OpenCode أيضًا .opencode/skills ومجلدات Claude Code. ولا يقرأ Claude Code سوى .claude/skills و ~/.claude/skills. بعض حقول الترويسة الإضافية، كتلك الخاصة بـ Claude Code context: fork، تعمل في وكيل واحد فقط، لذا ينبغي أن تلتزم المهارات المشتركة بالحقول القياسية.

كيف أثبّت مهارة باستخدام npx skills؟

التشغيل npx skills add owner/repo --list لرؤية المهارات التي يقدّمها مستودع ما، ثم npx skills add owner/repo --skill skill-name -a opencode -a claude-code لتثبيت إحداها للوكلاء الذين تستخدمهم. أضف -g لجعلها متاحة في كل مشروع. تحتاج إلى Node.js 22.20 أو أحدث. وبدون خيارات، يسألك CLI أي المهارات والوكلاء تريد، وهل يربط الملفات أم ينسخها.

أين يثبّت npx skills المهارات؟

تضع عمليات التثبيت الخاصة بالمشروع النسخة الفعلية في .agents/skills/<name> داخل مشروعك وتسجّلها في skills-lock.json. أما عمليات التثبيت العامة (-g) فتضعها في ~/.agents/skills/<name> وتسجّلها في ~/.agents/.skill-lock.json. الوكلاء الذين يقرؤون .agents/skills يستخدمون تلك النسخة مباشرةً؛ وللوكلاء الذين لديهم مجلدهم الخاص، مثل Claude Code (.claude/skills) أو Hermes Agent (~/.hermes/skills)، يُنشئ CLI رابطًا إليها.

كيف أعرف أن مهاراتي محدّثة؟

التشغيل npx skills@latest check -g للمهارات العامة، أو npx skills@latest check -p داخل مشروع. يقارن CLI بصمة كل مجلد مهارة في ملف القفل لديك بالمجلد نفسه عند المصدر، ويسرد أي مهارة لها تحديث، دون تثبيت أي شيء. منذ الإصدار 1.7.5 (2 نوفمبر 2026)، check يقتصر على الإبلاغ؛ npx skills update يتولّى التثبيت. شغّله من مجلد مشروع أو /tmp، لا من مجلدك الرئيسي.

لماذا يقول npx skills إن كل المهارات محدّثة عندما يفشل الفحص؟

لأن الملخّص يحسب فقط التحديثات التي وجدها. فإذا كان حد GitHub البالغ 60 طلب API مجهولًا في الساعة يحجب كل بحث، يطبع CLI سطر ✗ لكل مصدر وقد ينتهي مع ذلك بعبارة “كل المهارات العامة محدّثة”. سجّل الدخول بـ gh auth login أو عيّن رمز وصول للقراءة فقط GITHUB_TOKEN لرفع الحد إلى 5,000 طلب في الساعة، ارتقِ عبر npx skills@latest، واقرأ دائمًا أسطر ✗.

هل أستخدم sudo مع npx skills؟

لا. تُخزَّن المهارات لكل مستخدم على حدة، وللمستخدم root مجلد home خاص به، لذا sudo يثبّت المهارات في /root/.agents/skills، حيث لا تراها الوكلاء التي تعمل بحسابك العادي أبدًا. وقد يترك أيضًا ملفات مملوكة لـ root في مجلداتك ويطلق أخطاء npm مثل “لا يمكن تغيير prefix من إعدادات المشروع”. شغّل الـ CLI ووكلاءك بحساب المستخدم العادي.

كيف أضيف خادم MCP إلى OpenCode؟

التشغيل opencode mcp add <name> --url <address> لخادم بعيد، أو opencode mcp add <name> -- <command> لخادم محلي، ثم تحقق منه عبر opencode mcp list. أضف --global لاستخدامه في كل مشروع. ويمكن أن توجد الإعدادات نفسها تحت mcp.servers في opencode.jsonc، مع كتابة الأسرار على هيئة {env:NAME}. استخدم opencode mcp auth <name> لتسجيل الدخول، و /mcps داخل جلسة لتوصيل الخوادم أو فصلها.

كم عدد خوادم MCP التي ينبغي أن أثبّتها؟

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

هل تثبيت مهارات الوكلاء آمن؟

آمنة بقدر أمان مصدرها فقط. المهارة تعليمات يتبعها وكيلك بصلاحياتك، وغالبًا مع سكربتات يشغّلها. وجدت دراسة Snyk’s في فبراير 2026 على 3,984 مهارة عامة عيوبًا أمنية بنسبة 36.82% وأكدت وجود حمولات خبيثة في 76 منها. اقرأ المهارة وسكربتاتها قبل التثبيت، وفضّل المهارات من صانعي الأداة’ نفسها، وتحقّق من نتائج التدقيق على skills.sh، وثبّت الإصدارات، وأبقِ مهارات الطرف الثالث على “ask” في صلاحيات وكيلك’.

ما هو skills-lock.json؟

إنه ملف القفل الخاص بالمشروع’ الذي يكتبه skills CLI عند تثبيت المهارات في مشروع. يسجّل مصدر كل مهارة وبصمة لملفاتها. أودعه في Git: على حاسوب آخر، npx skills install يستعيد المهارات نفسها بالضبط، و --frozen-lockfile يفشل إن اختلف أي شيء. وللمهارات العامة ملف قفل منفصل في ~/.agents/.skill-lock.json، واحد لكل حساب مستخدم.

ما هو skills.sh؟

skills.sh هو دليل Vercel’s العام لمهارات الوكلاء. يرتّب المهارات حسب عمليات التثبيت، ويجمعها حسب الموضوع، ويعرض نتائج التدقيق الأمني من Gen Agent Trust Hub وSocket وSnyk لكل واحدة منها. وتثبّت المهارات منه بالأمر npx skills add owner/repo الذي يعرضه. أمر الـ CLI’ نفسه npx skills find يبحث في الدليل من طرفيتك.

الخلاصة

مهارات الوكلاء وخوادم MCP يجيبان عن سؤالين مختلفين. تجيب المهارات عن “كيف نفعل هذا هنا؟”: فهي بطاقات وصفات رخيصة وقابلة للنقل’ لا تُحمّل إلا عند الحاجة. وتجيب خوادم MCP عن “هل يمكنك الوصول إلى ذلك النظام؟”: فهي مفاتيح قوية’ تستهلك السياق وتستحق العناية نفسها التي تستحقها أي برمجية تثبّتها. AGENTS.md يحتفظ بالقواعد القليلة التي تنطبق على كل شيء، والصلاحيات تفرض ما يجب ألا يحدث أبدًا.

إن كنت ستأخذ خمسة أشياء من هذا الدليل، فخُذ هذه:

  1. ضع المهارات المشتركة في .agents/skills ودع npx skills يربطها بالوكلاء التي تبحث في مكان آخر.
  2. التشغيل npx skills@latest check من مجلد مشروع أو /tmp, اقرأ أسطر ✗، وحدّث بتأنٍّ.
  3. سجّل الدخول إلى GitHub (gh auth login) على كل جهاز يتحقق من التحديثات.
  4. لا تستخدم sudo مع المهارات أو الوكلاء.
  5. ابدأ بثلاث مهارات وخادم واحد، ولا تُضِف المزيد إلا عندما تتطلب مهمة حقيقية ذلك.

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


هل تستخدم مهارات أو خوادم MCP لم أذكرها؟ أودّ أن أعرف أيها استحق مكانًا دائمًا في إعدادك، وأي رسائل الخطأ جعلتك تبحث. التصحيحات مرحّب بها: يُحدَّث هذا المقال عندما تتغير الأدوات، وهذا سيحدث كثيرًا كما يبدو من هذا العام.

الإفصاح: لم ترعَ أي شركة مذكورة في هذا المقال العمل ولم تراجعه ولم توافق عليه، ولا يحتوي على روابط تابعة. والمنتجات تُذكر في النص فقط؛ والصور تستخدم شعاراتي الخاصة.

آخر تحديث: 15 نوفمبر 2026.

أضف إشارتك.

لن يُنشر عنوان بريدك الإلكتروني. الحقول الإلزامية مشار إليها بـ *

arالعربية