How to Write Better AI Prompts: The CRAFT Framework

After writing a few thousand prompts, I noticed the good ones nearly always had the same five things in them, and the bad ones were missing two or three. So I gave it a name I could remember on the fly: CRAFT. Context, Role, Action, Format, Tone. It’s not a rigid template you fill out like a tax form — it’s a mental checklist you run in two seconds before hitting enter. Here’s how each piece works, and what happens when you stack them.

If you want the broader set of habits, this pairs nicely with my prompt engineering guide for beginners. CRAFT is the structure; that piece is the toolbox.

C — Context

Tell the AI the situation. This is the single most skipped step, and it’s the most important. The AI knows nothing about your world unless you say so. Who are you? What are you trying to achieve? What’s already happened? What’s the raw material?

Without context: “Write a product description.” With context: “I sell handmade soy candles online. My customers care about clean ingredients and cozy vibes. Here are the scent notes: [list].”

The second one gives the AI something to actually work with instead of generic guesses.

R — Role

Tell it who to be. A role instantly sets the vocabulary, assumptions, and standards it writes with. “You’re an experienced email marketer” produces something completely different from a cold start, because it pulls the model toward how that kind of person actually writes.

You can be specific: “You’re a patient kindergarten teacher,” “You’re a no-nonsense financial editor,” “You’re a friendly personal trainer.” The role is a shortcut to a whole style.

A — Action

Say exactly what you want done — and use a clear verb. “Summarize,” “rewrite,” “compare,” “brainstorm,” “critique,” “translate,” “outline.” Vague verbs get vague results. “Help me with my resume” is mush. “Rewrite the work-experience section to emphasize leadership” is a clear action the AI can nail.

Be specific about the thing, too. Not “write something about dogs” but “write a 5-tip list on house-training a puppy.”

F — Format

Tell it the shape you want the answer in. This saves enormous amounts of cleanup. Do you want a bulleted list? A table? Three short paragraphs? A single tweet? An email with a subject line? Name it.

“Give me the pros and cons as a two-column table” gets you a table. Leave format out and the AI picks for you — usually a wall of prose you then have to reformat by hand.

T — Tone

Tell it how to sound. Friendly, formal, funny, blunt, warm, professional, casual. Tone is the difference between a message that fits your voice and one you have to rewrite. “Keep it warm and conversational, like I’m talking to a friend” or “professional but not stiff” steers it instantly.

This is also where negative instructions live: “no corporate buzzwords,” “don’t use exclamation marks,” “avoid the word ‘leverage.’”

Putting it all together

Watch what happens when you stack all five. Start with the lazy version:

“Write an email about our sale.”

Now run it through CRAFT:

“Context: I run a small online bookstore; we’re having a 3-day 20%-off sale this weekend for our email subscribers, who are loyal regulars. Role: You’re a warm, bookish copywriter. Action: Write a short announcement email. Format: A subject line plus 3 short paragraphs and one clear button text. Tone: Friendly and a little cozy, no hard-sell, no exclamation marks.”

The first prompt gets you generic spam. The second gets you something you could nearly send as-is. Same tool, five seconds of extra thought.

You don’t always need all five

Here’s the part that keeps CRAFT useful instead of annoying: it’s a checklist, not a requirement. For a quick question, Context and Action might be all you need. For something you’ll actually publish, use all five. The point isn’t to write long prompts — it’s to quickly notice which piece is missing when an answer disappoints you. Got a bland result? You probably skipped Context or Tone. Wrong shape? You forgot Format. CRAFT turns “this isn’t quite right” into “ah, I left out the role.”

The habit that makes it stick

For one week, before you send any prompt, run the five letters in your head: do I have Context, Role, Action, Format, Tone — and which of these does this task actually need? It feels deliberate at first and becomes automatic fast. Within days you’ll be writing sharper prompts without thinking about the acronym at all, which is exactly the goal. A framework you’ve internalized beats one you have to look up.

If you only remember one letter, make it C for Context. In my experience it’s the most-skipped and the most powerful of the five, because the AI can’t write well for a situation it knows nothing about. Get Context right and the other four often fall into place on their own.

Frequently asked questions

Do I need to label the parts like “Context:” and “Role:”? No. Labeling helps for complex prompts, but for everyday use you just weave the five elements into a normal sentence or two. The labels are training wheels.

Does CRAFT work on Claude and Gemini, or just ChatGPT? All of them. It’s about clear communication, which every AI rewards equally.

Isn’t this just “be specific”? Essentially, yes — but “be specific” is too vague to act on. CRAFT tells you specifically what to be specific about, which is the part people get stuck on.

What if my prompt gets too long? Then trim. Length isn’t the goal; clarity is. Keep the elements that remove guesswork and cut the rest.

Where to go next

Want ready-made prompts that already follow this structure? Grab my 40 ChatGPT prompts for everyday tasks — they’re built on exactly these principles, so you can see CRAFT in action and reshape them for your own needs.

Leo Tan writes hands-on AI guides at AI Play Books. CRAFT is the checklist I actually run before hitting enter. Found a better one? Tell me.