مولّد مهارات Claude (Skill)
صف بلغة بسيطة مهمة تكررها باستمرار، واحصل على ملف SKILL.md كامل يمكنك وضعه مباشرة في Claude Code، مع التحقق المباشر من الاسم والوصف مقابل القيود الحقيقية لـ Agent Skills أثناء الكتابة. يكتب المولّد الوصف بصيغة «ماذا تفعل ومتى تُستخدم»، لأن هذا الحقل هو الشيء الوحيد الذي يقرأه Claude لتحديد ما إذا كانت مهارتك تنطبق على طلب ما. كما يُنبّهك مباشرةً عندما يبدو أن المسودة تغطي أكثر من مهمة غير مرتبطة، لأن المهارة ذات النطاق الضيق تعمل بشكل أكثر موثوقية بكثير من المهارة الواسعة.
1. صف المهمة التي تكررها
اللغة البسيطة مقبولة تمامًا. كلما كان سير العمل أكثر تحديدًا، كانت المهارة المُنشأة أدق.
أو ابدأ من أحد هذه
سيظهر ملف SKILL.md الخاص بك هنا، قابلاً للتعديل بالكامل، مع التحقق من الاسم والوصف مقابل قيود Anthropic الحقيقية أثناء الكتابة.
ما الذي يوجد فعليًا داخل ملف SKILL.md
الـ skill هو مجرد مجلد يحتوي على SKILL.md بداخله: YAML frontmatter في الأعلى، وتعليمات Markdown أسفله. حقلان فقط من الـ frontmatter مطلوبان، ولكل منهما قواعد صارمة تفرضها هذه الأداة أشناء الكتابة. name محدود بـ 64 حرفًا، ويسمح فقط بالحروف الصفيرة والأرقام والشرطات، ولا يمكن أن يحتوي على الكلمتين المحجوزتين "claude" أو "anthropic". يجب ألا يكون description فارنًا وأن يكون أقل من 1024 حرفًا - وهو الحقل الوحيد الذي يستحق التفكير الجيد، لأنه النص الذي يقرأه Claude ليقرر ما إذا كان skill الخاص بك ذا صلة بالطلب من الأساس.
لهذا كل وصف جيد يسمّي أمرين: ماذا يفعل الـ skill ومتى يجب أن يُفعّل. عبارة "يراجع ملخّص طلب سحب" بمفردها لا تمنح Claude شيئًا يطابقه. أما "يراجع ملخّص طلب سحب ويشير إلى التعديلات الخطرة. استخدمه عندما يطلب المستخدم مراجعة طلب سحب أو فحص ملخّص التعديلات قبل الدمج" فتخبره بدقة بأي الطلبات تخص هذا الـ skill. يكتب المُولّد الأوصاف بهذا الشكل، ويُشير إلى وصفك إذا كان نصف جزء التفعيل ناقصًا.
أسفل الـ frontmatter يوجد Markdown عادي - نظرة عامة قصيرة، وقائمة خطوات تحت ## Instructions، وأمثلة حيث تسندها موضع. يمكن للـ skills الأكبر أيضًا الإشارة إلى ملفات إضافية مجمّعة بجانب SKILL.md (ملف REFERENCE.md، أو مجلد scripts/ يشِّله Claude عبر bash) بحيث لا يُستدعى التفصيل الثقيل إلا عند الحاجة الفعلية إليه.
الأسئلة الشائعة
ما هي مهارة Claude بالضبط؟
المهارة هي معرفة إجرائية تُسلّمها لـ Claude مرة واحدة لإعادة استخدامها للأبد: مجلد يحتوي على ملف SKILL.md، مكوَّن من ترويسة YAML (اسم ووصف) بالإضافة إلى نص تعليمات بصيغة markdown. عندما يتطابق طلب ما مع الوصف، يحمّل Claude تلك التعليمات ويتبعها. إنه الفرق بين إعادة كتابة نفس التوجيه المكوّن من ثلاث فقرات كل أسبوع وبين مجرد كتابة أمر شرطة مائلة. يمكن للمهارة أيضًا الإشارة إلى ملفات إضافية بجانبها - FORMS.md أو REFERENCE.md أو سكربتات ضمن مجلد scripts/ يشغّلها Claude عبر bash، حيث يدخل فقط الناتج إلى المحادثة، وليس كود السكربت.
كيف أكتب وصف مهارة Claude يعمل فعليًا؟
اذكر ما تفعله المهارة ومتى يجب على Claude استخدامها، بهذا الترتيب، بلغة بسيطة بصيغة الغائب. الوصف هو الشيء الوحيد الذي يقارنه Claude بطلب المستخدم لتحديد ما إذا كان سيشغّل مهارتك، لذا فإن الوصف الغامض يعني أن المهارة ستبقى دون استخدام. اذكر المحفّزات المحددة التي تتوقعها - «استخدمها عندما يطلب المستخدم مراجعة طلب سحب (PR)، أو فحص فرق (diff)، أو يسأل عمّا يبدو خطيرًا في هذه التغييرات» - وابقَ ضمن حد 1024 حرفًا. يصيغ مولّد SKILL.md هذا الوصفَ بهذا الشكل (ماذا + متى) وينبّهك مباشرة إذا أزال تعديل ما جزء المحفّز.
هل المهارة هي نفسها أمر الشرطة المائلة المخصص؟
إنهما متداخلان. وحّد Claude Code بينهما: يمنحك ملف الأمر والمهارة كلاهما نفس السلوك /<الاسم> ويقبلان نفس الترويسة، ويدعمان كلاهما نظام العناصر النائبة $ARGUMENTS. الفرق بنيوي - المهارة هي مجلد، لذا يمكنها حمل ملفات مساعدة وسكربتات ومراجع كشف تدريجي، ولها حقل name خاص بها (يتجاهل ملف الأمر name وpaths، لأن اسم ملفه هو اسم الأمر). الأمر هو ملف markdown واحد، أسرع في الكتابة عندما تكون المهمة تعليمة قصيرة واحدة. الجأ إلى مولّد مهارات Claude Code المخصص هذا عندما يحتوي سير العمل على خطوات حقيقية، ومولّد أوامر الشرطة المائلة عندما لا يحتوي عليها.
هل يجب عليّ حقًا تقسيم مهارة كبيرة إلى عدة مهارات أصغر؟
في معظم الحالات، نعم - هذا هو الخطأ الأكثر شيوعًا في الواقع العملي مع Agent Skills. المهارة التي تحاول تغطية عدة مسؤوليات غير مرتبطة (مثل التعامل مع الالتزامات (commits)، وكتابة أوصاف طلبات السحب، وتحديث سجل التغييرات، كلها في واحدة) تعمل بشكل غير موثوق، لأن وصفها يجب أن يغطي المهام الثلاث بشكل غامض في آن واحد، ولا يستطيع Claude تحديد أي جزء ينطبق على طلب معيّن. وجدت مراجعة معروفة لـ 47 مهارة مجتمعية شائعة أن أربعين منها جعلت فعليًا نتائج Claude أسوأ من عدم استخدام أي مهارة على الإطلاق، ويعود ذلك بشكل كبير لهذا السبب. يُنبّه هذا المولّد مباشرة عندما تبدو المسودة وكأنها تغطي أكثر من مهمة واحدة، ويوصي بالتقسيم.
تبني شيئًا قصيرًا من سطر واحد بدلاً من ذلك؟ يكتب AI Slash Command Generator نسخة الملف الواحد - نفس /command، ببناء تحتي أقل.