Single tool with minimal definition quality. Tool name 'add_two_numbers' lacks action verb clarity (should be 'sum_integers' or 'calculate_sum'). Description is adequate (44 chars, within 10-1024 range) but generic. Critical failure: input parameters 'lhs' and 'rhs' have NO descriptions (null values in schema). No output schema documented. No error handling guidance. No parameter constraints or validation hints. Naming is awkward ('lhs'/'rhs' are mathematical abbreviations, not user-friendly identifiers like 'first_number'/'second_number'). This tool would score ~32 individually.
Calculate the sum of two integers
Input parameters lack descriptions. 'lhs' and 'rhs' have null descriptions in schema, violating pattern:tool-description requirement that every parameter must have a non-empty description.
Parameter names use mathematical abbreviations ('lhs', 'rhs') instead of user-friendly identifiers. Should be 'first_number' and 'second_number' to match chat data model and reduce LLM confusion.
No output schema documented. LLMs cannot plan downstream operations or validate return type. Should document that tool returns an integer sum.
No error handling or validation guidance. Tool lacks constraints on numeric ranges, timeout behavior, or recovery instructions if operation fails.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 36 | 2026-07-28+ | v2 |
Tool name 'add_two_numbers' lacks clear action verb. Verb-noun pattern (e.g., 'sum_integers', 'calculate_sum') helps LLMs parse intent from name alone.