dev-guide-generator

Generates complete technical tutorials with setup steps, troubleshooting, and cheatsheets.

4.6k|462|Updated Jun 21, 2025
One-click install
npx skills add https://github.com/zebbern/claude-code-guide --skill dev-guide-generator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dev-guide-generator
Source: https://github.com/zebbern/claude-code-guide/tree/main/skills/dev-guide-generator
Command: npx skills add https://github.com/zebbern/claude-code-guide --skill dev-guide-generator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writing a thorough technical tutorial from scratch is time-consuming and easy to get wrong — missing prerequisites, unverifiable steps, and no troubleshooting guidance leave readers stuck. This Skill turns a single technical topic into a complete, structured tutorial through an eight-phase SOP workflow.

Core Features & Use Cases

  • Structured 8-Phase Workflow: Covers topic scoping, prerequisites, environment setup, core steps, troubleshooting, advanced topics, cheatsheet, and final document assembly.
  • Adaptive Interaction Modes: Chooses guided, semi-auto, full-auto, or quick mode based on how much detail the user provides.
  • Quality & Safety Checklist: Enforces verification commands for every step, real error messages in troubleshooting, placeholder-based secrets, and no insecure fixes like chmod 777.
  • Use Case: Ask for a Docker beginner's tutorial and receive a full document with OS-specific installation commands, numbered verifiable steps, a common-errors table, advanced learning paths, and a one-page cheatsheet.

Quick Start

Ask the agent to write a complete beginner tutorial for a technical topic such as Docker, Git, or Kubernetes.

Frequently Asked Questions about dev-guide-generator

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

FAQPage Schema
How do I generate a technical tutorial with this Skill?

Provide a technical topic or operational goal, such as a Docker beginner tutorial. The agent asks up to four clarifying questions about audience, operating system, and goals, then produces the full tutorial following its SOP workflow.

What sections does the generated tutorial include?

The tutorial includes prerequisites, environment setup with verification commands, numbered core steps, a troubleshooting table with real error messages, advanced topics with project suggestions, a one-page cheatsheet, and an appendix with glossary and references.

Can I skip the clarifying questions and get the tutorial directly?

Yes. Saying just write it triggers quick mode, which uses default assumptions: readers have basic programming experience, both macOS and Linux are covered, and the goal is a minimal working example.

Does the tutorial include real troubleshooting error messages?

Yes. The troubleshooting phase lists five to eight common error scenarios with actual error output, causes, actionable fixes, and verification steps. Fabricated error messages and insecure fixes like chmod 777 are explicitly prohibited.

What types of technical topics work best for tutorial generation?

It suits tool usage guides like Git, Docker, and Kubernetes, development environment and CI/CD setup, programming language and framework quickstarts, operations manuals for deployment and monitoring, and data processing workflows.

How do I revise a generated tutorial after giving feedback?

The Skill maps your feedback to the relevant workflow phase, re-executes from that phase, and cascades updates to all downstream content such as steps and the cheatsheet while keeping step numbering consistent.