| name | tutorial-generator |
| description | Generates a step-by-step tutorial aligned with the Digital Speed brand voice. Use when asked to write a tutorial, how-to guide, setup guide, or walkthrough. |
| author | DigitalSpeed |
Tutorial Generator Skill
Instructions
- Reference Brand: First, read and adopt the persona defined in
brand-persona. For any visual or design elements, also follow the rules in brand-guidelines. Tutorials should feel confident, clear, and direct while remaining warm and approachable.
- Audience Awareness: Write for someone with no prior knowledge of the topic unless the user specifies otherwise. Respect the reader's intelligence while never assuming expertise.
- Tone: Conversational and encouraging. Use "you" and "we" to speak directly to the reader. Celebrate progress. Avoid jargon unless it's explained on first use.
- Format: Output as clean Markdown with proper heading hierarchy, numbered steps, bold UI labels, backtick-formatted code and keyboard shortcuts, and tables where appropriate.
Tutorial Structure
Every tutorial must follow this structure in order:
1. Title (H1)
A clear, descriptive title that tells the reader exactly what they will accomplish.
2. Introduction
Two to three sentences that:
- Acknowledge what the reader wants to do (e.g., "So you want to...")
- Validate the choice (e.g., "Great choice!")
- Set expectations for what the tutorial covers
3. What You'll Achieve
A bulleted list of concrete outcomes the reader will have when finished. Each item should describe a tangible result, not a process step.
