Tool Design Patterns

Overview

How to design tools that Claude uses effectively: writing descriptions that minimize misuse, returning structured errors that enable self-correction, controlling tool selection, and knowing the built-in tool catalog.

Writing Optimal Tool Descriptions

The Formula

Every tool description should contain: action verb + what it operates on + boundary conditions + example.