CONCEPT Three Console tools, used in order
The Claude Console ships a suite of prompt-building tools you typically use in sequence: the prompt generator to draft, prompt templates & variables to parameterize, and the prompt improver to refine.
| Tool | What it does | When |
|---|---|---|
| Prompt generator | Generates a first-draft prompt template tailored to your task, following best practices | Solving the "blank page problem" |
| Templates & variables | Separates fixed content from dynamic {{variables}} | Any prompt reused across calls |
| Prompt improver | Analyzes and enhances an existing template (adds CoT, XML, examples) | Making a prompt more robust for complex, accuracy-critical tasks |
CONCEPT Templates & variables, and how the improver works
A prompt template combines fixed content (static instructions) with
variable content (user input, RAG-retrieved context, conversation history, tool results).
In the Console, placeholders use {{double brackets}}. The payoff is consistency,
efficiency (swap variables without rewriting), testability, scalability, and version control — you track the
stable core separately from the dynamic inputs.
<text>{{text}}</text>. (Note: claude.ai does not support templates/variables — this is
a Console/API capability.)The prompt improver takes your template (plus optional feedback and example input/output pairs) and enhances it in four steps:
- Example identification — locates and extracts examples from your template.
- Initial draft — builds a structured template with clear sections and XML tags.
- Chain-of-thought refinement — adds and refines detailed reasoning instructions.
- Example enhancement — updates examples to demonstrate the new reasoning process.
The result is a template with detailed CoT instructions, XML-organized sections, standardized step-by-step examples, and strategic prefills.
DIAGRAM Console workflow: draft → template → improve
drafts a template + variables"] GEN --> TPL["Template with {{variables}}
fixed vs. variable content split"] TPL --> IMP{"Complex, accuracy-
critical task?"} IMP -->|"yes"| PI["Prompt improver (4 steps):
find examples → draft →
CoT → enhance examples"] IMP -->|"no / latency-sensitive"| SIMPLE["🟠 Keep the simpler prompt"] PI --> OUT["🟢 Robust template:
CoT + XML + step-by-step examples"] classDef ok fill:#d4edda,stroke:#28a745,color:#155724; classDef gate fill:#ffe8cc,stroke:#ff9f40,color:#9a4a0a; class OUT ok; class SIMPLE gate;
CODE A template, and what the improver adds
A minimal template is just fixed text plus a {{variable}}:
# Prompt template — {{double brackets}} mark variable content Translate this text from English to Spanish: {{text}} # Better: wrap the variable in XML tags for clearer structure Translate the text below from English to Spanish. <text>{{text}}</text>
Feeding a bare classification prompt to the improver adds CoT reasoning, XML organization, and explicit
output formatting — while keeping the original {{variables}}:
# BEFORE — the improver's input From the list of Wikipedia titles, identify which article this sentence came from. Respond with just the title. Article titles: {{titles}} Sentence to classify: {{sentence}} # AFTER — the improver's output (abridged) You are a text classification system matching sentences to Wikipedia titles. <article_titles>{{titles}}</article_titles> <sentence_to_classify>{{sentence}}</sentence_to_classify> Follow these steps: 1. List the key concepts from the sentence 2. Compare each concept with the article titles 3. Rank the top 3 most relevant titles and explain why 4. Select the best-matching title Wrap your analysis in <analysis> tags. Then output ONLY the chosen title.
TRADE-OFFS Improved prompt vs. simple prompt
✅ Prompt-improver output
- Higher accuracy on complex, reasoning-heavy tasks
- Structured CoT + XML + step-by-step examples
- Preserves your variables; standardized formatting
⚠️ Simple prompt
- Faster, cheaper — better for latency/cost-sensitive apps
- Improver output is longer & slower by design
- Overkill when the current prompt already works
EXAM TRAPS
{{variables}} are a Console/API feature; claude.ai does not support them.PRACTICE
Q1 · What are the four steps of the prompt improver, in order?
(1) Example identification — extract examples from your template; (2) initial draft — structured template with sections and XML tags; (3) chain-of-thought refinement — add and refine reasoning instructions; (4) example enhancement — update examples to show the new reasoning process.
Q2 · When should you not use the prompt improver?
On latency- or cost-sensitive applications. The improver produces longer, more thorough, slower responses — great when accuracy matters more than speed, wrong when speed/cost is the constraint. Use a simpler prompt there.
Q3 · Why separate fixed content from {{variable}} content in a template?
It gives you consistency, efficiency (swap inputs without rewriting), testability (change only the variable to probe edge cases), scalability, and version control (track the stable core apart from dynamic inputs). It's also what powers the Console's generator, improver, and evaluation tooling.