generate-tutorials

Generate and review Diátaxis tutorials with one-path sittings and course.md structure.

Updated Sep 7, 2026
One-click install
npx skills add https://github.com/deriye/.agents-work --skill generate-tutorials-deriye
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: generate-tutorials
Source: https://github.com/deriye/.agents-work/tree/main/skills/generate-tutorials
Command: npx skills add https://github.com/deriye/.agents-work --skill generate-tutorials-deriye

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing learning-oriented tutorials that learners can actually finish is hard: authors mix in how-to content, skip visible results, or leave steps that fail on a clean machine. This Skill enforces the Diátaxis tutorial contract so every sitting is one path, one accomplishment, and copy-paste reliable. ## Core Features & Use Cases - Purpose classification: Distinguishes learn-only standalone tutorials from sequential implement-a-real-app sittings that grow the same product repository. - Structured authoring workflow: Guides title, summary, prerequisites, numbered steps with visible results, checkpoints, and a closing that names what was built. - Publish gate checklist: A 25-point author checklist covering voice, fenced code edits, pinned versions, per-stack code layout via coding-best-practices, and clean-start verification. - Use Case: A developer asks for a lesson teaching React form handling. The Skill classifies it as learn-only, writes a course.md under gitignored tmp/, splits code per coding-best-practices, and verifies the tutorial runs from a clean start before publishing. ## Quick Start Ask the assistant to write a Diátaxis tutorial for your topic, stating whether it is learn-only or part of an implementation series.

Frequently Asked Questions about generate-tutorials

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a Diátaxis tutorial?▼

Decide the purpose first: learn only (standalone) or implement a real app (sequential). Then write numbered steps with visible results, expected output after actions, and a closing that names what was built, following the principles in reference.md.

What is the difference between a tutorial and a how-to guide?▼

A tutorial is a guided one-path sitting for a learner, with the teacher responsible for success. A how-to guide addresses a real-world task with variants for an already-competent practitioner. This Skill refuses how-to, explanation, and reference requests.

Where should generated tutorial files be saved?▼

Sittings live in course.md under the gitignored tmp/ directory by default. They must not be committed to README.md, docs/, or terminology files, because a clone never contains tmp/ and links to it would break.

When should a tutorial be standalone versus sequential?▼

Learn-only tutorials must be standalone, recreating everything so a clean-start learner can finish. Implementation tutorials are sequential: they continue the same repository, name the previous tutorial as prerequisite, and edit the real product files.

How are code snippets in tutorials validated?▼

Every stack in the sitting must follow the coding-best-practices skill; missing stacks are researched and added there first. Edits to existing files appear as fenced copy-paste blocks, versions and paths are pinned, and the author must run the tutorial end to end.