تحتاج فرق API إلى توثيق دقيق يشرح نقاط النهاية والمخططات والمصادقة والأخطاء. تحوّل هذه المهارة تفاصيل API إلى مراجع وأدلة منظّمة.

تحتاج الفرق إلى متطلبات واضحة قبل إسناد العمل إلى وكلاء برمجة الذكاء الاصطناعي. تحول هذه المهارة أفكار الميزات إلى مستندات PRD منظمة تتضمن قصص مستخدمين وبوابات جودة لسير عمل ralph-tui.

Complex systems are difficult to explain consistently. This skill creates structured Mermaid diagrams and design documents from requirements, source code, and configuration.

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

قد يكون الدخول إلى مستودعات SpecDD صعبًا دون معرفة نموذج bootstrap والسلطة النشط. ترشد هذه المهارة Claude وCodex وClaude Code خلال جولة توجّه للقراءة فقط قبل العمل اللاحق.

قد يصعب تفسير مشاريع SpecDD عندما تكون القواعد موزعة بين ملفات bootstrap والمواصفات. تشرح هذه المهارة العقد النشط بلغة واضحة دون تعديل الملفات.

تحتاج المشاريع القائمة على المواصفات إلى توثيق يطابق العقود الحالية. ترشد هذه المهارة Claude وCodex وClaude Code إلى تحديث الوثائق انطلاقا من مواصفات SpecDD النشطة.

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

تهدر العديد من حزم المهارات السياق بإرشادات عامة ونصوص تفعيل ضعيفة. يوفر Skill Judge إطار تسجيل لمراجعات SKILL.md مع تحسينات قائمة على الأدلة.

غالبًا ما تحتاج الفرق إلى مخططات واضحة تبقى قريبة من الكود والتوثيق. توجّه هذه المهارة Claude وCodex وClaude Code عبر صياغة Mermaid لإنشاء نماذج مرئية قابلة للصيانة.

غالبا ما تحتاج مسودات العروض التقديمية إلى بنية، وخيارات سمات، وصياغة خاصة بـ Marp. تحول هذه المهارة الموضوعات أو الملاحظات الأولية إلى عروض Marp منسقة بسمات قابلة لإعادة الاستخدام.

غالبًا ما تفوّت ملفات README العامة احتياجات المساهمين أو زملاء الفريق أو القائمين على الصيانة مستقبلًا. ترشد هذه المهارة Claude وCodex وClaude Code من خلال أسئلة حول الجمهور وقوالب وفحوصات جودة.

غالبًا ما تصبح وثائق المعمارية غير واضحة أو مفصلة أكثر من اللازم لجمهورها. تنشئ هذه المهارة مخططات C4 Mermaid مركزة لسياق النظام، والحاويات، والمكونات، وعمليات النشر، والتدفقات.

ملفات تعليمات الوكيل الكبيرة تهدر السياق وتخفي القواعد المهمة. تقسم هذه المهارة هذه الملفات إلى ملف جذر موجز ووثائق مرتبطة مركزة.

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

Decision records become stale when identifiers, links, and lifecycle states drift. This skill manages drafts, promotions, indexes, validation, and cross-references.

غالبًا ما تفشل مهام التطوير المعقدة عندما تبدأ الفرق البرمجة دون خطة مشتركة. تحوّل هذه المهارة المتطلبات إلى خطط تنفيذ قائمة على الاختبارات لكل من Claude وCodex وClaude Code.

يصعب تصفح صفحات الويكي المُولَّدة عندما تكون ملفات Markdown منفصلة. تحزم هذه المهارة هذه الصفحات في موقع VitePress داكن مع دعم لمخططات Mermaid.

غالبا ما تتطلب أسئلة المستودعات البحث في العديد من الملفات قبل أن تتضح الإجابة. ترشد هذه المهارة Claude وCodex وClaude Code إلى الإجابة بالاعتماد على أدلة من المصدر مع استشهادات مضمنة.

غالبا ما تبتعد الوثائق التقنية عن تفاصيل التنفيذ. ترشد هذه المهارة Claude وCodex وClaude Code إلى كتابة صفحات wiki موثقة بالاستشهادات مع مخططات.