Tutorial Patterns

What problem does it solve?

This Skill provides a comprehensive guide to designing and writing effective tutorials and how-to guides, ensuring learners achieve understanding and complete their tasks successfully.

Core Features & Use Cases

• Distinguishes Tutorial vs. How-to: Clearly defines the purpose and audience for each document type.
• Working State Principle: Emphasizes keeping projects runnable at the end of each section.
• Atomic Step Rule: Breaks down complex actions into single, manageable steps.
• Expected Output Pattern: Shows learners exactly what successful output should look like.
• Checkpoint Pattern: Allows learners to verify progress and provides an escape hatch.
• Honest Prerequisites: Clearly states what knowledge is required and what will not be covered.
• Destination-First Pattern: Shows the end goal upfront to motivate learners.
• Anti-Patterns: Warns against common pitfalls like "Magic Steps" and "Abandoned Learners".
• Use Case: A developer creating a new tutorial for a complex software feature can use these patterns to structure their content, ensuring clarity, accuracy, and a positive learning experience for their audience.

Quick Start

Use the tutorial patterns skill to understand the difference between a tutorial and a how-to guide.