diataxis

This skill enforces the Diátaxis framework for documentation. Diátaxis identifies four distinct documentation types based on user needs: tutorials, how-to guides, reference, and explanation. Each serves a different purpose and must be written differently.

The mode must be inferred from the user request or explicitly stated. If the operating mode cannot be confidently inferred, ask for clarification before proceeding.

Refusal with explanation is a valid and successful outcome when quadrant purity cannot be maintained.

تصنيف الوثائق والتحقق من صحتها وإنشاءها ومراجعتها باستخدام إطار عمل Diátaxis. يفرض نقاء الربع عبر البرامج التعليمية والأدلة الإرشادية والمراجع والشرح. يُستخدم عند إنشاء الوثائق، أو مراجعة المستندات، أو تدقيق مجموعات المستندات، أو إعادة هيكلة المحتوى الموجود، أو عندما يذكر المستخدم Diátaxis، أو بنية التوثيق، أو جودة المستند. المصدر: keithpatton/diataxis-agent-skill.