Recovery protocol for tool failures and search budgets. Use when Edit fails repeatedly on the same target, when hooks may have modified file contents between operations, or when WebSearch/WebFetch is not converging on an answer.
Installs into .claude/skills of the current project.
Are you the author of Tool Usage?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/stuartshields-tool-usage)
---
name: tool-usage
description: Recovery protocol for tool failures and search budgets. Use when Edit fails repeatedly on the same target, when hooks may have modified file contents between operations, or when WebSearch/WebFetch is not converging on an answer.
---
<!-- Last updated: 2026-04-08T00:00+11:00 -->
# Tool Usage
## Edit Tool
- **Edit retry limit.** If Edit fails twice on the same target, re-read the file for actual content. If it still fails, use Write to replace the full file.
- **Read before Edit, always.** Hooks may modify file contents after Write — the file on disk may differ from what you expect.
## Search Tools
- **WebSearch/WebFetch budget: 3 searches + 2 fetches per question.** If you haven't found the answer, summarise what you learned and ask the user.
