tutorial-creator

tutorial-creator

Generate personalized coding lessons from your own codebase. A Claude Code skill that turns the files you actually work on every day into annotated tutorials, tracks the vocabulary you've learned, and shows you where you're confused.

Works with any Swift, TypeScript, Python, or Rust project. Originally built during development of Stuffolio, a real iOS/macOS app whose codebase serves as the bundled demo.

~9 min read · scan the TL;DR if you only have 30 seconds

TL;DR

• What: Generate annotated lessons from your own code, track vocabulary you've learned across sessions, and see exactly what you're confused about.
• Why: Traditional tutorials teach syntax with toy examples; real projects have async workflows, state management, and accumulated design decisions. tutorial-creator builds fluency from the code you ship every day.
• Install: git clone into ~/.claude/skills/; then /skill tutorial-creator in any session.
• Try first: /skill tutorial-creator — opens the gateway question. Pick "Write a tutorial for myself" → "Topic + file" → point it at any file. ~10 min to a real annotated lesson.
• Example output: Day 16 — captured-self staleness in SwiftUI, a real production-bug walkthrough with pre/post tests and gap analysis.
• Maturity: v2.0.0 (released 2026-05-10); used through Stuffolio's daily practice; deeper curation for Swift, working built-in progressions for TypeScript / Python / Rust.

Newer to Claude Code?

A skill is a markdown file Claude Code knows how to run. When you type /skill tutorial-creator, Claude follows the instructions in this skill, asks what you want to do, then either generates a lesson, manages your vocabulary, or shows you your learning state. You don't have to memorize anything — the skill walks you through each choice.

Install

Clone into your Claude Code skills directory:

git clone https://github.com/Terryc21/tutorial-creator ~/.claude/skills/tutorial-creator

Then in any Claude Code session:

/skill tutorial-creator

First-run setup prompts you for the project to learn from, your language (Swift / TypeScript / Python / Rust auto-detected), and your experience level. The skill creates .claude/tutorial-config.yaml and a tutorials directory in the project you point it at.

mkdir -p /path/to/project/.claude/skills && git clone https://github.com/Terryc21/tutorial-creator /path/to/project/.claude/skills/tutorial-creator

/skill tutorial-creator vocab regen-md --import

See CHANGELOG.md for full release notes and the v1.1 → v2.0 changelog.

What gets generated

Above: real gap analysis after generating Day 16. The skill found two prerequisite gaps in the user's earlier curriculum and proposed half-step bridge tutorials (Day 15.5 and Day 9.5) that slot between existing days without renumbering.

Three sample outputs are checked into skills/tutorial-creator/examples/:

• Day 3 — ScoutResultsLookupView — early-progression Swift tutorial annotating a single SwiftUI view file. Pre-test, annotated source, post-test, vocabulary table.
• Day 16 — Captured-self staleness — later-progression deep dive on a subtle Swift concurrency bug pattern in the user's own codebase.
• useDebouncedValue hook — non-Swift example: TypeScript / React custom hook, same tutorial shape.

Each is a real tutorial generated from a real codebase, not a fabricated illustration.

Why this exists