Offline PPTX inspection and safe text replacement planning for AI agents.
Two tools with minimal descriptions (both under 100 chars) and incomplete parameter documentation. Tool names lack action verbs (inspect, plan-replace are weak). Input schemas present but parameters lack descriptions. No output schema documented. No error handling guidance. No tool annotations. Naming violates verb_noun convention, 'inspect' and 'plan-replace' are vague; 'get_pptx_text_summary' and 'preview_text_replacement' would be clearer. Both tools are read-only but lack idempotentHint annotations.
Summarize slide text as JSON or text.
Emit a JSON plan for exact text replacement without editing the file.
Tool names lack action verbs. 'inspect' and 'plan-replace' do not follow verb_noun convention. Should be 'get_pptx_text_summary' and 'preview_text_replacement' to clarify intent.
Parameter descriptions missing. 'pptx', 'format', 'find', 'replace' parameters have no descriptions in the schema. LLMs cannot infer what 'pptx' means (file path? file content?) or when to use 'format' enum values.
Output schema not documented. No schema definition for the JSON returned by either tool. LLMs cannot plan downstream calls or extract fields reliably.
No error handling guidance. Tools raise FileNotFoundError and ValueError but do not document what errors are possible, when they occur, or how to recover. E.g., 'Malformed PPTX slide XML' error is not surfaced to the LLM.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 33 | 2026-07-28+ | v2 |
Tool annotations missing. Both tools are read-only and idempotent but lack readOnlyHint and idempotentHint annotations in the schema.