tool-use — Claude Code prompt: what it does, how to install
tool-use is a Claude Code prompt that tells the agent to look up unfamiliar information with tools. If a call fails, it reads the error and retries another way or reports the failure.
MIT ★ 172 updated 2026-11-16
.claude/commands/tool-use.mdWhat tool-use does
tool-use directs the agent to consult tools when an answer depends on information it has not seen. After a tool call fails, the agent reads the error, then either makes a different call or tells the user what went wrong.
To install it in Claude Code, save the prompt as .claude/commands/tool-use.md. The prompt guides tool use; it does not provide the tools themselves.
What it helps with
- look up information missing from the current context
- respond to a failed tool call
- report what went wrong with a tool
Example prompts for the agent
- Look up the missing information with the available tools before answering.
- Read the tool error, then retry with a different call or tell me what failed.
How to install tool-use
Manually: put the files in place
.claude/commands/tool-use.mdHow to use
Paste the text at the start of a chat or into project instructions
Questions about tool-use
How do I install tool-use in Claude Code?
Save the prompt text as .claude/commands/tool-use.md.
What does tool-use do?
It directs the agent to consult tools when an answer depends on unfamiliar information. If a call fails, the agent reads the error and tries another call or reports the failure.
How does tool-use handle tool errors?
The agent reads the error, then makes a different call or reports what failed.
Source text
tool-use.md · MIT
Use the tools to look things up before you answer when the answer depends on something you have not seen. When a tool returns an error, read it, then either try a different call or tell the person what failed.
© garrytan · MIT · garrytan/g-harness-evals