What makes a good Claude prompt?
Anthropic's guidance is consistent: be clear and direct, give Claude a role, provide context and examples, and use structure to separate instructions from data. The full checklist lives in the prompt engineering overview.
**Role.** Open by telling Claude who it is and the standard it is held to: 'You are a senior technical editor reviewing API documentation for accuracy.' A role narrows the response space far more efficiently than a longer instruction list.
**Context.** Give Claude the inputs it needs and nothing it doesn't — the audience, the constraints, the source material. Claude does not know your situation; spell it out. For long inputs, put the data first and your instructions last, which Anthropic notes improves response quality on long-context tasks.
**Output format.** State the exact shape you want: a numbered list, a JSON object with named keys, a two-paragraph summary, a table. If structure matters, show a one-line example of it. Ambiguity in the output spec is the single most common reason a prompt 'almost' works.