skills.rest
yzavyas
yzavyasCOMMUNITY
Explore all skills by this author →
GitHub

build-explanations

Structure educational content into Diataxis-aligned Tutorial, How-to, Explanation, and Reference layers.

7|3|Updated Dec 1, 2025
Search Tags:#documentation#diataxis#explain#cognitive-load#teach#reader-psychology
One-click install
npx skills add https://github.com/yzavyas/claude-1337 --skill build-explanations
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: build-explanations
Source: https://github.com/yzavyas/claude-1337/tree/main/plugins/sensei-1337/skills/build-explanations
Command: npx skills add https://github.com/yzavyas/claude-1337 --skill build-explanations

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

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.

Frequently Asked Questions about build-explanations

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure documentation to teach concepts across different audiences?▼

To structure documentation across audiences, align content with the Diataxis framework, categorizing material into Tutorial, How-to, Explanation, and Reference sections with tailored depth for each user type.

What is cognitive-load-aware design and how does it apply to technical writing?▼

Cognitive-load-aware design in technical writing applies principles that reduce extraneous mental effort and promote germane learning, helping readers absorb concepts without unnecessary complexity.

How do I create a README that teaches novices while providing a quick reference for experts?▼

Create a README for mixed audiences by structuring content sequentially as Tutorial, Explanation, and Reference, linking to a central references repository for diagrams and evidence.

Does Diataxis documentation require external tooling or dependencies to implement?▼

Diataxis documentation does not require mandatory external tooling, relying instead on integration with a provided references repository for evidence and supporting diagrams.

What is the best way to classify technical material into Tutorial, How-to, Explanation, and Reference formats?▼

The best way to classify technical material is using the Diataxis framework, which separates content by purpose into Tutorial, How-to, Explanation, and Reference, tailoring depth to specific learning needs.

Related Skills

Explore More Education & Research Skills→
pluginagentmarketplacepluginagentmarketplace
3

user-guides

Generate user guides, tutorials, and FAQs with validation and readability scoring.

Community
Advanced
OKHP3OKHP3
2

okhp3-mermaid-publish

Render Mermaid diagrams to PNG/SVG files and publish shareable links via Mermaid Chart MCP.

Community
Intermediate
tmcfarlanetmcfarlane
105

documentation-writing

Create software documentation following the Eight Rules and Diataxis framework.

Community
Advanced
stephanjstephanj
9

crafting-effective-readmes

Generate audience-aware README templates with section checklists and style guides.

Community
Intermediate