docs-creating-by-example-tutorialslisted

# By-Example Tutorial Creation Skill ## Purpose This Skill provides comprehensive guidance for creating **by-example tutorials** - a code-first learning path designed for experienced developers who want rapid language pickup through heavily annotated working code examples. **When to use this Skill:** - Creating by-example tutorials for programming languages - Writing heavily annotated code examples for education - Designing code-first learning paths - Achieving 95% language coverage through examples - Meeting annotation density standards (1.0-2.25 comments per code line) - Targeting experienced developers who know at least one language well ## Core Concepts ### What is By-Example? **By-example tutorials** are a code-first learning path that achieves 95% language coverage through 75-85 heavily annotated, self-contained code examples. **NOT a replacement for**: - Beginner tutorials (which provide deep explanations for complete beginners) - Quick Start (which is 5-30% coverage touchpoints) - Cookbook (which is problem-solving oriented, not learning-oriented) **Target Audience**: - **Experienced developers**: Seasonal programmers, software engineers - **Already know at least one programming language well** - **Want quick language pickup** without extensive narrative - **Prefer learning through working code** - **Need 90% coverage efficiently** ### Five-Part Example Structure Each example follows a consistent five-part structure: ```markdown ### Example N: Concept Na