API design for agents

Design tools and MCP servers that agents use well

This skill guides the design of tools an agent calls. It covers writing descriptions the agent can choose from, input schemas, response formats, error messages the agent can recover from, naming rules for MCP tools, and when to merge overlapping tools into fewer ones. It includes a tool audit checklist and ways to test and improve tools with an agent.