Skip to content
bits
Prompting that works · Lesson 1 of 10

The brilliant new colleague

Tutor:

You met five prompting habits at the end of the first course. This course turns each one into a tool you can use on purpose, and you'll run every one live on Claude.

Start with the habit under all the others. Anthropic's advice is to treat Claude like a brilliant colleague on their first day. They're sharp and fast, but they know nothing about your project, your users or what “good” means to you. Anything you leave out, they have to guess.

Tutor:

Here's the test. Before you send a prompt, picture handing it to a smart person who has never seen your work. Would they need to ask you questions? If so, Claude will have to guess the answers, and guesses come out generic.

Same task, two prompts. The left one is “Write a description of our water bottle.” The right one adds who reads it, the facts, where it goes and how long it should be.

Vague prompt vs Colleague-ready promptillustrative: made-up numbers that show the idea, not output from a real modelcompare

promptTask: a product blurb for the Trailhead steel bottle

Vague prompt

Stay hydrated in style with our premium water bottle! Crafted from high-quality materials, it's the perfect companion for every adventure, whether you're at the gym, the office or on the go. Durable, sleek and eco-friendly, it's the last bottle you'll ever need…

Colleague-ready prompt

Keeps water cold for 24 hours on the trail. The 750 ml Trailhead is double-walled steel with a leakproof lid, and at 340 g it won't weigh down your pack.

Tutor:

The left reply isn't wrong. It's just the average of every bottle blurb ever written, because that's all the prompt asked for. The right one could only be about this bottle.

Tutor:

Two more things about how current Claude models read you.

They take you at your word. Recent models follow instructions closely, and some very literally. Ask for a description and you get one description. If you also want a headline, three options or a bolder tone, say so. Claude won't assume you wanted extra.

Order matters, so number it. When the steps have to happen in a set order, or none can be skipped, write them as numbered steps instead of one long sentence.

quick check+10 neurons
Tutor:

Which prompt passes the colleague test best?

    Type your answer or tap an option · Enter checks

    Tutor:

    Your turn. The draft is the vague prompt. Rewrite it so a new colleague could nail it first time: say who reads it, give real facts (make them up, it's practice), say where it will appear and set a length.

    Your turn

    Run your prompt and the replies land here.

      • Says who reads it, not yet
      • Gives real facts, not yet
      • Says where it will appear, not yet
      • Sets a length, not yet
      • Ran at 1.0, not yet
      run at
      ~0 tokens

      Turn on JavaScript to run prompts.

      Tutor:

      Run it a couple of times. The wording changes from run to run, but the facts and the shape should hold, because you pinned them down.