Skills

Dev Guide Generator

Generates complete technical tutorials from prerequisites and environment setup to core...

Install

npx skills add zebbern/claude-code-guide --skill dev-guide-generator -g -a claude-code -y
Category
Writing
Updated
4d ago
License
MIT
Context cost
Mediumabout 3,000 tokens
Runs scripts
No, instructions only

What it does

Generates complete technical tutorials from prerequisites and environment setup to core steps, troubleshooting, and a final cheatsheet. Trigger on requests to write a tutorial, create a setup guide, organize steps for beginners, or keywords like step-by-step, quickstart, or how-to guide.

Dev Guide Generator

One topic → complete technical tutorial: Through a structured SOP workflow, transform a technical topic into a comprehensive tutorial covering prerequisites, environment setup, core steps, common error troubleshooting, and advanced topics, all accompanied by a cheatsheet.

Quick Start

The user simply provides a technical topic or operational goal, and the Agent automatically generates a complete tutorial following this workflow:

User: Help me write a Docker beginner's tutorial
Agent: [Outputs complete technical tutorial + Cheatsheet following the SOP workflow]

SOP Workflow

Phase 1: Topic Scoping & Audience Analysis

Goal: Define the tutorial's technical subject, target audience, and scope boundaries.

Steps:

  1. Parse the topic: Identify the core technology, operational goals, and expected deliverables from the user's input
  2. Ask clarifying questions (up to 4 key questions):
    • What is the target audience's technical level? (Complete beginner / Some experience / Experienced developer)
    • What operating system will the reader be using? (macOS / Windows / Linux / Any)
    • What should the reader be able to do after completing the tutorial? (Specific deliverable)
    • Are there any version or tech stack constraints?
  3. If the user asks to skip clarification, proceed with these default assumptions:
    • Audience: Has basic programming experience but is unfamiliar with the topic technology
    • Environment: Cover both macOS and Linux (note Windows differences where necessary)
    • Goal: Be able to independently complete a minimal working example

Output: Tutorial metadata summary (topic, audience, objective, scope, no more than 150 words)


Phase 2: Prerequisites

Goal: List all knowledge and tools the reader needs before starting this tutorial, ensuring there are no knowledge gaps.

Steps:

Read the whole SKILL.md on GitHub

More in Writing