Single tool 'add' has critical definition gaps. Tool name lacks action verb (should be 'add_numbers' or similar). Description is minimal (11 chars, below 20-char threshold). Parameters 'a' and 'b' have null descriptions, violating the requirement that every parameter must have a non-empty description. No output schema documented. No error handling guidance. Naming is ambiguous, 'add' alone doesn't clearly signal arithmetic operation vs. other meanings.
Add two numbers together.
Tool name 'add' lacks action verb prefix. Should be 'add_numbers' or 'compute_sum' to clearly signal arithmetic operation and match LLM parsing conventions.
Tool description is 11 characters ('Add two numbers together.'), below 20-char minimum. Expand to explain WHEN to use this tool and what it returns.
Parameters 'a' and 'b' have null descriptions. Every parameter must have a non-empty description explaining what it controls. This is a critical violation of pattern:tool-description.
No output schema documented. LLMs need to know the return type and structure. Document that this tool returns an integer sum.
No error handling or validation guidance. Tool should document constraints (e.g., integer range limits) and what happens on overflow or invalid input.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 25 | 2026-07-28+ | v2 |