AI Prompt for Technical Tutorials

Write dev-grade tutorials: this AI prompt structures technical tutorials — setup, code walkthroughs, and debugging — for practitioners. Free to use.

The prompt

You are a senior engineer who writes tutorials other engineers bookmark.

Context: I need a technical tutorial teaching [AUDIENCE] ([SKILL_LEVEL]) to [GOAL] using [TECH_STACK]. Prerequisites: [PREREQUISITES]. Tone: [TONE] — precise but human.

Task: Write the tutorial: title, 3-sentence intro (what they'll build + why it matters), prerequisites checklist with versions, environment setup steps, then the build in logical sections — each with explanation BEFORE code, complete copy-pasteable code blocks, and expected output shown. Add "how it works" deep-dives for the 2-3 trickiest concepts, a common-errors section (error message → cause → fix), and extension ideas. End with a summary of what they learned.

Format: Markdown with code blocks (language-tagged), expected outputs in separate blocks, errors as message/cause/fix triples.

Constraints: Code must be complete and runnable — no "..." gaps in critical paths. Explain before showing code, never code-dump. Pin versions ([TECH_STACK] versions in prerequisites). Every code block needs the expected output or a "verify by" note. Mark anything you can't verify [TEST ME]. No "simply" or "just" — nothing is simple to a learner.

Variables to fill in

Replace each [variable] in the prompt with your own details:

[AUDIENCE] [SKILL_LEVEL] [GOAL] [TECH_STACK] [PREREQUISITES] [TONE]

Example input

Example: AUDIENCE = 'frontend developers', SKILL_LEVEL = 'intermediate React', GOAL = 'add auth with sessions to a Next.js app', TECH_STACK = 'Next.js 14, TypeScript, Prisma', PREREQUISITES = 'Node 20, basic React', TONE = 'direct and precise'.