Gaze is a browser automation tool with 22 tools covering navigation, element interaction, and session management. Critical gaps: (1) Most tool descriptions are extremely brief (5-15 chars), far below the 50-200 char baseline for LLM optimization. E.g., 'goto' = 'Navigate to a URL' (18 chars), 'map' = 'Extract interactive elements from the page' (41 chars). (2) Input schemas are present but minimal, most parameters lack detailed constraints, ranges, or format guidance. E.g., 'url' param has no validation hints; 'selector' params lack CSS selector format guidance. (3) No output schemas documented anywhere, LLMs cannot predict what these tools return. (4) No error handling guidance, tools like 'eval' and 'upload' have high risk but no recovery hints. (5) Parameter descriptions are generic; e.g., 'filter' in 'map' says 'Optional filter for element types' but does not enumerate valid types. (6) No idempotency or side-effect declarations despite many WRITE operations. (7) Tool composition is weak, 'login' and 'session' both manage auth but lack clear distinction. Average per-tool score: 38/100.

• Expand all tool descriptions to 50-200 characters. Include WHAT the tool does, WHEN to use it, and any prerequisites. E.g., 'goto' → 'Navigate to a URL and wait for the page to load. Use this to start a new browsing session or move to a different page. Returns the page title and URL.'
• Document output schemas for all tools. Specify what fields are returned, their types, and which fields are safe to pass to downstream tools. E.g., 'map' should return [{selector, text, type, clickable}] so LLMs know what to extract.
• Add parameter constraints and format guidance. Use enums for 'key' in 'press' (list valid keys), 'command' in 'session' (list/load/save/delete), and 'direction' in 'scroll' (up/down/left/right). Add regex patterns or format hints for 'selector' and 'url'.
• Add error handling guidance to high-risk tools. E.g., 'eval' → 'If the code throws an error, the error message is returned. Wrap code in try-catch to handle exceptions gracefully.' 'upload' → 'If the file does not exist or is too large, an error is returned with the reason.'
• Clarify tool composition. Rename 'session' to 'manage_session' and document each command separately. Add a 'confirm_before_execute' pattern for destructive commands like 'session delete' to prevent accidental data loss.