Tutorial Docs

This is your guide for writing tutorials that actually teach. It's built on the Diataxis framework and focuses on learning by doing, not reading about doing. Every step should produce visible output with a "you should see" confirmation. No branching paths, no optional steps, just one clear route from zero to working thing. The template is opinionated about structure: show the end result first, keep prerequisites minimal, lead with actions instead of explanations, and take responsibility when readers get stuck. If you're writing getting started guides or any hands-on learning content, this gives you the patterns to make people successful on their first try.

skills.sh installs: 271
GitHub stars: 87
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add existential-birds/beagle --skill tutorial-docs --agent claude-code

Installs into .claude/skills of the current project.

Files

Tutorial Documentation Skill

This skill provides patterns for writing effective tutorials following the Diataxis framework. Tutorials are learning-oriented content where the reader learns by doing under the guidance of a teacher.

Dependency: Use this skill with docs-style for core writing principles. To confirm a tutorial is the right type — rather than a how-to, reference, or explanation — see docs-style/references/diataxis-compass.md.