What problem does it solve? Agents select and call tools based solely on descriptions, so vague names, ambiguous parameters, and unhelpful error messages cause tool-selection failures that prompt engineering cannot fix. This Skill provides principles, templates, and utilities for designing tool interfaces that agents can use correctly. ## Core Features & Use Cases - Tool Description Engineering: Structure descriptions to answer what a tool does, when to use it, what inputs it accepts, and what it returns, with concrete format examples. - Consolidation and Architectural Reduction: Reduce overlapping tool sets into comprehensive or primitive general-purpose tools, backed by production evidence such as the Vercel case reducing 17 tools to 2. - Schema Builder and Evaluator: Use the included Python utilities to build tool schemas, render markdown descriptions, score description quality, and generate agent-recoverable error messages. - Use Case: When implementing MCP tools for a multi-server agent, apply the fully qualified ServerName:tool_name naming convention and audit descriptions against the five evaluation criteria before deployment. ## Quick Start Ask the agent to design a new tool schema for your agent system, including description, parameters, return format, and error handling, following the tool-design guidelines.
