site

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

With no annotations, the description takes on the transparency burden and clearly discloses that nothing is bought/ordered/paid, that no quote is guaranteed, and that it is free. It also states what the response contains (recipient details, consent wording, confirmation mechanism); only a direct statement that this tool itself is side-effect-free is absent.

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 front-loaded with 'Read first' and every subsequent sentence earns its place: purpose, key caveats, and return-value contents. There is no filler or redundancy beyond the minimal repetition of the title's caveat.

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 an informational, zero-parameter tool with no output schema, the description is complete: it explains why to call it, what the underlying submit_enquiry does, what is not true about it, and what information the response will convey. An agent has enough context to invoke it 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?

The tool has zero parameters and the input schema already covers everything (100% coverage), so there is no parameter burden for the description. Baseline 4 applies; no parameter details could add value.

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 identifies a specific verb ('States plainly') and resource ('what submit_enquiry does'), and the title frames the deliverable as an explanation rather than a purchase or quote. This makes it immediately distinct from the sibling submit_enquiry, which is the action tool.

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?

'Read first' is an explicit positional cue to invoke this tool before submit_enquiry, and the caveats tell the agent what it will learn. It does not explicitly name when to prefer enquiry_fields or exclude alternatives, so it stops short of full routing guidance.

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?

No annotations are provided, so the description carries the behavioral disclosure burden; it describes a read-only enumeration of fields and their metadata, which is transparent enough for this simple introspection tool. It does not discuss edge cases such as missing help text or output ordering, but these are minor for a parameterless listing 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?

Two sentences pack the full output contract and the downstream usage without filler. The content is front-loaded as a single clear spec, and every sentence earns its place.

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 tool has no parameters and no output schema, the description explains the return contents in enough detail for an agent to call it and interpret the result, and it situates the result in the submission workflow. Nothing essential is missing for a task of this complexity.

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 tool has zero parameters and the input schema already covers that fully, so the baseline is 4. The description adds useful cross-tool semantics by saying field keys are the keys to use when passing answers to submit_enquiry, but no further parameter documentation is needed.

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 clearly identifies the resource ('the Latent Defects Insurance Cost enquiry') and the exact contents returned: key, label, type, required flag, help text, and allowed options. It is less explicit as an imperative action and does not explicitly differentiate from the sibling enquiry_describe, 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 gives actionable context by telling the agent to pass answers to submit_enquiry keyed by field key, establishing the tool's role in the workflow. It does not state when not to use it or compare it to enquiry_describe, so the guidance is clear but not fully explicit on alternatives.

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 no annotations, the description carries the full disclosure burden and does so well: it warns this is not a purchase or quote, explains validation in step 1, requires showing the consent line, and states that an emailed link must be clicked before any provider sees the enquiry. It also defines consent precisely.

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 detailed but every sentence earns its place: the non-purchase warning is front-loaded, and the two-step protocol is clearly separated. The quoted consent line is necessary for exact behavioral semantics rather than padding.

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 consequential submission tool with no annotations and no output schema, the description covers validation, human-approval steps, the confirmation token handoff, email-link requirement, and the exact consent meaning. Nothing essential is missing 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 already covers answers and consent, and the description adds crucial meaning: answers must be keyed by field key from enquiry_fields, consent has an exact quoted agreement, and confirmation is the token from step 1. This goes well beyond the baseline schema coverage.

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?

Description states a specific verb+resource ('submits an enquiry to Latent Defects Insurance Cost') and immediately distinguishes it from a purchase or guaranteed quote. It also separates it from sibling tools by describing the two-step confirmation flow, so an agent can identify when this tool is relevant.

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?

Explicit step-by-step guidance: step 1 call with answers and consent=true to get a summary/token, show the summary and consent line to the person, then step 2 call only after agreement with the same answers and confirmation token. It also references enquiry_fields for keying answers, which routes the agent to the correct sibling for field keys.

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