Two tools with minimal descriptions and incomplete schemas. quickEcho has a basic description (24 chars) and proper schema. longRunningTool lacks required parameter descriptions, has an empty required array despite 'steps' being used, and its description (67 chars) is vague about behavior. Neither tool documents output structure or error handling. No parameter descriptions exist. Tool names lack action verbs (quickEcho is generic; longRunningTool is compound). No error recovery guidance. Schemas present but incomplete, missing parameter descriptions entirely.
Simulates a multi-step process, sending partial updates
Echoes a text back to you
Tool names lack action verbs. 'quickEcho' is generic; 'longRunningTool' is compound and vague. Should be 'echo_text' and 'run_multi_step_process' or similar.
No parameter descriptions. 'text' and 'steps' parameters lack explanations of what they control, expected format, or constraints. LLMs cannot infer meaning from names alone.
longRunningTool has 'required: []' but code uses 'args.steps || 5'. Either add 'steps' to required array or document the default behavior in the parameter description.
Output schemas not documented. Tools return content arrays but LLMs have no schema to understand the structure. Document return types for both tools.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 29 | <=2025-11-25 | v2 |
No error handling guidance. If a tool fails, the LLM receives only 'isError: true' with no recovery path. Add actionable error messages and recovery suggestions.