Tool Description Audit: Overlap, Ambiguity and Missing Error Cases

Check an agent's tool definitions for clarity.

Added October 15, 2026. Written with AI assistance and checked for clarity and placeholders; not reviewed by a lawyer, accountant, clinician or other professional. How these prompts are made

The Open buttons send the prompt text as currently shown below to that site only when you click. Fill in the placeholders first.

[VERIFY] is an editorial flag, not a blank to fill. Wherever the prompt shows [VERIFY], check that item against a reliable source before you use it (what [VERIFY] means).

Audit tool descriptions for an agent. The tool definitions (name, description, parameters, returns): [TOOL_DEFINITIONS]. Cases where the agent picked the wrong tool or arguments: [MISTAKES].

Check each tool for a clear verb-led description, when to use and not use, parameter names and types that are unambiguous, allowed values, examples, return and error formats, side effects, and irreversible actions flagged. Check the set for overlap between tools and confusingly similar names. Make a table with Tool, Issue, Example mistake it could cause, and Rewrite. Count tools lacking error descriptions. Provide five test requests with the expected tool and arguments, including one where no tool should be called.

Do not assume hidden behaviour. Mark anything I should verify with the tool's owner [VERIFY].

Add a worked overlap example: tools 'search_docs' and 'find_documents' both search files; merge or rename to 'search_internal_wiki' and 'search_shared_drive' with clear scopes and examples of which to use when. Include a missing-error-case rewrite showing a return like {status: 'not_found'}.

Fill in before use

Optional: type your details and the prompt above updates. Nothing is saved or sent.

Replace each bracketed placeholder with your own details, then paste into Any AI or another assistant.