tutorial-content-structure

What problem does it solve?

This skill defines a consistent structure for organizing tutorials into a hierarchical model (Tutorial > Parts > Chapters > Lessons), with root and nested meta files and clear content flows to simplify creation, discovery, and maintenance.

Core Features & Use Cases

• Directory-based hierarchy under src/content/tutorial/ with root meta.md (type: tutorial), per-level meta.md files, and content.md at the lesson level.
• Metadata inheritance and overrides to standardize defaults across tutorials, parts, chapters, and lessons.
• Support for optional resources directories (scripts/, references/, assets/) and guidance on when and how to use them.
• Rich Markdown features and callouts described, including code block imports and MDX support for advanced lessons.
• Practical use cases: building scalable Rails or other framework tutorials with structured navigation and reusable templates.

Quick Start

Organize your tutorials by creating a src/content/tutorial/ directory with a root meta.md, nested part and chapter directories containing meta.md and content.md as appropriate.