agent-tool-builder

教你从 schema 到错误处理设计高质量、稳健的代理工具接口。

教你如何为 LLM 代理设计稳健的工具接口，从 JSON Schema 到描述写法、校验和错误处理全覆盖，目的是让代理少胡言、少失败并节省 tokens。在把外部 API 或内部能力暴露给代理时使用，能显著提高代理的可靠性和可用性。重点是写出能让模型理解的字段描述、清晰的输入校验和一致的错误反馈规范。

# Agent Tool Builder

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 implementations.
The LLM never sees your code - it only sees the schema and description.

## Principles

- Description quality > implementation quality for LLM accuracy
- Aim for fewer tha