skills.rest
brandonburrus
brandonburrusCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

writing-educative

Generate educational technical content for readers with no prior knowledge.

1|Updated May 7, 2022
Search Tags:#education#writing#onboarding#technical documentation#explanation#tutorial
One-click install
npx skills add https://github.com/brandonburrus/dotfiles --skill writing-educative
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-educative
Source: https://github.com/brandonburrus/dotfiles/tree/main/.config/opencode/skills/writing-educative
Command: npx skills add https://github.com/brandonburrus/dotfiles --skill writing-educative

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the challenge of explaining complex technical subjects to an audience with no prior knowledge, ensuring genuine understanding through a structured, pedagogical approach.

Core Features & Use Cases

  • Progressive Disclosure: Introduces concepts incrementally, building upon a foundational mental model.
  • Analogy-First Explanations: Uses relatable analogies to build intuition before diving into technical details.
  • Worked Examples: Provides concrete, narrated examples that demonstrate concepts in practice.
  • Misconception Defusal: Proactively identifies and addresses common misunderstandings.
  • Use Case: Creating onboarding documentation for a new software library, explaining a complex algorithm, or writing a tutorial for a new programming concept.

Quick Start

Use the writing-educative skill to explain the concept of 'asynchronous programming' to a beginner.

Frequently Asked Questions about writing-educative

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

FAQPage Schema
How do I write technical documentation for beginners with no prior knowledge?▼

Technical documentation for beginners is generated using a structured pedagogical approach that introduces concepts incrementally through progressive disclosure, building a foundational mental model before diving into complex details.

What is the best way to explain a complex algorithm in a tutorial?▼

The best way to explain a complex algorithm in a tutorial is through analogy-first explanations that build intuition, paired with narrated worked examples to demonstrate the concepts in practice.

How do I create onboarding documents that teach a new software library effectively?▼

Onboarding documents for a new software library are created by proactively identifying and defusing common misconceptions while guiding readers through API walkthroughs with no assumed prior knowledge of the subject matter.

Does progressive disclosure work for programming concept explainers?▼

Progressive disclosure works effectively for programming concept explainers by introducing technical ideas incrementally, ensuring readers build genuine understanding through a structured, layered learning progression.

Why do my technical explanations fail to build genuine understanding for new users?▼

Technical explanations often fail to build genuine understanding when they lack relatable analogies and concrete worked examples, which are required to bridge the gap between abstract concepts and practical application.

Related Skills

Explore More Education & Research Skills→
Imad-OuteImad-Oute
2

mh-mgi-knowledge-curator

Convert MD, PDF, and text sources into indexed mental models via a 4-step workflow.

Community
Advanced
slantviewslantview
1

tutorial-engineer

Generate step-by-step tutorials and educational content from code.

Community
Intermediate
JayRHaJayRHa
3

concept-explainer

Generate layered explanations with analogies and examples for complex concepts.

Community
Intermediate
xiaoweidotnetxiaoweidotnet
22

explainer-narrative-flow

Generate beginner-friendly educational content using a three-act narrative structure.

Community
Intermediate