Agent Tool Builder

davila7/claude-code-templates/cli-tool/components/skills/ai-research/agent-tool-builder

作者 davila78da17d671b6f無授權條款32K 個星標收錄於 2026年10月8日更新於 2026年10月8日儲存庫今天更新

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

僅含說明AI & Agents
AI 產生的概覽

指導 AI 代理工具設計:JSON Schema、描述撰寫、驗證、錯誤處理與 MCP 標準。

功能
這項技能為 AI 代理呼叫的工具設計提供指引,涵蓋 JSON Schema 設計、給大型語言模型看的描述撰寫、輸入範例、驗證與錯誤處理。它也談到 AI 工具的 MCP 標準,並列出模糊描述、無聲失敗、工具過多等反面模式。這是一項只有說明的技能,產出的是設計指引,而不是程式碼或檔案。
適用情境
在定義或檢視供大型語言模型代理呼叫的工具時使用,例如函式呼叫介面或 MCP 工具。當代理因為工具結構或描述不清而出現幻覺、迴圈或無聲失敗時也適用。
執行需求
不需要指令碼或執行環境相依項目,僅為說明性技能。使用前提是熟悉 JSON Schema 與代理工具呼叫相關概念。

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

來源與署名

來源:davila7/claude-code-templates位於cli-tool/components/skills/ai-research/agent-tool-builder提交8da17d6

授權條款: 無授權條款

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架