Arbitype provides 9 tools with basic descriptions and input schemas, but falls short of production quality. Tool names lack action verbs (evaluate, classify, score, check, verify, gate, review, route are generic or domain-specific without clear intent). Descriptions are present but minimal (10-50 chars), below the 50-200 char LLM-optimized baseline. Parameter descriptions exist but are terse. No output schemas documented. Error handling guidance is absent. The tools appear to be wrappers around a TypeSafe Jev evaluation engine rather than discrete, composable operations. No evidence of idempotency, pagination, or recovery patterns.

• Rename tools to verb_noun pattern with clear action intent. E.g., 'evaluate' → 'run_evaluation', 'classify' → 'classify_state', 'score' → 'score_state'. This helps LLMs parse intent from the name alone.
• Expand descriptions to 100-150 chars. Include WHAT the tool does, WHEN to use it (vs similar tools), and what it returns. E.g., 'Classify a state into one of several predefined labels using TypeSafe Jev. Use this when you need to assign a discrete category (e.g., sentiment, priority, status) to a piece of text or data. Returns the selected label ID and confidence score.'
• Document output schemas for all tools. Specify the structure of the response (e.g., {result: string, confidence: number, reasoning: string}). This enables LLMs to chain tools and extract fields.
• Add error handling guidance to descriptions. E.g., 'If questions are malformed, returns an error with details on which question failed. Retry after correcting the question structure.' This tells LLMs what to do on failure.
• Expand parameter descriptions with format and constraint details. E.g., 'state (object or string): The data to evaluate. If object, must be valid JSON. If string, max 10000 chars. Required.' and 'questions (object): Dictionary mapping question IDs (string) to question definitions. Each definition must include: type (string), instructions (string), and optional criteria/options/levels (object/array).'