تحمّل أدوات Claude Code وCodex وOpenCode الـ Skills جميعها بالتنسيق نفسه: مجلد بداخله ملف SKILL.md. وهذا التنسيق هو معيار Agent Skills المفتوح، الذي أنشأته Anthropic وأصبح مشروعًا تابعًا لـ Linux Foundation في 4 نوفمبر 2026. لذلك يمكن لـ Skill واحدة أن تعمل في الأدوات الثلاث. لكن المشكلة أن كل أداة تبحث في مجلدات مختلفة، وأن بعض الحقول لا يفهمها إلا Claude Code. يوضح هذا الدليل أين تبحث كل أداة، وكيف تحتفظ بنسخة واحدة تحمّلها الأدوات الثلاث، وما الذي لا ينتقل، وكيف يمنح Orkas الـ Skills نفسها لكل وكيل برمجة يشغّله.
الإجابة المختصرة: احتفظ بكل مجلد Skill في ~/.agents/skills. يقرأ Codex وOpenCode هذا المجلد بالفعل. أما Claude Code فلا يقرؤه، لذا أضف رابطًا لكل Skill في ~/.claude/skills. اقتصر في الـ frontmatter على name وdescription، وسمِّ كل Skill باسم مجلدها نفسه. جرى التحقق في 8 نوفمبر 2026 على Claude Code 2.1.319 وCodex 0.167.0 وOpenCode 2.2.6.
أين يبحث Claude Code وCodex وOpenCode عن الـ Skills
| المجلد | Claude Code | Codex | OpenCode |
|---|---|---|---|
~/.agents/skills | لا | نعم | نعم |
.agents/skills في مشروع | لا | نعم | نعم |
~/.claude/skills | نعم | لا | نعم |
.claude/skills في مشروع | نعم | لا | نعم |
~/.codex/skills | لا | نعم، لكنه متقادم | لا |
~/.config/opencode/skills، .opencode/skills | لا | لا | نعم |
| طريقة استدعاء Skill | /skill-name | $skill-name أو /skills | @skill-name |
وتختار الأدوات الثلاث أيضًا Skill من تلقاء نفسها عندما يطابق طلبك وصفها. وبالنسبة إلى مجلدات المشروع، تفحص كل أداة المجلد الذي تشغّلها فيه وكل مجلد أعلى منه حتى جذر المستودع.
- Claude Code هو الأداة التي لن تعثر على
.agents/skills. لا تذكر وثائق الـ Skills الخاصة به سوى مجلدات.claude، وتقول وثائق الذاكرة إنه لا يقرأ «أي شيء داخل مجلد.agents/». ولا يزال طلب تغيير ذلك، المشكلة #31005، مفتوحًا بأكثر من 450 تصويتًا مؤيدًا. - انتقل Codex إلى
.agents/skills. تذكر وثائقه المجلد.agents/skillsفي المشروع، و~/.agents/skillsلك، و/etc/codex/skillsللمسؤولين. والمجلد القديم~/.codex/skillsمعلَّم في الشيفرة المصدرية على أنه متقادم، لكنه لا يزال يُحمَّل. ولا يقرأ Codex أي مجلد.claude. - يقرأ OpenCode كل شيء. تذكر وثائقه مجلداته الخاصة إضافة إلى
.claude/skillsو.agents/skills، على المستويين كليهما. وينطبق هذا على سلسلة 2.2 وعلى سلسلة 1.19 التي لا تزال تصدر لها إصدارات جديدة.
إعداد مجلد مشترك واحد
استخدم ~/.agents/skills بوصفه النسخة الحقيقية الوحيدة. يقرؤه Codex وOpenCode دون أي إعداد، ويكتب فيه كلٌّ من npx skills وأداة الاستيراد في Codex. ثم يحصل Claude Code على رابط لكل Skill.
- انقل الـ Skills الخاصة بك إلى
~/.agents/skills. لكل Skill كتبتها في~/.claude/skillsأو~/.codex/skills، انقل مجلدها، مثلًاmv ~/.claude/skills/release-notes ~/.agents/skills/. واترك~/.claude/skills/syncedفي مكانه: ففيه يحتفظ Claude Code بالـ Skills القادمة من حسابك على claude.ai. - اربط كل Skill بمجلد Claude Code. على macOS أو Linux، شغّل ما يلي. يتخطى السكربت أي Skill لها مجلد أو رابط هناك مسبقًا.
mkdir -p ~/.agents/skills ~/.claude/skills
for d in ~/.agents/skills/*/; do
n=$(basename "$d")
[ -e ~/.claude/skills/"$n" ] || ln -s ~/.agents/skills/"$n" ~/.claude/skills/"$n"
done- على Windows، استخدم روابط junction. فهي لا تحتاج إلى صلاحيات المسؤول. في PowerShell:
New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null
Get-ChildItem "$HOME\.agents\skills" -Directory | ForEach-Object {
$link = "$HOME\.claude\skills\$($_.Name)"
if (-not (Test-Path $link)) { New-Item -ItemType Junction -Path $link -Target $_.FullName | Out-Null }
}- تحقّق من كل أداة. ابدأ جلسة جديدة. في Claude Code، اكتب
/وابحث عن الـ Skill. في Codex، شغّل/skills. في OpenCode، اكتب@.
في مشروع يتشاركه الفريق، افعل الشيء نفسه داخل المستودع: احتفظ بالـ Skills في .agents/skills واربط كل واحدة منها من .claude/skills برابط نسبي مثل ln -s ../../.agents/skills/release-notes .claude/skills/release-notes.
بعض الأمور التي يجب الانتباه إليها:
- اربط كل Skill على حدة، لا المجلد كله. إذا كان
~/.claude/skillsنفسه يشير إلى~/.agents/skills، فسينتهي مجلداsyncedو.trashالخاصان بـ Claude Code في المجلد المشترك، وقد يحمّل Codex وOpenCode الـ Skills المتزامنة أيضًا. والثمن أنك ستعيد تشغيل الحلقة بعد إضافة أي Skill. - اربط المجلدات، لا ملفات SKILL.md. يتبع Codex مجلد Skill مرتبطًا، لكنه يتجاهل ملف SKILL.md إذا كان هو نفسه رابطًا. وقد أغلقت OpenAI هذا الطلب بوصفه غير مخطط له.
- لا تضف الروابط إلى المستودع إذا كان في فريقك من يستخدم Windows. يسحب Git for Windows الروابط افتراضيًا على شكل ملفات نصية صغيرة. أنشئ الروابط بسكربت إعداد، أو أضف إلى المستودع نسخًا حقيقية.
- يرى OpenCode كل Skill مرتين ويحتفظ بواحدة. فهو يقرأ الرابط في
~/.claude/skillsوالمجلد في~/.agents/skillsمعًا. يدمجهما الإصدار 2.2 بصمت. أما الإصدار 1.19 فيسجّل تحذيرًا من التكرار؛ اضبطOPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1لكي يتوقف OpenCode عن قراءة مجلدات Claude.
كتابة Skill تحمّلها الأدوات الثلاث
يُحمَّل ملف SKILL.md هذا بالطريقة نفسها في Claude Code وCodex وOpenCode. وهو موجود في ~/.agents/skills/release-notes/SKILL.md، وبجانبه مجلد references ومجلد scripts.
---
name: release-notes
description: "Drafts release notes from git commits since the last tag. Use when the user asks for a changelog, release notes, or what changed since the last release."
license: MIT
---
# Release notes
1. Find the last tag: git describe --tags --abbrev=0
2. List the commits since it: git log <tag>..HEAD --oneline --no-merges
3. Group the commits into Added, Changed and Fixed, using references/format.md in this skill's folder.
4. To save a file, run scripts/write_notes.sh from this skill's folder.- سمِّ الـ Skill باسم مجلدها نفسه. استخدم أحرفًا صغيرة وأرقامًا وشرطات، بحد أقصى 64 حرفًا. يعتمد Codex على
name، ويعتمد OpenCode 2.2 على اسم المجلد، ويقبل Claude Code أيًّا منهما. وإذا اختلفا، فستستدعي الـ Skill نفسها بأسماء مختلفة في كل أداة. ويتخطى Codex أي Skill يزيد اسمها على 64 حرفًا. - اجعل الوصف أقل من 1,024 حرفًا وضع في بدايته الكلمات التي سيستخدمها الناس. هذا هو حد المعيار، ويقتطع Codex الأوصاف الأطول إلى هذا الطول في قائمة الـ Skills لديه.
- ضع بين علامتي تنصيص أي قيمة تحتوي على نقطتين تليهما مسافة. وإلا فقد يتعذر تحليل الـ frontmatter. يصلح Codex معظم هذه الحالات، ويحمّل Claude Code الـ Skill كأنها بلا frontmatter، وقد يتخطى OpenCode الـ Skill دون أي خطأ.
- اجعل السكربتات تعثر على مجلدها بنفسها. تشغّل الأدوات الأوامر من مجلد مشروعك، لا من مجلد الـ Skill. والسكربت الذي يبدأ بـ
cd "$(dirname "$0")"يعمل من أي مكان. - لا تضع «claude» في الاسم إذا كنت قد ترفع الـ Skill إلى claude.ai أو Claude API. فكلاهما يرفض الأسماء التي تحتوي على «claude» أو «anthropic».
ما الذي لا ينتقل من Claude Code
لا يقرأ Codex إلا name وdescription ووصفًا قصيرًا ضمن metadata. ويقرأ OpenCode 2.2 أيضًا metadata وdisable-model-invocation. ويتجاهل كلاهما كل حقل آخر دون أي خطأ، لذا تُحمَّل Skill مكتوبة لـ Claude Code لكنها تتصرف بشكل مختلف.
| في Skill لـ Claude Code | Claude Code | Codex | OpenCode 2.2 |
|---|---|---|---|
allowed-tools | يعمل | يُتجاهَل | يُتجاهَل |
disable-model-invocation: true | يعمل | يُتجاهَل؛ استخدم agents/openai.yaml | يعمل |
context: fork، agent، model، hooks، argument-hint | تعمل | تُتجاهَل | تُتجاهَل |
$ARGUMENTS و$1 في النص | يُستبدلان بوسائطك | يبقيان نصًا | يبقيان نصًا |
!`command` في النص | يُنفَّذ قبل أن يقرأ Claude الـ Skill | يبقى نصًا | يبقى نصًا |
${CLAUDE_SKILL_DIR} | يُستبدل بمجلد الـ Skill | يبقى نصًا | يبقى نصًا |
- اكتب خطوات تعمل دون هذه الميزات. اكتب «شغّل scripts/check.sh من مجلد هذه الـ Skill» بدلًا من استخدام
${CLAUDE_SKILL_DIR}، واطلب التفاصيل الناقصة بكلمات بسيطة بدلًا من استخدام$ARGUMENTS. ويتبع Claude Code التعليمات نفسها دون مشكلة. - لمنع Codex من استدعاء Skill من تلقاء نفسه، أضف إلى مجلد الـ Skill ملف
agents/openai.yamlيحتوي علىallow_implicit_invocation: falseتحتpolicy. ويظل بإمكانك استدعاؤها عبر$skill-name. - لا يقيّد
allowed-toolsما يستطيع Codex أو OpenCode فعله. يذكر جدول التوافق فيnpx skillsأن هذا الحقل مدعوم في كليهما، لكن محمّل الـ Skills في أيٍّ من الأداتين لا يقرؤه. اضبط القيود في إعدادات الأذونات الخاصة بكل أداة.
أدوات تثبّت الـ Skills لعدة وكلاء
| الأداة | كيف تشارك الـ Skills | ما يجب الانتباه إليه |
|---|---|---|
npx skills (Vercel، 38,500 نجمة) | تنسخ الـ Skill إلى .agents/skills وتربط مجلد كل وكيل بها. وتستخدم روابط junction على Windows. ويُنشئ --copy نسخًا منفصلة. | التخطيط نفسه الوارد في هذا الدليل. شغّل npx skills add owner/repo، مع -g لمجلد المستخدم الخاص بك. |
| skillshare (2,900 نجمة) | تحتفظ بمجلد مصدر واحد وتربطه بمجلد كل أداة؛ وتستخدم روابط junction على Windows. | حُدِّثت في 6 نوفمبر 2026. تُثبَّت عبر Homebrew أو سكربت shell. |
الأمر /import في Codex | ينسخ الـ Skills من .claude/skills إلى .agents/skills. | تبتعد النسخ تدريجيًا عن الأصول. كما يغيّر «claude» إلى «Codex» في النص، بما في ذلك داخل مسارات الملفات (المشكلة المفتوحة #40147). |
| openskills (10,800 نجمة) | تنسخ الـ Skills إلى .claude/skills وتدرجها في AGENTS.md. | لا إصدار جديد منذ يناير 2026. ويكتب خيارها --universal إلى .agent/skills، الذي لا تقرؤه أي من الأدوات الثلاث. |
وماذا عن CLAUDE.md وAGENTS.md؟
يقرأ Codex وOpenCode ملف AGENTS.md، ويلجأ OpenCode إلى CLAUDE.md عندما لا يحتوي المشروع على AGENTS.md. ومنذ الإصدار 2.1.277، يقرأ Claude Code ملف AGENTS.md أيضًا، ولكن فقط في مشروع لا يحتوي على CLAUDE.md أو CLAUDE.local.md. وإذا احتفظت بالملفين كليهما، فافتح /config في Claude Code واضبط Project instructions لتحميل كليهما. ضع القواعد التي يجب أن يتبعها كل وكيل في AGENTS.md، واحتفظ بـ CLAUDE.md لكل ما يحتاج إليه Claude Code وحده.
استخدام الـ Skills نفسها من Orkas
Orkas تطبيق لسطح المكتب يشغّل Claude Code وCodex وOpenCode وOpenClaw وHermes بوصفها وكلاء في دردشة واحدة. ويستخدم النسخ المثبتة على حاسوبك وتسجيلات الدخول الخاصة بك. وإليك كيف تصل الـ Skills الخاصة بك إلى هؤلاء الوكلاء.
- يظل المجلد المشترك يعمل. تواصل كل CLI قراءة مجلدات الـ Skills الخاصة بها عندما يشغّلها Orkas، لذا يعمل الإعداد السابق دون تغيير. ويضيف Orkas خادم MCP الخاص به بجانب خوادمك بدلًا من أن يحل محلها.
- تصل الـ Skills التي تضيفها في Orkas إلى كل CLI. تحصل كل CLI يشغّلها Orkas على خادم MCP باسم
orkas. يعرض هذا الخادم قائمة الـ Skills الخاصة بك في Orkas، ويحمّل إحداها عندما تناسب المهمة، ويشغّل السكربتات المرفقة بها. اطلب من Claude Code استخدام Skill باسمها، أو دعه يجد المناسبة بنفسه. - يقرأ Orkas أيضًا الـ Skills الخاصة بك في Claude Code وCodex. تظهر الـ Skills الموجودة في
~/.claude/skillsو~/.codex/skillsضمن المهارات ▸ المجلدات العامة، ويمكن للقائد استخدامها في مهامه الخاصة. ولا يفعل Orkas سوى قراءة هذه المجلدات ولا يغيّرها أبدًا. ولا يقرأ~/.agents/skillsمباشرة، لذا فهو يعثر مع الإعداد السابق على الـ Skills الخاصة بك عبر الروابط في~/.claude/skills.
لإضافة حزمة Skills من GitHub، الصق رابط المستودع في دردشة مع القائد واطلب منه تثبيت الحزمة. وإذا احتاجت الحزمة إلى تثبيت تبعيات، يسألك Orkas أولًا. تظهر الـ Skills ضمن المهارات ▸ الحزم الخارجية. ومن ذلك الحين، يمكن لـ Claude Code وCodex وOpenCode جميعًا استخدامها عندما تشغّلها من Orkas، دون نسخ أي شيء إلى ثلاثة مجلدات. للبدء، اختر ربط الوكلاء في الشريط الجانبي وحدد أدوات CLI المثبتة لديك. وللاطلاع على شرح كامل لتشغيل اثنتين منها جنبًا إلى جنب، راجع كيفية تشغيل Claude Code وCodex معًا.
أي إعداد تختار؟
| وضعك | ما الذي تفعله |
|---|---|
| تستخدم اثنتين أو ثلاثًا من هذه الأدوات على حاسوب واحد | احتفظ بالـ Skills في ~/.agents/skills واربط كل واحدة منها في ~/.claude/skills |
| فريق يتشارك الـ Skills في مستودع | أضف .agents/skills إلى المستودع؛ وأنشئ روابط .claude/skills بسكربت إعداد |
| تثبّت الـ Skills من GitHub كثيرًا | npx skills add، الذي يُعدّ الروابط نفسها نيابةً عنك |
| تستخدم Claude Code وOpenCode فقط | واصل استخدام ~/.claude/skills؛ فـ OpenCode يقرؤه بالفعل |
| تشغّل أدوات CLI من Orkas | ثبّت حزم الـ Skills مرة واحدة في Orkas؛ ويمكن لكل CLI يشغّلها استخدامها |
الأسئلة
هل يمكنني استخدام Skills الخاصة بـ Claude في Codex؟
نعم. يقرأ Codex تنسيق SKILL.md نفسه، لكنه يبحث في ~/.agents/skills و .agents/skills، لا في ~/.claude/skills. انقل مجلدات الـ Skills إلى هناك واربطها مجددًا لـ Claude Code، أو شغّل /import في Codex لنسخها. أما حقول مثل allowed-tools وميزات مثل $ARGUMENTS فلا تعمل إلا في Claude Code.
هل يقرأ OpenCode الـ Skills الخاصة بـ Claude Code؟
نعم. يقرأ OpenCode المجلدين ~/.claude/skills و .claude/skills، إضافة إلى ~/.agents/skills ومجلداته الخاصة، لذا تظهر Skills الخاصة بـ Claude Code دون أي إعداد. لإيقاف ذلك، اضبط OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1.
هل يقرأ Claude Code المجلد .agents/skills؟
لا. حتى نوفمبر 2026، لا يقرأ Claude Code الـ Skills إلا من مجلدات .claude، وتقول وثائقه إنه يتجاهل كل ما يوجد داخل مجلد .agents. ولا يزال طلب إضافة ذلك، المشكلة #31005، مفتوحًا. وإلى أن يحدث ذلك، اربط كل Skill من ~/.claude/skills.
لماذا لا يرى Codex الـ Skill التي ربطتها؟
يتبع Codex مجلد Skill مرتبطًا، لكنه يتجاهل ملف SKILL.md إذا كان هو نفسه رابطًا. اربط المجلد كله بدلًا من ذلك. ويُحَل الرابط النسبي انطلاقًا من المجلد الذي يوجد فيه الرابط، لذا تأكد من أن المسار صحيح من هناك.
لماذا تظهر Skill مرتين؟
عادةً لأن هناك نسختين في مجلدات تقرؤها الأداة. لا يزال Codex يقرأ المجلد القديم ~/.codex/skills إضافة إلى ~/.agents/skills، ويعرض النسختين لـ Skill بالاسم نفسه. احتفظ بنسخة واحدة في ~/.agents/skills واحذف الأخرى.
لمقارنة الأدوات الثلاث فيما يتجاوز الـ Skills، راجع Claude Code مقابل Codex مقابل OpenCode.