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

Claude Skills لا تعمل؟ عالج المشكلة حسب أعراضها

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

مناسب لـ
كل من لا تعمل مهارته
يشمل
Claude Code, Codex, Cursor, Skillry CLI
الوقت
5–10 دقائق

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

  1. 1استدعها باسمها: /skill-name أو$skill-name. إذا اشتغلت، فالتثبيت سليم.
  2. 2لم يعثر عليها؟ تحقق من المجلد. يجب أن يكون SKILL.md مباشرة داخل <skills folder>/<name>/.
  3. 3ما زلت عالقًا؟ ابحث أدناه عما تواجهه.

اعثر على المشكلة في 30 ثانية

طابق ما تواجهه مع العمود الأول، ثم انتقل إلى الحل في العمود المقابل.

يفشل استدعاؤها باسمها

ليست في مكان يبحث فيه الوكيل. راجع المهارة لا تظهر.

تعمل باسمها لكن لا تعمل عند طلب عادي

تحقق من الوصف أوالإعدادات. راجع المهارة لا تتفعّل.

تعمل مهارة أخرى

يوجد تداخل بين وصفين. راجع تعمل مهارة غير مقصودة.

تبدأ ثم تتوقف

إحدى التبعيات مفقودة. راجع تفشل أثناء التنفيذ.

تشغّل الإصدار القديم

توجد نسخة ثانية، أوالجلسة لم تتحدث. راجع إصدار قديم.

المهارة لا تظهر في Claude Code أوCodex أوCursor

إذا لم تظهر المهارة في /skills أوCustomize → Skills، فالوكيل لم يحمّلها. غالبًا يكون المجلد في المكان الخطأ أو أعمق بمستوى واحد من المطلوب.

السبب المحتملالحل
ثبّتها لـClaude Code باستخدام Skillry CLI لكنك لم تضف --agent claude-codeأعد التثبيت مع هذا الخيار. من دونه، تستخدم CLI المسار ~/.agents/skills/
أضاف ZIP مستوى إضافيًا للمجلدانقل المجلد الداخلي مستوى واحدًا إلى أعلى. يحتاج Claude Code إلى المسار skills/<name>/SKILL.md بالضبط
خطأ في الترويسة بين سطرَي ---صحّحه. يحتاج Codex وCursor إلى name وdescription، ويجب في Cursor أن يطابق name اسم المجلد
لم يكتشفها الوكيل بعدClaude Code: شغّل /reload-skills. Codex: أعد تشغيله داخل المستودع. Cursor: افتح محادثة جديدة أوأعد تحميل النافذة
Codex في تطبيق ChatGPT لسطح المكتب: لا يعثر $ على شيءمشكلة مُبلّغ عنها (openai/codex#28505). تحقق من /skills، أوأعد التشغيل، أوجرّب وضع نسخة في ~/.codex/skills/ (لم نختبر ذلك بعد)

لمعرفة كل المجلدات التي يقرؤها كل وكيل، راجع مواقع المهارات.

المهارة تظهر لكنها لا تتفعّل تلقائيًا

يقرر الوكيل استخدام المهارة بقراءة وصفها. إذا لم تعمل إلا عند استدعائها باسمها، فإما أن وصفها لا يطابق طريقة طلبك، أوأن أحد الإعدادات يمنعها.

  • جرّب التعليمة النموذجية في صفحة المهارة. فقد كُتبت لتطابق الوصف.
  • راجع paths. فهو يقصر الاستخدام التلقائي على الملفات المطابقة.
  • هل ثبّتَّ مهارات كثيرة؟ يختصر الوكيل الأوصاف أويحذف بعضها ليستوعبها جميعًا، لذا ضع الاستخدام الأساسي أولًا. راجع التفعيل.

تعمل مهارة مختلفة بدلًا منها

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

ما الذي يحدث؟الحل
تُختار مهارة مشابهة باستمراراستدعِ المهارة التي تريدها باسمها: /skill-name في Claude Code وCursor، و$skill-name في Codex. الاستدعاء بالاسم يشغّل تلك المهارة دائمًا.
أوصاف مهاراتك متداخلةضيّق نطاق كل وصف بحسب المدخلات أوالجمهور أوالمخرجات حتى تختص كل مهارة بمهمة واحدة. راجع التفعيل.
الاسم نفسه مثبت مرتينيقدّم Claude Code نسخة المؤسسة، ثم الشخصية، ثم نسخة المشروع. وقد يعرض Codex النسختين. احتفظ بنسخة واحدة.
تبدأ مهارة باستمرار دون أن تطلبهااجعل وصفها أكثر تحديدًا لموعد استخدامها، حتى لا يطابق طلبات غير مرتبطة. ثم استدعِ المهارة المطلوبة باسمها. راجع التفعيل.

تبدأ ثم تفشل أثناء التنفيذ

غالبًا ما تكون إحدى التبعيات مفقودة: إصدار Node.js غير مناسب، أوغياب Python أوFFmpeg أومفتاح FAL. توضح صفحة المهارة متطلباتها، لذا راجعها أولًا:

Requirements panel on a Skill page, listing You bring, Dependencies, Outside costs and Last tested
تحتاج هذه المهارة إلى مفتاح FAL وNode.js 20+، وكل عملية توليد هي مهمة FAL مدفوعة.

تستمر في تشغيل الإصدار القديم

حدّثت المهارة لكن الوكيل لا يزال يعمل بالطريقة القديمة. أحد الأسباب التالية هو المسؤول:

  • استُبدل SKILL.md وحده. أعد التثبيت باستخدام --force، أواستبدل المجلد كاملًا.
  • توجد نسخة أخرى بالاسم نفسه في مكان آخر. أزلها.
  • في Claude Code، تبقى المهارة التي شُغّلت سابقًا على حالها لبقية المحادثة. ابدأ محادثة جديدة لالتقاط تعديلاتك.

للنسخ الاحتياطي والعودة إلى إصدار سابق، راجع الإدارة والتحديث.

تعمل على جهازك ولا تعمل في السحابة

تعمل الجلسات السحابية على جهاز آخر، لذا لا تنتقل إليها المهارة الموجودة على جهازك وحده إلا إذا أعددتها لذلك:

الوكيلالحل
Claude Codeالجلسات السحابية: أضفها إلى Git في .claude/skills/، أوفعّلها في claude.ai. وفي Cowork: فعّلها في claude.ai.
Codexلا تصل المهارات المستقلة إلى ChatGPT على الويب أوالهاتف. وزّعها ضمن إضافة.
Cursorضعها في ~/.cursor/skills/، ثم فعّل Settings → Agents → Context and Tools → Sync Skills for Cloud Agents.

رسائل أخطاء Skillry CLI

اعثر على الرسالة التي طبعتها Skillry CLI، ثم اتبع الإجراء في العمود المقابل.

الرسالة التي تراهاالإجراء المطلوب
“Not logged in.” أو“Session expired.” — لم تسجّل الدخول أو انتهت الجلسةشغّل npx --yes skillry-cli@latest login
“…already exists. Re-run with --force to replace it safely.” — النسخة موجودة؛ أعد التشغيل مع --force لاستبدالها بأمانأضف --force. تُنشأ نسخة احتياطية من نسختك القديمة
“This Skill requires a paid plan.” — تتطلب هذه المهارة خطة مدفوعةتحقق من سعر المهارة أوخطتك
“--agent and --target cannot be used together.” — لا يمكن الجمع بين الخياريناختر أحد الخيارين
“Secure session storage is currently supported on macOS and Windows only.” — تخزين الجلسة الآمن مدعوم حاليًا على macOS وWindows فقطإصدار CLI لديك أقدم من 0.2.2. شغّلها باستخدام npx --yes skillry-cli@latest للحصول على الإصدار الذي يعمل على Linux
“Refusing to use … because other users can access it.” — رُفض استخدام الملف لأن مستخدمين آخرين يستطيعون الوصول إليهعلى Linux، أصبحت أذونات ملف الجلسة تسمح لمستخدمين آخرين بالوصول إليه. احذف الملف المذكور، ثم سجّل الدخول مجددًا

أسئلة شائعة

لماذا لا تُحمَّل مهارتي في Claude Code؟

غالبًا ما تكون في ~/.agents/skills/ بدلًا من ~/.claude/skills/، أويوجد مستوى إضافي للمجلد. صحّح المسار، ثم شغّل /reload-skills إذا كان المجلد جديدًا.

لماذا تطلب مهارتي مفتاح API؟

لأنها تستخدم خدمة مدفوعة مذكورة تحت «التكاليف الخارجية» في صفحة المهارة. اضبط المفتاح بالطريقة التي تحددها تلك الخدمة، ولا تلصقه في المحادثة أبدًا.

كيف أعرف أن التثبيت نجح؟

تظهر في /skills (أوCustomize → Skills في Cursor)، وتعمل عند استدعائها باسمها.

المصادر

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