دليل
كيف تزامن المهارات مع Claude Code وCodex وCursor وOpenCode
احتفظ بكل مهارة في مجلد واحد، واربطه بالمكان الذي تبحث فيه كل أداة: ~/.claude/skills لـ Claude Code، و~/.agents/skills لـ Codex (ويقرأ Cursor وOpenCode كليهما). ولمشاركة المهارات نفسها مع فريق، قدّمها من خادم MCP واحد بدلًا من ذلك، لأن الأدوات الأربع كلها تتصل بخوادم MCP البعيدة.
الإجابة المختصرة
- Claude Code:
~/.claude/skills، أو.claude/skillsفي مستودع. ولا يقرأ.agents/skills. - Codex:
~/.agents/skills، أو.agents/skillsفي مستودع. - Cursor:
.cursor/skillsو.agents/skills، وأيضًا.claude/skillsو.codex/skills، كلٌّ منها في المستودع أو تحت~/. - OpenCode:
.opencode/skillsو~/.config/opencode/skills، وأيضًا.claude/skillsو.agents/skills.
أين تبحث كل أداة
| الأداة | المجلد الشخصي | مجلد المستودع | تقرأ أيضًا |
|---|---|---|---|
| Claude Code | ~/.claude/skills | .claude/skills | المهارات المُدارة، ومهارات الإضافات، ومهارات حساب claude.ai |
| Codex | ~/.agents/skills | .agents/skills (المجلد الحالي، والمجلد الأب، وجذر المستودع) | /etc/codex/skills |
| Cursor | ~/.cursor/skills، ~/.agents/skills | .cursor/skills، .agents/skills | .claude/skills و.codex/skills ونسختاهما تحت ~/ |
| OpenCode | ~/.config/opencode/skills | .opencode/skills | .claude/skills و.agents/skills ونسختاهما تحت ~/ |
من توثيق كل أداة، تاريخ الاطلاع 4 نوفمبر 2026. يحتوي كل مجلد على مجلد فرعي لكل مهارة، وبداخله ملف SKILL.md.
مجلدان يغطيان الأدوات الأربع: ~/.claude/skills (Claude Code وCursor وOpenCode) و~/.agents/skills (Codex وCursor وOpenCode).
نسخة واحدة على جهازك: الروابط الرمزية
احتفظ بالملفات الحقيقية في مجلد واحد، ووجّه الموقعين إليه. على macOS أو Linux:
mkdir -p ~/skills
# move existing skills in first, then:
ln -s ~/skills ~/.claude/skills
ln -s ~/skills ~/.agents/skills
إذا كان أي من المجلدين موجودًا بالفعل، فانقل محتوياته إلى ~/skills واحذف المجلد الفارغ قبل الربط. ويقرأ Cursor وOpenCode الموقعين كليهما، فيصلان إلى الملفات نفسها عبر مسارين. وإذا عرضت إحداهما مهارة مرتين، فهي لا تزال ملفًا واحدًا: عدّله مرة واحدة في ~/skills.
وفي المستودع، افعل الشيء نفسه مع .claude/skills و.agents/skills، وأودِع (commit) المجلد الحقيقي، فيحصل على المهارات كل من ينسخ المستودع.
نسخة واحدة للفريق: خادم MCP
تنفع الروابط الرمزية والمستودعات المطوّرين. لكنها لا تصل إلى الزميل الذي يعمل في Claude أو ChatGPT من المتصفح، وتحتاج إلى git pull للتحديث. وتتصل وكلاء البرمجة الأربعة كلها أيضًا بخوادم MCP البعيدة:
- Claude Code:
claude mcp add --transport http <name> <url> - Codex: إدخال خادم فيه
url = "…"في إعداداته (Streamable HTTP). - Cursor: خادم Streamable HTTP في إعدادات MCP الخاصة به.
- OpenCode: خادم فيه
"type": "remote"في إعداداته.
والخادم الذي يحتوي على مهارات الفريق يمنح وكلاء البرمجة وClaude وChatGPT النسخة الحالية نفسها، دون أي سحب أو إعادة ربط.
AI Skill Pod · البدء مجاني
مساحة فريق واحدة لمهارات فريقك، ورابط MCP واحد لـ Claude Code وCodex وCursor وOpenCode وClaude وChatGPT. ومن لا يفتحون الطرفية أبدًا يضيفون المهارات بلصق مستند أو بقول «اجعل هذه مهارة للفريق» في المحادثة.
تحقّق من أن الأداة ترى مهارتك
- تحقّق من البنية:
<folder>/<skill-name>/SKILL.md، ويحمل المجلد اسم حقلnameنفسه. - تحقّق من المقدمة (frontmatter): حقل
nameمن أحرف إنجليزية صغيرة وأرقام وشرطات، حتى 64 حرفًا، وحقلdescriptionغير فارغ. ويكتب محوّل SKILL.md الحقلين. - ابدأ جلسة جديدة واسأل الوكيل عن المهارات المتوفرة لديه، أو اطلب المهمة التي يذكرها الوصف.
Skills for this
- المنتجPRD from messy notes (English)Turns notes, Slack threads, and call notes into a PRD: problem with evidence, goals and non-goals, metrics, must/should/could requirements, and flagged gaps.
- المنتجRelease notes from merged changes (English)Writes customer-facing release notes from merged PRs or tickets, grouped New, Improved, Fixed, benefit-first, plus an internal changelog.
- المنتجUser stories with acceptance criteria (English)Turns a feature into user stories with Given/When/Then acceptance criteria, edge cases, out-of-scope notes, and an INVEST check per story.
- المنتجSpec review before build (English)Reviews a PRD or spec before build for ambiguity, missing empty/loading/error/permission states, metrics, rollout, and a first-time user walk-through.
- نجاح العملاءBug report from a support ticket (English)Turns a customer complaint into an engineering-ready bug report: steps to reproduce, expected vs actual, environment, impact, evidence, and questions to ask.
أسئلة
كيف أزامن مهارات Claude Code مع Claude Desktop وclaude.ai؟
يقرأ Claude Code المجلدات من القرص؛ أما Claude Desktop وclaude.ai فيحتفظان بالمهارات المرفوعة في حسابك. ارفع المجلد نفسه كملف ZIP من Customize > Skills، أو اربط كليهما بخادم MCP واحد يقدّم المهارات.
لماذا لا يرى Claude Code مجلد .agents/skills الخاص بي؟
يقرأ Claude Code المجلدين ~/.claude/skills و.claude/skills، لا .agents/skills. اربط المجلد داخل ~/.claude/skills، كما في خطوات الروابط الرمزية أعلاه.
المصادر
- توثيق Claude Code: المهارات (بالإنجليزية) (تاريخ الاطلاع: 2026-11-04)
- توثيق Claude Code: MCP (بالإنجليزية) (تاريخ الاطلاع: 2026-11-04)
- توثيق Codex: بناء المهارات (بالإنجليزية) (تاريخ الاطلاع: 2026-11-04)
- توثيق Codex: MCP (بالإنجليزية) (تاريخ الاطلاع: 2026-11-04)
- توثيق Cursor: المهارات (بالإنجليزية) (تاريخ الاطلاع: 2026-11-04)
- توثيق Cursor: MCP (بالإنجليزية) (تاريخ الاطلاع: 2026-11-04)
- توثيق OpenCode: المهارات (بالإنجليزية) (تاريخ الاطلاع: 2026-11-04)
- توثيق OpenCode: خوادم MCP (بالإنجليزية) (تاريخ الاطلاع: 2026-11-04)