The Tool Schema Linter is a specialized audit tool for developers building agentic workflows and tool-calling applications. It analyzes your JSON function definitions against a rigorous set of rules designed to prevent LLM hallucinations, “lazy” tool selection, and security risks. By scanning your schema files, it identifies missing descriptions, untyped parameters, and overlapping tool signatures that often cause agents to fail in production. Writing perfect function schemas for LLMs is tedious and error-prone. While a basic prompt might catch a missing comma, this skill uses a structured heuristic engine to find logical flaws, such as too many tools for a single context window or free-form parameters that should be bounded to an enum for reliability. It saves hours of debugging “why the agent didn’t call the right tool” by ensuring your definitions are mathematically and semantically sound. Supported tools include Standard JSON function-calling schemas (OpenAI, Anthropic, Gemini formats), Local tool definition files (.json, .tool.json), Standard input streams for CI/CD integration, and Customizable rule thresholds via reference JSON files.
Tool Schema Linter
Lint the function-calling tool definitions your agent exposes.
Install
cmdop skills install agensi-tool-schema-linter