skill

agent-tool-builder · davila7 — Claude Code skill: what it does, how to install

Q: How do I install agent-tool-builder in Claude Code?

Run `npx claude-code-templates@latest --skill ai-research/agent-tool-builder` in your terminal. This downloads and registers the skill in your project.

Q: Which skills work well alongside agent-tool-builder?

It is designed to work with `multi-agent-orchestration`, `api-designer`, `llm-architect`, and `backend`.

Guides developers in designing tools, JSON Schema definitions, and error handling for AI agents. Useful when setting up function calling or MCP servers.

Install into Claude Code · claude-code-templates All methods and platforms ↓

npx claude-code-templates@latest --skill ai-research/agent-tool-builder

Open on GitHub

What agent-tool-builder does

Agents interact with external environments strictly through schemas and text descriptions. The model never inspects actual code. This skill establishes design guidelines for these boundaries, focusing on clear argument structures and informative error responses.

Ambiguous field descriptions inevitably cause model loops and balloon token costs. The skill highlights patterns to prevent silent failures and cluttered tool registries. It addresses input validation and the MCP interface format.

This guide pairs directly with multi-agent-orchestration and api-designer.

What it helps with

write clear JSON Schema definitions for agent tools
supply input examples that guide model invocations
structure recovery-friendly error messages when calls fail
detect anti-patterns such as silent failures and vague descriptions

Example prompts for the agent

Draft a JSON Schema specification with argument examples for a database query tool
Review my MCP tool description and add explicit error responses for network timeouts
Audit this tool configuration to eliminate ambiguous field descriptions

How to install agent-tool-builder

1claude-code-templates

npx claude-code-templates@latest --skill ai-research/agent-tool-builder

2Skills CLI (Vercel)

npx skills add davila7/claude-code-templates --skill agent-tool-builder -a claude-code

3Manually: put the files in place

~/.claude/skills/agent-tool-builder/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/agent-tool-builder/

Manually: put the files in place

.agents/skills/agent-tool-builder/SKILL.md

For all projects use ~/.agents/skills/

Manually: put the files in place

.cursor/skills/agent-tool-builder/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install davila7/claude-code-templates agent-tool-builder

2Manually: put the files in place

.github/skills/agent-tool-builder/SKILL.md

Platform CLI

gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/ai-research/agent-tool-builder

Manually: put the files in place

.devin/skills/agent-tool-builder/SKILL.md

The legacy .windsurf/skills/ path still works

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about agent-tool-builder

How do I install agent-tool-builder in Claude Code?

Run npx claude-code-templates@latest --skill ai-research/agent-tool-builder in your terminal. This downloads and registers the skill in your project.

What does the agent-tool-builder skill do?

It provides patterns for crafting tool definitions, JSON Schema structures, and informative error handling. These practices help prevent LLM hallucinations and reduce unnecessary token usage.

Which skills work well alongside agent-tool-builder?

It is designed to work with multi-agent-orchestration, api-designer, llm-architect, and backend.

agent-tool-builder by other authors comes first.

agent-tool-builder sickn33 A skill for writing tool schemas an agent can actually use: JSON Schema, descriptions, validation, error paths. Useful when it keeps calling the wrong function. CX Codex +1 961installs setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. 1,052,851installs ask-matt Matt Pocock Routes you to the right Matt Pocock skill or flow for the task at hand. Use it when you need a starting point for a feature, prototype, incoming issue, or hard bug. 766,587installs to-tickets Matt Pocock Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker. 711,230installs writing-plans Jesse Vincent This skill turns requirements for a multi-step task into an implementation plan before code changes begin. It helps when another engineer needs exact files, interfaces, and checks. CX Codex 282,859installs caveman-review JuliusBrussee Turns code review comments into one line per finding: location, problem, fix. Useful when a diff or PR needs a fast pass without the filler. CX Codex +1 411,800installs caveman-compress JuliusBrussee Compresses CLAUDE.md, todo lists, and other prose files into a shorter format while retaining a readable backup. CX Codex +1 411,500installs

From the same set804

The whole set →

optimize Analyzes active and past task orchestrations in Claude Code to detect bottlenecks, balance agent workloads, and surface parallel execution paths. 440installs performance Audits web performance in Claude Code: optimizes Core Web Vitals, enforces resource budgets, and tunes asset delivery. 438installs deslop Cleans AI-generated clutter from a branch before merging code. It inspects diffs against main to strip needless comments, type workarounds, and unneeded guards. 437installs flutter-expert Sets up Claude Code for cross-platform app engineering with Flutter 3.x and Dart 3. Helps handle state management, platform channels, and Impeller tuning. 437installs memory-search Searches conversation history and semantic memory across sessions. Helps agents recall earlier decisions before tackling new code. 434installs penetration-test A slash command that runs penetration testing on a web app, API or auth flow and returns a report with fixes. 434installs market-research-reports Generates 50+ page market analysis documents in LaTeX, compiled directly to PDF. Helpful for sizing market opportunities and writing investment theses. 433installs session-learning-capture A slash command that pulls lessons out of the current Claude session and writes them into the project's memory files, so the next run starts informed. 425installs