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

لماذا لا تتفعّل مهارتك، وكيف تصلح ذلك؟

يختار الوكلاء المهارة بقراءة وصفها، وغالبًا ما يختصرون الوصف لتوفير المساحة. إليك كيف يختار Claude Code وCodex وCursor، وكيف تكتب وصفًا يُختار.

مناسب لـ
مستخدمي المهارات ومؤلفيها
يعمل مع
Claude Code, Codex, Cursor
الوقت
7 دقائق

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

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

كيف يختار كل وكيل مهارة

يقرأ كل وكيل أولًا قائمة بأسماء المهارات وأوصافها، ولا يحمّل التعليمات الكاملة إلا بعد اختيار مهارة. تأتي القائمة من ترويسة كل SKILL.md (الملف الذي يبحث عنه كثيرون باسم skills.md)، ولها مساحة محدودة:

الوكيلما يقرؤه أولًاعند نفاد المساحة
Claude Codeالاسم والوصف، ومعهما when_to_use إن ضُبط؛ حتى 1,536 محرفًا لكل منهاتُخصص للقائمة نحو 1% من نافذة السياق؛ وتسقط أوصاف المهارات الأقل استخدامًا أولًا
Codexالاسم والوصف ومسار الملفتُخصص للقائمة نحو 2% من نافذة السياق؛ وتُختصر الأوصاف أولًا
Cursorالاسم والوصفغير موثّق

عند تثبيت مهارات كثيرة، قد يُختصر وصف طويل أو غامض أو يُحذف قبل أن يفاضل الوكيل فيه. لهذا تكون الجملة الأولى الأهم.

اكتب وصفًا للمهارة يجعل الوكيل يختارها

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

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

يُختار

ما ينتجه ومتى

  • «أنشئ صفحة إطلاق منتج تضم قسمًا افتتاحيًا وشبكة مزايا ومفتاح تبديل للأسعار. استخدمها عند طلب صفحة هبوط أو إطلاق.»
يضيع بين الأوصاف

عام

  • «يساعد في المواقع.»
  • ينافس كل مهارات الويب الأخرى، ولا يبقى فيه معنى تقريبًا بعد اختصاره.

كيف تختبر التفعيل؟

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

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

عندما تعمل مهارة غير مقصودة

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

  • استدعِ المهارة المطلوبة باسمها. الاستدعاء بالاسم له الأولوية دائمًا.
  • ضيّق الأوصاف المتداخلة بحسب المدخلات أو الجمهور أو المخرجات، حتى يكون لكل مهارة عمل واضح.
  • الاسم نفسه في مكانين: يقدّم Claude Code نسخة المؤسسة، ثم الشخصية، ثم نسخة المشروع. وقد يعرض Codex النسختين. احتفظ بنسخة واحدة.

أسئلة شائعة

لماذا لا تتفعّل مهارتي في Claude؟

استدعها باسمها أولًا. إذا فشل ذلك، فهي ليست مثبتة حيث يبحث الوكيل؛ أما إذا فشلت الطلبات العادية وحدها، فأعد كتابة الوصف باستخدام الكلمات التي تكتبها فعلًا.

كيف يقرر Claude أي مهارة يستخدم؟

يقرأ اسم كل مهارة ووصفها، ثم يحمّل الأنسب لطلبك. تتجاوز كتابة /skill-name هذه المطابقة وتشغّل المهارة التي سميتها.

ماذا يجب أن يقول وصف المهارة؟

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

هل اسم الملف SKILL.md أم skills.md؟

اسمه SKILL.md، ويوجد واحد في كل مجلد مهارة. تضم ترويسته الاسم والوصف اللذين يقرؤهما الوكلاء عند اختيار المهارة.

المصادر

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