تحويل مستند إلى SKILL.md

ما الذي يكتبه المحوّل

المهارة مجلد فيه ملف واحد إلزامي هو SKILL.md. يبدأ الملف بكتلة قصيرة من YAML (المقدمة أو frontmatter)، ثم تأتي تعليماتك بتنسيق Markdown. ويشترط تنسيق Agent Skills المفتوح حقلين في هذه الكتلة:

• name: من 1 إلى 64 حرفًا، أحرف إنجليزية صغيرة وأرقام وشرطات، لا يبدأ بشرطة ولا ينتهي بها، ولا شرطتان متتاليتان. ويجب أن يطابق اسم المجلد.
• description: من 1 إلى 1,024 حرفًا عن ما تفعله المهارة ومتى تُستخدم.

يبني المحوّل الاسم من أول عنوان في مستندك، ويصوغ وصفًا أوليًا من الجملة الأولى، وينظّف التعدادات، ويضيف عنوانًا إن لم يكن في المستند عنوان. عدّل أيًّا من الحقلين، فيتحدّث الملف أثناء الكتابة. وتضيف قواعد Anthropic نفسها شرطين: لا يجوز أن يحتوي الاسم على «anthropic» أو «claude»، ولا أن يحتوي أي من الحقلين على وسوم XML. ويتحقق المحوّل من الشرطين.

أين تضع الملف

• Claude (الويب وتطبيق سطح المكتب): انتقل إلى Customize > Skills، وانقر على +، ثم Create skill > Upload a skill، واختر ملف ‎.zip. يحتوي على المجلد وبداخله SKILL.md، وهو الشكل الذي يطلبه Claude. ويجب أن يكون تنفيذ الكود (Code execution) مفعّلًا.
• Claude Code: فك الضغط في ~/.claude/skills/ لنفسك، أو في .claude/skills/ داخل مستودع لكل من ينسخه.
• Codex وCursor وOpenCode: يقرأ كل منها مجلدات المهارات من مكانه الخاص؛ ويذكرها دليل المزامنة.

كل نسخة تضعها يدويًا نسخة يجب على أحدهم تحديثها يدويًا. وهذه هي المهمة التي يتولاها AI Skill Pod.

اكتب وصفًا تعمل به أداة الذكاء الاصطناعي

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

• ابدأ بما تفعله: «تصوغ ردود استرداد المبلغ بأسلوب الدعم لدينا.»
• ثم اذكر متى: «استخدمها عندما يطلب عميل استرداد المبلغ أو الإرجاع أو استرجاع المبلغ من البطاقة (chargeback).»
• اذكر الكلمات التي يكتبها الناس: أسماء المنتجات، وأنواع الملفات، ومصطلحات الفريق الخاصة.