CKB provides 6 tools with mixed quality. Strengths: all tools have descriptions (10-200 chars) and input schemas with parameter types. Weaknesses: parameter descriptions are sparse or missing context; no output schemas documented; error handling guidance absent; tool composition unclear (annotation tools lack URI format guidance). Naming is verb-first and clear (annotationSet, annotationGet, getStatus, doctor, getAffectedTests), but parameter names lack consistency (symbol_uri vs baseBranch). No evidence of pagination on list tools, no response field documentation. The getAffectedTests tool has a poorly specified 'depth' parameter (numeric but no range guidance). Overall, definitions meet minimum viability but fall short of production-grade LLM-friendliness.

• Document the output schema for each tool. For annotationGet/Set, return: {key, value, author_id, confidence, created_at, updated_at}. For annotationList, return: {annotations: [{key, value, ...}], count, total}. For getStatus, specify all fields (backend_health, cache_metrics, presets, suggestions). For getAffectedTests, return: {tests: [{name, file, reason}], total_affected}.
• Add pagination to annotationList: include 'limit' (default 20, range 1-100) and 'cursor' parameters, and return a 'next_cursor' field or 'has_more' boolean.
• Constrain numeric parameters: depth in getAffectedTests should be 'Transitive dependency depth (1 - 5, defaults to 1)' with validation rejecting values outside that range.
• Clarify symbol_uri format: 'URI of the symbol in the format: namespace://owner/project/file:symbol (e.g., scip://go/github.com/user/repo/file.go:MyFunc)'. Add an enum or example if there are standard formats.
• Add error guidance to descriptions. Example for annotationSet: 'If the symbol is not found, an error response will suggest nearby symbols. If confidence is outside 0-100, returns a validation error with allowed range.'
• Document parameter relationships in getAffectedTests: 'If staged=true, analyzes uncommitted changes; baseBranch is used only when staged=false. useCoverage requires a coverage data source to be configured (check via getStatus).'
• Validate and document confidence bounds: 'Confidence score must be 0 - 100 (default 80). Values outside this range are rejected with a validation error.'