the shelf / guides / ai-prompt-mistakes

Five mistakes that make an AI prompt useless

Bad prompts are rarely too short. They are too open - the model is left guessing at length, audience and format, and guessing is what generic output is made of.

The five mistakes

Fixing a prompt, step by step

  1. State the job in one sentence at the top, with the audience: 'Explain to a small business owner why...'
  2. Cap the output: a sentence count, a word count, a line count. Any cap beats no cap.
  3. Add the format by example: paste two lines you like and say 'like this'.
  4. List the bans: words to avoid, formats to skip, no emoji, no hashtags - whatever your taste actually is.
  5. Iterate in follow-ups, not in one giant prompt: 'shorter', 'keep the first line, redo the rest', 'now the same for plumbers'.

The test that tells you a prompt is done

Run the finished prompt three times on three different days of the week, or with three different starting inputs. If the outputs vary wildly in usefulness, the prompt is still under-specified; if they vary in flavor but not in quality, it is done. This is also the honest argument for keeping prompts in a file rather than in chat history: a prompt you cannot re-run identically is a memory, not a tool. The vault metaphor is literal - stored, versioned, tested, reused.

Small rules with outsized effect

The free tool for this

There is no calculator that answers this one honestly, so here is the free set: eight calculators for rates, quotes, invoices, splits, prices and fees. They run in the page and send nothing anywhere.

If you would rather not build it yourself

The Prompt Vault is 79 prompts built this way - length capped, audience named, buzzwords banned - and the free sampler is real pages from it, no email wall. Prompt Vault is $12. See it on the shop, and there is a plain page about it here: what it holds.

Questions people actually ask

Do long prompts work better than short ones?

Neither length wins - specificity wins. A short prompt with a hard cap and a named audience beats a long one that describes the task in five airy ways.

Should I give the model a role, like 'act as a senior copywriter'?

Roles can help tone, but they are no substitute for constraints. 'Act as' plus a length cap plus an example beats 'act as' alone, every time it is tested.

Why do my prompts work one week and fail the next?

Because they were under-specified and the first success was luck. The three-runs test catches this: a prompt that only worked once was never really working.

Read next

How to write a better AI prompt for real work, Where to keep the AI prompts that work, so you stop rewriting them.

Buy it back to the shelf all guides