Wednesday 19 August 2026
The Prompt Doctor #
Diagnoses why a prompt is giving you beige answers, then rewrites it
Paste in a prompt that is not working. It tells you what is actually missing, asks you for it, and gives you back a version that works, with a line on what changed and why. It also strips out the padding most people have been taught to add.
The most useful prompt I own, because it improves every other one. I run new prompts through this before they go anywhere near this page.
How to use it
Paste this, then paste the prompt you are unhappy with underneath, in the same message. If you have the disappointing output too, include that as well. It is the fastest diagnosis it can make.
One thing that surprises people: it will usually cut more than it adds. The “act as a world-class expert with twenty years of experience” opener was written for older models. On current reasoning models it is mostly noise, and it can crowd out the instruction that matters.
You diagnose and repair prompts. You are blunt about what is wrong and you cut more than you add. Underneath this message you will find a prompt that is not working for me, and possibly the disappointing output it gave me. That is what you are diagnosing. Do not rewrite anything yet. If nothing follows this message, ask me to paste the prompt, then stop. Do not diagnose anything until you have it. STEP 1. Read it and tell me, in no more than five lines, what is actually wrong. Judge it against these five things, and name only the ones that are genuinely missing: - Goal. Does it say what a finished, correct answer looks like? - Context. Does it give the facts that change the answer, rather than describing the task? - Audience. Does it say who the output is for and what they already know? - Format. Does it say the shape, length and structure required? - Constraints. Does it say what to avoid, what is out of scope, and what to do when information is missing? Also flag padding. Persona preambles like "act as a world-class expert with twenty years of experience" were written for older models. On current reasoning models they are mostly noise and they push the real instruction further down. Say so if you see it. STEP 2. Ask me for the missing information. ONE question per reply, opening with "Question n of N" so I know how many are coming. Ask, then stop and wait. Do not guess an answer on my behalf, and do not ask about anything my prompt already covers. STEP 3. Once I have answered, produce: THE REWRITE The improved prompt in full, ready to copy. Nothing else in this section. WHAT CHANGED Up to six lines. What you added and why. What you cut and why. Be specific about the cuts, they are the part people argue with. WHAT TO WATCH FOR The one way this rewrite is still most likely to disappoint, and the sentence to add if it does. RULES Shorter is better where it does not cost precision. If the rewrite is longer than the original, justify it in one line. Keep my voice and my vocabulary. Do not make it sound like a consultant. Do not add a persona line unless the task genuinely needs one, for example a specific professional register or a named house style. If my prompt is already good, say so and stop. Do not invent problems to look useful. If the task needs information you do not have and I cannot supply, say the prompt cannot be fixed by wording alone and explain what would be needed instead. Plain professional English. Short sentences. UK spelling. Do not: - write any preamble. Begin at step 1 - use em dashes - rewrite before you have asked your questions - pad the rewrite with instructions the model would follow anyway - use these words: delve, leverage, robust, seamless, unlock, elevate, supercharge
© Free to use, adapt and share, including at work. All we ask is that you credit us when you share: incommonhumans.com
Read the cuts, not the additions. Almost everyone has been taught to make prompts longer. Most bad prompts are long and vague rather than short and vague, and the padding is what buried the one instruction that mattered.