build-explanations

What problem does it solve?

This skill helps educators and documentation writers structure explanations so that concepts are understood across different audiences and contexts.

Core Features & Use Cases

• Diataxis-aligned content: classify material into Tutorial, How-to, Explanation, and Reference and tailor depth accordingly.
• Cognitive-load-aware design: apply principles to reduce extraneous load and promote germane learning.
• Audience-aware translation: craft content for learners, practitioners, evaluators, and decision-makers; include layered depth and clear signaling.
• Reference-backed documentation: link to a central references repository (Mermaid, D2, C4) for diagrams and evidence.
• Use Case: create a README doc that teaches a concept to a novice with a quick reference section for experts.

Quick Start

Start by selecting an audience type (e.g., Learner) and structure content as Tutorial → Explanation → Reference with links to the references.