Three simple tools with basic schemas and descriptions. All tools have input schemas with type definitions and descriptions present. However, parameter descriptions are minimal (10-15 chars), falling well below the 72-char baseline for A+ tools. Tool descriptions are adequate (40-70 chars) but lack context on WHEN to use each tool or dependencies between them. No output schema documentation. Error handling returns raw error messages without recovery guidance. Naming follows verb_noun convention (validate, to_13, to_10) but lacks clarity on the relationship between conversion tools, LLMs may not understand that to_13 and to_10 are inverses.
Convert an ISBN-13 (978 prefix only) to ISBN-10. Errors for 979 prefix.
Convert an ISBN-10 to ISBN-13 (978-prefixed).
Validate an ISBN-10 or ISBN-13. Spaces and dashes ignored.
Parameter descriptions are minimal (10-15 chars). Baseline for A+ tools is 72 chars. 'ISBN string to validate' and 'ISBN-10 string to convert' lack format constraints, examples of valid input, or guidance on spacing/dashes.
No output schema documented. LLMs cannot plan downstream operations or extract fields. validate() returns a ValidationResult object; to_13/to_10 return wrapped strings. Structure is inconsistent and undocumented.
Error messages lack recovery guidance. Errors like 'invalid ISBN: checksum failed' or 'ISBN-13 with prefix 979 has no ISBN-10 equivalent' do not suggest next steps. Per pattern:recovery-guide, errors should guide the LLM toward resolution.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 53 | 2026-07-28+ | v2 |
Tool relationships undocumented. to_13 and to_10 are inverses; validate is a prerequisite. Descriptions do not explain when to call each tool or how they compose. LLMs may not recognize that validate(input) should precede conversion attempts.
Input schema properties lack descriptions in the JSON Schema. The 'input' property has no 'description' field in the schema object, only in the tool description. Per pattern:tool-description, every parameter must have a description.