Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
davila7 avatar

Agent Tool Builder

  • 522 installs
  • 29.9k repo stars
  • Updated July 27, 2026
  • davila7/claude-code-templates

agent-tool-builder is a Claude Code skill that designs JSON Schema tool definitions, descriptions, validation, and error responses for developers who need Claude-style agents and MCP tools to call functions reliably with

About

agent-tool-developer is an agent skill for developers shipping AI products who need tools that work on the first call—not loops, silent failures, or mystery 10x token bills. It treats the schema and natural-language description as the real API surface, because models never execute your Python; they only choose arguments against what you documented. You get patterns for crisp JSON Schema, examples that steer usage, validation boundaries, and errors that teach the model how to retry. MCP is framed as the practical lingua franca when you want the same tool usable across Claude Code, Cursor, and other hosts. Use it while defining new capabilities in Build, and again in Ship or Operate when tightening production tool contracts after real agent traces.

  • Centers design on what the LLM reads: schema and descriptions, not hidden implementation
  • Covers JSON Schema patterns for unambiguous parameters and recoverable errors
  • Documents input examples and description writing that reduce hallucinated calls
  • Includes MCP tools as the emerging standard for agent-world interfaces
  • Calls out anti-patterns: vague schemas, silent failures, and token-wasting tool loops

Agent Tool Builder by the numbers

  • 522 all-time installs (skills.sh)
  • +20 installs in the week ending Jun 18, 2026 (Skillselion tracking)
  • Ranked #1,701 of 16,659 AI & Agent Building skills by installs in the Skillselion catalog
  • Security screen: LOW risk (skills.sh audit)
  • Data as of Jul 28, 2026 (Skillselion catalog sync)
npx skills add https://github.com/davila7/claude-code-templates --skill agent-tool-builder

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs522
repo stars29.9k
Security audit3 / 3 scanners passed
Last updatedJuly 27, 2026
Repositorydavila7/claude-code-templates

How do you design reliable agent tool schemas?

Design JSON Schema tool definitions, descriptions, validation, and error responses so Claude-style agents call functions reliably—including MCP-shaped tools.

Who is it for?

Backend and AI engineers defining agent function catalogs who need schemas and descriptions that reduce hallucinated arguments, loops, and silent tool failures.

Skip if: Developers only implementing business logic inside tools without touching schema design, descriptions, or MCP registration contracts.

When should I use this skill?

A task involves designing agent tools, JSON Schema for LLM functions, MCP tool shapes, or fixing unreliable tool-calling behavior.

What you get

JSON Schema tool specs with LLM-oriented descriptions, validation rules, and standardized error response shapes ready for agent or MCP registration.

  • JSON Schema tool definitions
  • MCP-compatible tool manifests

Files

SKILL.mdMarkdownGitHub ↗

Agent Tool Builder

You are an expert in the interface between LLMs and the outside world. You've seen tools that work beautifully and tools that cause agents to hallucinate, loop, or fail silently. The difference is almost always in the design, not the implementation.

Your core insight: The LLM never sees your code. It only sees the schema and description. A perfectly implemented tool with a vague description will fail. A simple tool with crystal-clear documentation will succeed.

You push for explicit error hand

Capabilities

  • agent-tools
  • function-calling
  • tool-schema-design
  • mcp-tools
  • tool-validation
  • tool-error-handling

Patterns

Tool Schema Design

Creating clear, unambiguous JSON Schema for tools

Tool with Input Examples

Using examples to guide LLM tool usage

Tool Error Handling

Returning errors that help the LLM recover

Anti-Patterns

❌ Vague Descriptions

❌ Silent Failures

❌ Too Many Tools

Related Skills

Works well with: multi-agent-orchestration, api-designer, llm-architect, backend

Related skills

How it compares

Pick agent-tool-builder when the bottleneck is tool schema and description design rather than general prompt engineering alone.

FAQ

What does agent-tool-builder cover beyond implementation?

agent-tool-builder focuses on JSON Schema fields, LLM-facing descriptions, validation rules, and error response contracts so agents pick and call tools correctly, treating descriptions as critical to reliability.

Does agent-tool-builder support MCP tools?

Yes—agent-tool-builder includes MCP-shaped tool design guidance so developers can align function definitions with the emerging MCP standard used across Claude-style agent integrations.

Is Agent Tool Builder safe to install?

skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.

AI & Agent Buildingagentsautomation

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.