Single tool with critical gaps in description quality and schema documentation. The tool name 'search_vitepress_docs' is reasonably action-oriented (verb_noun convention), but the description is problematic: it contains prescriptive instructions ('Extract up to five keywords each English and native language, and define all of them as single words') rather than explaining what the tool does for the LLM. The input schema is minimal, only 'keywords' array with a basic description. No output schema is documented anywhere in the source code. The description is 177 characters, which falls within the acceptable baseline range (p10=34, p90=392), but the content is not LLM-optimized; it reads as user guidance rather than tool documentation. This violates the pattern:tool-description pattern which requires descriptions to explain WHAT the tool does, WHEN to use it, and any prerequisites. No parameter constraints (enums, min/max), no error handling guidance, no output structure definition.
Search VitePress Documents For This Product. Extract up to five keywords each English and native language, and define all of them as single words. e.g. Vitepress, API, Specification,Extensions etc.
Tool description contains prescriptive instructions for the user ('Extract up to five keywords...') instead of explaining what the tool does and when to call it. Descriptions must be written for LLM consumption, not user instruction.
No output schema documented. The tool's return structure is completely undocumented. LLMs cannot plan downstream uses or extract relevant fields without knowing what fields are returned, their types, and their meanings.
Input schema lacks depth. The 'keywords' parameter has only a basic type and description. Missing: minimum/maximum array length, keyword format constraints, examples, or guidance on supported languages. Parameter validation rules are entirely absent.
No error handling or recovery guidance. If a search returns no results, or if keywords are invalid, the tool provides no actionable error message to guide the LLM's next step.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | F | 47 | <=2025-11-25 | v2 |
| 2026-03-09 | F | 39 | - | v1 |