Tech Writer — ChatGPT & Claude.ai prompt: software how-to guides
Turns your rough list of app steps into a readable how-to article. Handy when the actions are clear but the write-up isn't.
Open on GitHubWhat Tech Writer does
You hand the prompt the basic steps of some app feature, and it writes the article around them. The role is a technical writer who walks the reader through each step and decides where a visual is missing: at that spot it drops a (screenshot) marker, and you add the image later.
It runs as a plain text prompt in a chat. Nothing to install — open ChatGPT or Claude.ai, paste the prompt, then add your own steps. The example baked into it covers installing an app: grab the file for your platform, install it, open it with a double click.
What you get back is prose, not verified documentation. The steps come from you, so a wrong step ends up in the article too. For interfaces with fiddly navigation, spell out which menu holds what, or the writer will start filling gaps on its own.
What it helps with
- turn a rough step list into a how-to article
- write a guide for installing an app
- mark spots that need screenshots
- rewrite dry steps as readable prose
- draft documentation for a software feature
Example prompts for the agent
- Act as a tech writer. Here are the steps: 1. Open settings 2. Pick a theme 3. Save. Write the article.
- You are a technical writer. Turn these steps into a guide and add (screenshot) where an image is needed.
- Write install instructions for Windows and macOS based on these steps.
How to install Tech Writer
How to use
Paste the text at the start of a chat or into project instructions
Manually: put the files in place
.claude/commands/prompts.csv.mdQuestions about Tech Writer
How do I install Tech Writer in Claude?
There is nothing to install: copy the prompt text, paste it as your first message in Claude, and add your steps right after.
What does Tech Writer do?
It writes an article or guide from the basic app steps you provide. Where a screenshot belongs, it leaves a (screenshot) marker.
How is this different from just asking for instructions?
It sets a technical-writer role and a workflow: you bring the steps, it expands them into prose and flags where images go.
Source text
prompts.csv · CC0-1.0
I want you to act as a tech writer. You will act as a creative and engaging technical writer and create guides on how to do different stuff on specific software. I will provide you with basic steps of an app functionality and you will come up with an engaging article on how to do those basic steps. You can ask for screenshots, just add (screenshot) to where you think there should be one and I will add those later. These are the first basic steps of the app functionality: "1.Click on the download button depending on your platform 2.Install the file. 3.Double click to open the app"
© lucagonzalez · CC0-1.0 · f/prompts.chat
