{"name":"write-tech-tutorial-prompt","description":"A prompt that turns rough notes and steps into a clear, friendly technical tutorial or how-to guide for beginners - who it is for, what they need first, numbered steps with expected results, screenshot markers, common problems and next steps. Use when the user wants to write a tutorial, a how-to post, a getting-started guide or a blog post that teaches a tool.","category":"writing-prompts","tags":["writing","docs"],"models":["any"],"proven":false,"passing_families":0,"model_testing":"Not yet model-tested; testing Jan 2027","url":"https://theskillvault.ai/skills/write-tech-tutorial-prompt","api_url":"https://theskillvault.ai/api/skills/write-tech-tutorial-prompt","raw_url":"https://theskillvault.ai/api/skills/write-tech-tutorial-prompt/raw","body":"# Write a tech tutorial (prompt)\n\nGive it your rough steps; get back a tutorial a beginner can follow without getting stuck.\n\n## When to use\n- You want to publish a how-to or getting-started guide for your app or tool.\n- Your notes make sense to you but not to a newcomer.\n- You are writing a teaching blog post.\n\n## When not to use\n- You need a project's README. Use write-readme-prompt.\n\n## Steps\n1. Write the rough steps, in order, even as fragments.\n2. Fill in {{AUDIENCE}} and {{GOAL}} (what the reader will have at the end).\n3. Paste the prompt, then follow the tutorial yourself, exactly as written, on a clean setup.\n4. Add the screenshots where it marked them, and fix any step that failed.\n\n## Prompt\n```text\nTurn my rough steps into a clear technical tutorial.\n\nAudience: {{AUDIENCE}}\nGoal (what they will have at the end): {{GOAL}}\n\nStructure:\n1. Title that says what they will achieve.\n2. One-paragraph intro: who it is for and what they will build or do.\n3. Before you start: accounts, tools and versions they need.\n4. Numbered steps. Each step: one action, the exact command or click path, and \"You should see:\" with the expected result. Mark where a screenshot helps with [screenshot: what it shows].\n5. Common problems: 3-5 likely errors and how to fix each.\n6. Next steps: where to go after this.\n\nStyle: friendly and direct, short sentences, second person (\"you\"). Explain jargon once. Do not skip steps that feel obvious.\n\nMY STEPS:\n{{ROUGH STEPS}}\n```\n\n## How to adapt\n- Video script instead? Ask for spoken lines plus on-screen actions per step.\n- Experienced readers? Change the audience and drop the \"Before you start\" detail.\n\n## Gotchas\n- Replace real API keys, passwords and personal details in examples with obvious placeholders.\n- Tutorials break when tools update. Note the version you tested with.\n\n## Portability\nWorks for any tool, language or platform, with any chat AI. No tool lock-in.\n\n## Done when\n- Someone new can finish the tutorial without asking you a question.\n- Every step has an expected result, and you tested it end to end.\n\n## Example prompt\n\"Turn these notes into a beginner tutorial for deploying a Next.js app to Vercel for the first time.\"\n\n---\nBased on the \"Tech Writer\" prompt by lucagonzalez on prompts.chat (CC0 1.0, public domain).","files":[],"license":"CC0-1.0","license_name":"CC0 1.0","license_url":"https://creativecommons.org/publicdomain/zero/1.0/","attribution":"Based on work by lucagonzalez (prompts.chat, 'Tech Writer') (Public domain (CC0 1.0) - prompt contributed to prompts.chat by lucagonzalez, CC0 1.0), https://github.com/f/prompts.chat/blob/b09880e229d2f091ffa2254bc187532fb8980f9b/prompts.csv; adapted by TheSkillVault, https://theskillvault.ai","install":{"claude_code":"curl -fsSL --create-dirs 'https://theskillvault.ai/api/skills/write-tech-tutorial-prompt/raw' -o ~/'.claude/skills/write-tech-tutorial-prompt/SKILL.md'","cursor":"curl -fsSL --create-dirs 'https://theskillvault.ai/api/skills/write-tech-tutorial-prompt/raw' -o '.cursor/skills/write-tech-tutorial-prompt/SKILL.md'","agents":"curl -fsSL --create-dirs 'https://theskillvault.ai/api/skills/write-tech-tutorial-prompt/raw' -o '.agents/skills/write-tech-tutorial-prompt/SKILL.md'","mcp_url":"https://theskillvault.ai/mcp","cursor_mcp_deeplink":"cursor://anysphere.cursor-deeplink/mcp/install?name=theskillvault&config=eyJ1cmwiOiJodHRwczovL3RoZXNraWxsdmF1bHQuYWkvbWNwIn0%3D","mcp_config":{"mcpServers":{"theskillvault":{"url":"https://theskillvault.ai/mcp"}}}},"bundles":[],"tested_on":[{"family":"chatgpt","name":"ChatGPT","outcome":null,"date":null,"source":null,"counts":false,"stale":false},{"family":"claude","name":"Claude","outcome":null,"date":null,"source":null,"counts":false,"stale":false},{"family":"gemini","name":"Gemini","outcome":null,"date":null,"source":null,"counts":false,"stale":false},{"family":"grok","name":"Grok","outcome":null,"date":null,"source":null,"counts":false,"stale":false},{"family":"llama","name":"Llama","outcome":null,"date":null,"source":null,"counts":false,"stale":false},{"family":"deepseek","name":"DeepSeek","outcome":null,"date":null,"source":null,"counts":false,"stale":false},{"family":"mistral","name":"Mistral","outcome":null,"date":null,"source":null,"counts":false,"stale":false},{"family":"qwen","name":"Qwen","outcome":null,"date":null,"source":null,"counts":false,"stale":false},{"family":"kimi","name":"Kimi K","outcome":null,"date":null,"source":null,"counts":false,"stale":false}],"proven_rule":{"threshold":5,"window_days":365,"computed_at":"2026-11-02T03:20:33.817Z"}}