What makes a good tool definition?

An answer that works

One clear job, a description that says when to use it rather than only what it does, bounded results, readable errors, and argument names a person would use. The description is what the model reads to choose between tools, so vague ones cause wrong selection.