# Dev Guide Generator

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

- Repository: https://github.com/zebbern/claude-code-guide (4691 stars)
- Category: Writing
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add zebbern/claude-code-guide --skill dev-guide-generator -g -a claude-code -y`
Codex: `npx skills add zebbern/claude-code-guide --skill dev-guide-generator -g -a codex -y`
Cursor: `npx skills add zebbern/claude-code-guide --skill dev-guide-generator -g -a cursor -y`
Gemini CLI: `npx skills add zebbern/claude-code-guide --skill dev-guide-generator -g -a gemini-cli -y`

## Description

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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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**:

The rest: https://github.com/zebbern/claude-code-guide/blob/HEAD/skills/dev-guide-generator/SKILL.md