الجمعة السوداء تبدأ مبكرًا: وفّر 50% على Pro.استكشف الخطط

كيفية إضافة مهارات إلى Cursor واستخدامها

يقرأ Cursor المهارات من مجلدات أكثر من Claude Code أو Codex، لكنه يتجاهل بصمت أي مهارة لا يطابق اسمها اسم مجلدها. إليك أين تضع المهارات وكيف تشغّلها وكيف تختلف عن قواعد Cursor.

لمن
مستخدمي Cursor
الوقت
8 دقائق للإكمال

الإجابة المختصرة

  1. 1ضع المهارة في ~/.cursor/skills/ لاستخدامها في جميع المشاريع (وهو أيضاً المجلد الوحيد الذي يمكن مزامنته مع Cloud Agents)، أو في .cursor/skills/ لمشروع واحد.
  2. 2يجب أن يطابق name في SKILL.md اسم المجلد، باستخدام الأحرف الصغيرة والأرقام والشرطات فقط.
  3. 3اعثر عليها ضمن Customize → Skills. شغّلها باستخدام /skill-name، أو أرفقها برسالة باستخدام @skill-name.
  4. 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.

الأسهل إذا كان Cursor مفتوحاً بالفعل
  1. 1

    افتح المهارة على Skillry، واختر نسخ موجّه التثبيت، ثم اختر نسخ في مربع الحوار.

  2. 2

    الصقه في Cursor وأرسله. يقرأ الوكيل تعليمات التثبيت من Skillry ويشغّل الأمر المناسب بنفسه.

    موجّه التثبيت
    Read https://skillry.dev/skills/<slug>/install.md and follow the instructions to install the skill.
  3. 3

    عندما يطلب المتصفح الموافقة على رمز الجهاز، وافق عليه.

    يُفترض أن ترى: أن يذكر Cursor الإصدار الذي ثبّته والمجلد الذي استخدمه ضمن ~/.agents/skills/.

يبحث Cursor عن المهارات عند بدء تشغيله. بعد التثبيت، افتح محادثة جديدة أو أعد تحميل النافذة، ثم افحص Customize → Skills ضمن مجموعة Agent Decides.

قاعدة التسمية التي تجعل المهارات تختفي

لا يحمّل Cursor المهارة إلا إذا طابق name في SKILL.md اسم المجلد الذي توجد فيه تماماً. وعندما يختلفان، لا تظهر رسالة خطأ؛ ببساطة لا تظهر المهارة.

لماذا اختفت؟

تنزّل launch-page ثم تعيد تسمية المجلد إلى landing لتنظيمه، فتختفي المهارة من Cursor. لم يعد اسم المجلد وname متطابقين. أعد اسم المجلد الأصلي، أو غيّر name إلى landing.

اسم يقبله Cursor

  • أحرف صغيرة وأرقام وشرطات فقط
  • مطابق لاسم المجلد الذي يحتوي SKILL.md
  • مصحوب بـdescription

كيفية تشغيل مهارة في Cursor

في المحادثة، اكتب / واسم المهارة ثم طلبك:

محادثة 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. 1احتفظ بالمهارة في ~/.cursor/skills/. تظل مهارات المشروع و~/.agents/skills/ على جهازك.
  2. 2افتح Settings → Agents → Context and Tools وفعّل Sync Skills for Cloud Agents.
  3. 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.

المصادر

هل ساعدك هذا الدليل؟