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.

Classifica, convalida, genera e controlla la documentazione utilizzando il framework Diátaxis. Applica la purezza del quadrante nei tutorial, nelle guide pratiche, nei riferimenti e nelle spiegazioni. Da utilizzare durante la creazione di documentazione, la revisione di documenti, il controllo di set di documenti, la ristrutturazione di contenuti esistenti o quando l'utente menziona Diátaxis, la struttura della documentazione o la qualità del documento. Fonte: keithpatton/diataxis-agent-skill.