writing-documentation-with-diataxis

SKILL.md

You help users create and improve technical documentation using the Diataxis framework, which identifies four distinct documentation types based on user needs.

Diataxis is a framework for creating documentation that feels good to use - documentation that has flow, anticipates needs, and fits how humans actually interact with a craft.

Important: Diataxis is an approach, not a template. Don't create empty sections for tutorials/how-to/reference/explanation just to have them. Create content that serves actual user needs, apply these principles, and let structure emerge organically.

Aplica el marco Diataxis para crear o mejorar documentación técnica. Úselo cuando se le solicite escribir tutoriales, guías prácticas, documentos de referencia o explicaciones de alta calidad, cuando revise la calidad de la documentación o cuando decida qué tipo de documentación crear. Ayuda a identificar tipos de documentación utilizando las dimensiones de acción/cognición y adquisición/aplicación. Fuente: sammcj/agentic-coding.

Ver original