Browse AI Agents & MCP SECTION 3: Tool Definitions & Schemas

The Description Rewriter

1 fill-in slot · from The AI Prompt Handbook for AI Agents & MCP

Your details

0/1 filled

The Description Rewriter

Rewrite these tool descriptions so a model uses them correctly.

[PASTE CURRENT TOOL DEFINITIONS]

Observed problems: [E.G., "never calls the search tool",
"confuses update and create", "guesses the date format"]

For each tool:
1. What the current description fails to convey
2. The rewritten description
3. What specifically changed and which failure it addresses

Apply:
- Trigger conditions stated affirmatively and first
- Explicit negative guidance for every confusion pair
- Formats, units, and conventions named
- Preconditions stated ("requires a valid session token obtained
  from authenticate")
- Consequences noted for anything with side effects

Then produce a confusion matrix: for every pair of tools, could a
model plausibly choose the wrong one? Where yes, what
distinguishing text now prevents it?

Highlighted [slots] are still empty. Downloads are plain .txt — paste into any AI assistant.