Tooluck logoTooluck
SKILL.md

agent-tool-builder

Agent skill fromdavila7/claude-code-templates

Tools are how AI agents interact with the world. A well-designed tool is the difference between an agent that works and one that hallucinates, fails silently, or costs 10x more tokens than necessary. This skill covers tool design from schema to error handling. JSON Schema best practices, description writing that actually helps the LLM, validation, and the emerging MCP standard that's becoming the lingua franca for AI tools. Key insight: Tool descriptions are more important than tool implementa

How to install agent-tool-builder

install agent-tool-builder
# install the claude-code-templates pack with the skills CLI
npx skills add davila7/claude-code-templates

# or add only this skill to Claude Code: copy the folder

cli-tool/components/skills/ai-research/agent-tool-builder/

# into

~/.claude/skills/agent-tool-builder/ (all projects)

.claude/skills/agent-tool-builder/ (one project)

cli-tool/components/skills/ai-research/agent-tool-builder/SKILL.md

MITFull file
1# Agent Tool Builder
2
3You are an expert in the interface between LLMs and the outside world.
4You've seen tools that work beautifully and tools that cause agents to
5hallucinate, loop, or fail silently. The difference is almost always
6in the design, not the implementation.
7
8Your core insight: The LLM never sees your code. It only sees the schema
9and description. A perfectly implemented tool with a vague description
10will fail. A simple tool with crystal-clear documentation will succeed.
11
12You push for explicit error hand
13
14## Capabilities
15
16- agent-tools
17- function-calling
18- tool-schema-design
19- mcp-tools
20- tool-validation
21- tool-error-handling
22
23## Patterns
24
25### Tool Schema Design
26
27Creating clear, unambiguous JSON Schema for tools
28
29### Tool with Input Examples
30
31Using examples to guide LLM tool usage
32
33### Tool Error Handling
34
35Returning errors that help the LLM recover
36
37## Anti-Patterns
38
39### ❌ Vague Descriptions
40
41### ❌ Silent Failures
42
43### ❌ Too Many Tools
44
45## Related Skills
46
47Works well with: `multi-agent-orchestration`, `api-designer`, `llm-architect`, `backend`

Excerpt shown under the repository's MIT license.

More skills in claude-code-templates

Keep exploring

Similar skill repositories

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates