Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The annotations already mark the tool as non-read-only, and the operation names imply creation, but the description adds no behavioral context beyond that. It does not mention side effects on the drawing, error behavior, coordinate-system assumptions, or what happens after a successful operation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is compact, well-structured as a scannable operation list, and every line adds useful information. There is no filler or redundant restating of the schema.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the generic schema, the description is nearly complete: it covers all operations and their payload shapes. Minor gaps include undocumented behavior of include_screenshot and lack of explicit units or coordinate context, but these do not prevent correct operation selection.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema is generic and has 0% schema description coverage, so the description carries the full burden. It compensates thoroughly by defining the exact data object shape expected for every operation, including required fields and optional markers.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

The description names the resource ('Annotation') and enumerates six specific creation operations (text, dimension variants, leader), so an agent knows exactly what the tool does. It is clearly distinguishable from sibling tools like drawing, entity, and layer by its scope.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

The opening line 'Annotation: text, dimensions, and leaders' plus the operation list gives a clear context for when to use this tool. It does not explicitly name alternatives or exclusions, but the intended usage is obvious enough for an agent to select it appropriately.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With readOnlyHint=false, the description's listing of mutating operations (insert, update_attribute, define) is consistent with the annotation. It adds operation-level context but does not disclose side effects, coordinate assumptions, failure behavior, or what happens when metadata is updated.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is compact and front-loaded with a one-line summary followed by a structured operation list. Every operation gets a single line with its data payload, and there is no filler or redundant restating of schema fields.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a six-operation dispatch tool with a generic data field and no enums, the description provides the necessary operation vocabulary and rough data contracts. However, requiredness of fields like x/y/name is not marked, and deeper semantics for define and attribute operations are left vague.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description carries the parameter documentation burden, and it does so with per-operation data shapes including optional markers for scale, rotation, and block_id. It still leaves some fields under-specified, such as the entities array in define, attribute value types, and include_screenshot semantics, but the core data contracts are understandable.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

The opening line scopes the tool to block definition, insertion, and attribute management, and the operation list enumerates distinct verbs such as list, insert, define, get_attributes, and update_attribute. This clearly identifies the resource and actions, distinguishing it from sibling drawing, entity, and layer tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies block-related usage through the operation list, but it does not explicitly state when to use this tool versus siblings like entity or layer. There is no exclusion guidance or comparison to alternatives, so an agent must infer the appropriate context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations only supply readOnlyHint=false, and the description goes well beyond that: it warns that create erases ALL entities, that save/save_as_dxf/plot_pdf will not overwrite existing files or QSAVE over the open drawing without a flag, and that a new 'YYMMDD - name' path is suggested instead. This is exactly the destructive-behavior disclosure an agent needs before invoking a write tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with a one-line scope statement, then a scannable operation list, then a clearly headed safety block. It is long but nearly every line adds information; only the HP-specific flag names are opaque to a reader without context.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present, return values need not be explained, and the description covers all ten operations plus their destructive guardrails, which is sufficient for a multi-operation dispatcher. The only material omission is the undocumented include_screenshot parameter.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0% and the data object is untyped (additionalProperties), so the description carries the burden — it documents the per-operation data payloads ({name?}, {path}, {names: [...]}) and names the safety flags xac_nhan_xoa and ghi_de. The gap is include_screenshot, which appears in the schema but is never mentioned in the description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

States the resource (drawing file management) and enumerates ten concrete operations with their verb semantics (create, open, save, purge, plot_pdf, etc.), so an agent can map an intent to an operation without opening the schema. The operation list also implicitly distinguishes it from siblings like entity/layer/block tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives explicit preconditions for the risky operations (create refused on non-empty drawing unless data.xac_nhan_xoa=true; save/export refused unless data.ghi_de=true) which is real usage guidance. However, it never routes the agent between this tool and the sibling tools (entity, layer, block, view), so the when-to-use-this-vs-alternatives question is only implied by the operation list.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations only supply readOnlyHint=false, so the description carries the burden. The operation list correctly reflects mutating and read-only behaviors, but does not mention side effects, prerequisites such as an open drawing, or the meaning of the include_screenshot flag.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

The content is organized into Create/Read/Modify groups with one line per operation, and every line adds a signature or behavior. The summary sentence is front-loaded and there is no filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 19 operations and only 1 required schema parameter, the description covers most of what an agent needs to choose and call an operation. It would be more complete if it explicitly stated that operation must be set to one of the listed names and described include_screenshot.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With schema_description_coverage=0%, the operation-specific parameter shapes such as create_circle data: {cx, cy, radius} and offset data: {distance} provide crucial meaning absent from the schema. It still leaves some semantics implicit, such as angle/factor units and accepted operation strings.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

The opening line 'Entity creation, querying, and modification' names the resource and the three verb families, and the operation list makes the scope concrete. It lacks explicit differentiation from siblings like drawing or block, so it stops short of 5.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

It clearly signals this is the tool for entity-level operations such as create_line, list, move, and erase rather than drawing/session-level tasks. There is no explicit 'when-not-to-use' or direct pointer to a sibling, but the context is unambiguous.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With readOnlyHint=false, the annotations already signal mutation; the description goes further by itemizing mutating operations such as create, set_current, set_properties, freeze, thaw, lock, and unlock. It does not disclose side effects or reversibility, but the operation list provides meaningful behavioral detail beyond the annotation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a compact, front-loaded summary followed by a bulleted operation list with minimal syntax. Every line adds information, and it avoids redundancy with the schema.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a multi-operation layer tool with a sparse schema, the description covers the core call shape well: operation names and per-operation data. The output schema presumably handles return-value documentation, so the main remaining gap is the unexplained include_screenshot parameter and lack of explicit required-field notes. Overall it is adequate for an agent to invoke most operations correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must carry parameter meaning; it does so by listing valid operation strings and showing the expected data object shape for each operation (e.g., create data: {name, color?, linetype?}). However, it leaves include_screenshot completely undocumented and does not explicitly mark which fields within data are required.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with 'Layer creation and management' and then enumerates eight specific operations (list, create, set_current, set_properties, freeze, thaw, lock, unlock), making both the resource (layers) and the actions concrete. This clearly separates it from sibling tools like entity, block, or view.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

The operation list implies the tool is for any layer-management task, but the description never explicitly states when to choose it over a sibling tool or when not to use it. No prerequisites, exclusions, or alternative tools are mentioned, so usage guidance is only implicit.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description reveals that operations mutate the drawing by creating layers, inserting symbols, and connecting equipment, which is consistent with the readOnlyHint=false annotation. It does not disclose prerequisites such as whether setup_layers must be called first, coordinate system expectations, or the effect of include_screenshot. It adds operation-level behavior but not deeper behavioral context.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a tight, consistently formatted operation list with no filler. The domain statement is front-loaded, and every line adds a distinct operation or data shape. It is an excellent model of concise reference documentation.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a multi-operation dispatch tool, the description covers all operation names and their data payloads, and an output schema exists so return-value documentation is not essential. It is slightly incomplete around the include_screenshot parameter and setup ordering, but otherwise sufficient for correct invocation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, but the description lists the expected data keys for each operation, including optional fields marked with '?'. This substantially compensates for the generic schema. The only structured parameter not explained is include_screenshot, which prevents a 5.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

The opening phrase 'P&ID drawing with CTO symbol library' plus the enumerated operations (setup_layers, insert_symbol, draw_process_line, etc.) makes the tool's purpose concrete. It stops short of a clean single verb+resource statement and does not explicitly contrast with sibling drawing/layer tools, so it earns 4 rather than 5.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

The operation list implies when to use this tool, such as when inserting P&ID symbols or drawing process lines. However, it never explicitly states when to prefer this tool over sibling tools like drawing, layer, or block, and it gives no exclusions. Guidance is implied rather than explicit.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations declare readOnlyHint=true, yet the description explicitly describes state-changing behavior: init re-initializes the backend, execute_lisp runs arbitrary AutoLISP code, and batch can create entities. These operations contradict the read-only annotation; the safety rules do not resolve the inconsistency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is structured as a scannable operation list with compact one-line entries and a concrete batch example. It is appropriately sized for seven operations, with only minor redundancy between the status and health descriptions.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values need not be explained. But the readOnlyHint contradiction leaves an incorrect safety model, include_screenshot is undocumented, and the effects of init are only vaguely stated for a tool that can execute arbitrary code and mutate drawings.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must carry parameter meaning. It lists the allowed operation values and documents data shapes for execute_lisp and batch, including cho_phep_xoa, but never explains the include_screenshot parameter and leaves data unspecified for several operations.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

The description states the resource (server) and enumerates seven specific operations with distinct verbs such as status, health, init, execute_lisp, and batch. It distinguishes this tool from siblings by domain (system/server management versus drawing, entity, layer, etc.), though the umbrella term 'management' remains broad.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives operation-level guidance and explicitly says batch is for bulk drawing and faster than one call per entity, plus safety rules for erase/delete/purge. However, it does not state when to choose system over sibling tools or when not to use init/execute_lisp beyond the HP safety gate.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already provide readOnlyHint=true, lowering the burden; the description adds operation semantics and notes that get_screenshot returns a PNG. However, it does not disclose the coordinate space for zoom_window (model/world vs screen), whether coordinates are effectively required despite schema null defaults, or what happens if coordinates are omitted or passed with other operations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

A one-line purpose statement followed by three bullet-style operation lines; every sentence earns its place. The purpose is front-loaded, and each operation is a single scannable line with no redundant filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a dispatcher with an unconstrained operation parameter and no enums, the description supplies the critical operation vocabulary that the schema lacks, and the output schema presumably covers return values. However, it leaves notable gaps: coordinate semantics for zoom_window, whether coordinates are required for that operation, and whether the coordinate parameters should be null for the other two operations.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 0% schema description coverage, the description partially compensates: 'zoom_window — Zoom to window: x1, y1, x2, y2' maps the four numeric parameters to the operation that consumes them, and the Operations list is the only source of valid values for the unconstrained operation string. But it leaves coordinate ordering, units, and coordinate system unspecified, and does not clarify that x1/y1/x2/y2 are effectively required for zoom_window even though the schema marks them optional with null defaults.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a clear purpose ('Viewport control and screenshot capture') and enumerates three distinct operations, each with a specific verb, resource, and effect (zoom_extents, zoom_window, get_screenshot). It is immediately distinguishable from sibling tools like drawing, entity, or layer, which cover different AutoCAD domains.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

The operation list gives implicit selection guidance — zoom_extents for showing everything, zoom_window for a specific region, get_screenshot for capturing PNG output. However, there is no explicit when-to-use wording, no exclusions, and no stated alternative among the sibling tools; the domain separation from drawing/entity/layer/block is only implied by names.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.