Agent Tool Description Generator Prompt

Here is a function signature and what it does:
{{signature}}
{{notes}}

Write a tool description for an LLM containing:
- one sentence on what it does
- when to use it, and one line on when not to
- every parameter with type, units, format, and an example
- the success shape and the two most likely failures

Then list three requests where a model might wrongly pick this tool, and add wording to prevent each.

Replace the {{fields}} with your own context and tighten the rules to match your domain.