الإجابة المختصرة
- 1ضع المهارة في
~/.cursor/skills/لاستخدامها في جميع المشاريع (وهو أيضاً المجلد الوحيد الذي يمكن مزامنته مع Cloud Agents)، أو في.cursor/skills/لمشروع واحد. - 2يجب أن يطابق
nameفيSKILL.mdاسم المجلد، باستخدام الأحرف الصغيرة والأرقام والشرطات فقط. - 3اعثر عليها ضمن Customize → Skills. شغّلها باستخدام
/skill-name، أو أرفقها برسالة باستخدام@skill-name. - 4تريد مهارات جاهزة؟ تصفح مهارات Cursor التي يمكنك تثبيتها بأمر واحد.
أين يبحث Cursor عن المهارات؟
يفحص Cursor مجلداته الخاصة والمجلد المشترك ~/.agents/skills/ ومجلدات Claude Code وCodex أيضاً. إذا كنت تستخدم وكيلاً آخر بالفعل، فقد تكون مهاراتك موجودة في Cursor.
| المجلد | الغرض منه |
|---|---|
~/.cursor/skills/ | جميع المشاريع. المجلد الوحيد الذي يتزامن مع Cloud Agents. |
~/.agents/skills/ | جميع المشاريع على هذا الجهاز. يثبّت Skillry هنا، ويقرأه Codex أيضاً. |
.cursor/skills/ أو .agents/skills/ | مشروع واحد، في أي مكان داخل المستودع. ينطبق المجلد المتداخل على الملفات الموجودة تحته. |
.claude/skills/ و.codex/skills/ والمساران نفسهما داخل ~ | تُقرأ كي تعمل مهارات Claude Code وCodex هنا أيضاً. |
كيفية إضافة مهارات إلى Cursor
يثبّت Skillry CLI في ~/.agents/skills/ الذي يقرأه Cursor، لذا لا تحتاج إلى خيار إضافي. إذا نسخت المجلد يدوياً، فضعه بدلاً من ذلك في ~/.cursor/skills/؛ فهذا هو المجلد الذي يمكن أن يرافقك إلى Cloud Agents.
- 1
افتح المهارة على Skillry، واختر نسخ موجّه التثبيت، ثم اختر نسخ في مربع الحوار.
- 2
الصقه في Cursor وأرسله. يقرأ الوكيل تعليمات التثبيت من Skillry ويشغّل الأمر المناسب بنفسه.
موجّه التثبيت Read https://skillry.dev/skills/<slug>/install.md and follow the instructions to install the skill. - 3
عندما يطلب المتصفح الموافقة على رمز الجهاز، وافق عليه.
يُفترض أن ترى: أن يذكر Cursor الإصدار الذي ثبّته والمجلد الذي استخدمه ضمن
~/.agents/skills/.
- 1
سجّل الدخول مرة واحدة. ستفتح نافذة متصفح تعرض رمز جهاز لتوافق عليه.
الطرفية npx --yes skillry-cli@latest login - 2
ثبّت المهارة. لا تحتاج إلى خيار إضافي، لأن المجلد الافتراضي لواجهة CLI هو المجلد الذي يقرأه Cursor.
الطرفية npx --yes skillry-cli@latest install <slug>يُفترض أن ترى:
Installed <slug> <version> to ~/.agents/skills/<slug>
اختر تنزيل ZIP في صفحة المهارة، أو استخدم مجلد مهارة حصلت عليه من مصدر آخر. اقرأ SKILL.md وما في scripts/ قبل التثبيت، لأن الوكيل يتبع هذه التعليمات ويمكنه تشغيل تلك السكربتات. ثم انقل المجلد كاملاً:
mkdir -p ~/.cursor/skills
mv ~/Downloads/my-skill ~/.cursor/skills/غالباً ما يُنشئ فك ZIP مستوى إضافياً، مثل my-skill/my-skill/SKILL.md. يجب أن يكون SKILL.md داخل مجلد المهارة مباشرة، وإلا فلن يجدها الوكيل.
يبحث Cursor عن المهارات عند بدء تشغيله. بعد التثبيت، افتح محادثة جديدة أو أعد تحميل النافذة، ثم افحص Customize → Skills ضمن مجموعة Agent Decides.
قاعدة التسمية التي تجعل المهارات تختفي
لا يحمّل Cursor المهارة إلا إذا طابق name في SKILL.md اسم المجلد الذي توجد فيه تماماً. وعندما يختلفان، لا تظهر رسالة خطأ؛ ببساطة لا تظهر المهارة.
لماذا اختفت؟
تنزّل launch-page ثم تعيد تسمية المجلد إلى landing لتنظيمه، فتختفي المهارة من Cursor. لم يعد اسم المجلد وname متطابقين. أعد اسم المجلد الأصلي، أو غيّر name إلى landing.
اسم يقبله Cursor
- أحرف صغيرة وأرقام وشرطات فقط
- مطابق لاسم المجلد الذي يحتوي
SKILL.md - مصحوب بـ
description
كيفية تشغيل مهارة في Cursor
في المحادثة، اكتب / واسم المهارة ثم طلبك:
/launch-page Parcelo, a parcel-tracking dashboard for small online shopsلإبقاء المهارة نشطة طوال الجلسة، اخترها من قائمة / واضغط Option+Enter (على Mac) أو Alt+Enter (على Windows)، أو اختر Use as Mode. تتحول إلى وضع مخصص وتبقى نشطة حتى تخرج منه.
استخدام المهارات في Cloud Agents
لا تعمل Cloud Agents على جهازك، لذا لا تحصل إلا على المهارات التي يزامنها Cursor لها. إليك طريقة الإعداد:
- 1احتفظ بالمهارة في
~/.cursor/skills/. تظل مهارات المشروع و~/.agents/skills/على جهازك. - 2افتح Settings → Agents → Context and Tools وفعّل Sync Skills for Cloud Agents.
- 3لمشاركة مهارة شخصية مع فريقك بدلاً من ذلك، افتحها في Customize → Skills واختر Publish.
قواعد Cursor مقارنة بالمهارات
قواعد Cursor إرشادات قصيرة يضيفها إلى المحادثة، إما دائماً أو للملفات المطابقة. أما المهارة فهي إجراء يحمّله الوكيل عندما تستدعيه المهمة فقط. استخدم القواعد للاتفاقات والمهارات للأعمال متعددة الخطوات.
إجراء عند الطلب
- مجلد يحتوي
SKILL.md - تعمل عندما تكون مناسبة، أو عندما تكتب
/name - عمل متعدد الخطوات وسكربتات وقوالب
إرشادات ضمن السياق
- ملفات
.mdcداخل.cursor/rules/(يتم تجاهل ملفات.mdالعادية) - تطبيق دائم، أو ذكي، أو على ملفات محددة، أو يدوي
- اتفاقات قصيرة. يقرأ Cursor أيضاً
AGENTS.mdوCLAUDE.md
هل تنقل قواعد قديمة؟ يحوّل أمر Cursor المضمن /migrate-to-skills قواعد «Apply Intelligently» وأوامر الشرطة المائلة إلى مهارات.
مهارة Cursor لا تظهر؟ جرّب هذه الخطوات
افحص الاسم أولاً. عدم تطابق name مع المجلد هو السبب المعتاد لاختفاء مهارة في Cursor.
غير موجودة ضمن Customize → Skills
تحقق من تطابق name مع المجلد، ثم افتح محادثة جديدة أو أعد تحميل النافذة.
غير موجودة في Cloud Agents
انقلها إلى ~/.cursor/skills/ وفعّل المزامنة.
لا تُختار تلقائياً أبداً
قد لا يطابق وصفها طريقة طلبك، أو قد يحصرها paths في ملفات أخرى.
أسئلة شائعة
ما الفرق بين قواعد Cursor والمهارات؟
القواعد إرشادات يضيفها Cursor إلى المحادثات، إما دائماً أو للملفات المطابقة. والمهارات مجلدات تحتوي إجراء يستخدمه الوكيل عندما يكون مناسباً أو عندما تستدعيه.
هل يستطيع Cursor استخدام مهارات Claude؟
نعم. يقرأ Cursor ~/.claude/skills/ و.claude/skills/، بشرط أن يطابق name لكل مهارة اسم مجلدها.
أين تُخزن مهارات Cursor؟
في ~/.cursor/skills/ أو ~/.agents/skills/ لجميع المشاريع، وفي .cursor/skills/ أو .agents/skills/ لمشروع واحد.
هل تعمل المهارات في Cursor Cloud Agents؟
فقط المهارات الموجودة في ~/.cursor/skills/، وبعد تفعيل Sync Skills for Cloud Agents.
المصادر
هل ساعدك هذا الدليل؟
