writing-skills
اكتب مهارات وكيل ذكي عالية الجودة
متاح أيضًا من: ZhanlinCui,Cygnusfear,Dimon94,DYAI2025,obra,davila7,CodingCossack,Cycleaddict
توفر هذه المهارة قوالب وأشجار قرار وأفضل الممارسات لإنشاء وتحسين مهارات الوكلاء الذكيين. تساعد المستخدمين على تجنب الأخطاء الشائعة واتباع أنماط موحدة.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "writing-skills". أريد إنشاء مهارة للتعامل مع أخطاء API
النتيجة المتوقعة:
ملف SKILL.md كامل يحتوي على: name: api-error-handler, description: 'Use when API request fails or returns error status', metadata مع triggers: api-error, network-failure, 503، مع مجلد references/ لإجراءات التعامل التفصيلية
استخدام "writing-skills". وصف مهارتي هو 'هذه المهارة تساعد في عمليات الملفات' - لا يتم التفعيل
النتيجة المتوقعة:
وصف محسّن: 'Use when user asks to read, write, or modify files. Triggers on: file-create, file-edit, file-delete, touch, mkdir, rm command'
التدقيق الأمني
آمنThis is a documentation and reference skill providing guidance on writing AI agent skills. All static findings are false positives - the scanner detected patterns in markdown documentation (code formatting with backticks, mentions of cryptographic terms, URLs in documentation) rather than actual executable code. The render-graphs.js is a build script for documentation generation, not runtime functionality.
درجة الجودة
ماذا يمكنك بناءه
إنشاء مهارة جديدة
استخدم شجرة القرار لاختيار مستوى البنية المناسب والقالب لمهارة جديدة، ثم اتبع هيكل القالب.
تحسين المهارات الموجودة
شخّص سبب عدم تفعيل المهارة أو تجاهلها من قبل الوكلاء، ثم طبق تقنيات مكافحة التسويغ أو CSO.
توحيد مهارات الفريق
تأكد من أن جميع مهارات الفريق تتبع اتفاقيات تسمية متسقة ومعايير بيانات وصفية وهياكل أدلة.
جرّب هذه الموجهات
أحتاج إلى إنشاء مهارة جديدة تسمى [skill-name]. يجب أن [what it does]. استخدم القالب Tier 1 من مرجع writing-skills.
مهارة [skill-name] الخاصة بي لا يتم تفعيلها بواسطة Claude. الوصف هو: [description]. طبق تحسين CSO من writing-skills.
لدي مهارة تخصصية تحتوي على قواعد يتجاهلها Claude باستمرار. القواعد هي: [rules]. طبق تقنيات مكافحة التسويغ.
أحتاج إلى إنشاء مهارة معقدة تحتوي على مفاهيم متعددة (200-1000 سطر). استخدم بنية Tier 2 الموسعة مع مراجع مناسبة.
أفضل الممارسات
- ابدأ دائماً الأوصاف بـ 'Use when...' متبوعة بشروط التفعيل المحددة
- تضمين 3 كلمات مفتاحية على الأقل في metadata.triggers لتحسين الاكتشاف
- حافظ على المهارات ذات الملف الواحد تحت 200 سطر؛ استخدم references/ للمحتوى الأطول
- قسّم المهارات الأحادية الكبيرة إلى ملفات متعددة باستخدام نظام المستويات
تجنب
- وصف سير العمل بدلاً من محفزات التفعيل (مثلاً 'هذه المهارة تساعدك في إنشاء الملفات' بدلاً من 'Use when user wants to create a file')
- استخدام أسماء مهارات عامة مثل 'helper' أو 'utility' بدلاً من الأسماء الوصفية
- عدم تضمين حقل metadata.triggers أو وجود أقل من 3 كلمات مفتاحية للتفعيل
- إنشاء ملفات SKILL.md أحادية طويلة بدلاً من references/ المعيارية