site

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

No annotations are provided, so the description must carry the burden. It discloses the basic behavior (returns next question or verdict) but does not explain side effects, state changes, or whether answers are recorded persistently. It doesn't clarify if the same question id can be reused, if the choice index is zero-based (schema suggests minimum 0), or what happens on invalid input. The description is too thin to inform an agent about the tool's operational behavior.

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 single sentence, front-loaded with the core action ('Given a question id and the chosen option...'). It is concise and to the point, earning its place. However, it could be more structured by naming the success/failure return cases explicitly, but for a short description it is efficient.

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?

The tool has 2 required parameters, no annotations, and no output schema. The description explains the purpose but not the full context: what does the agent need to know about the flow? For instance, does 'final verdict' mean success/failure? Are there multiple question types? Is the outcome deterministic? With no output schema and minimal behavioral disclosure, the description is incomplete for an agent to call this tool reliably in a multi-step workflow.

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 compensate. It mentions 'question id' and 'chosen option (its choice index)', which maps directly to the 'question' and 'choice' parameters, adding context that the schema lacks (e.g., choice is an index, question is an id). However, it doesn't explain the format of the question id (e.g., is it a string like 'Q1' or a UUID?) or whether it's a reference from a previous response. Thus it adds some value but leaves gaps.

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 specific verb ('return') and resource ('next question or the final verdict'), and differentiates from siblings by mentioning question id and choice. However, it is slightly vague about what 'final verdict' means and doesn't explicitly distinguish from siblings like checker_tree or checker_start. The title adds some context but the description could be clearer about the tool's unique role.

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 usage: after answering a question, use this to get the next step. But it provides no explicit guidance on when to use this tool versus alternatives like checker_start or checker_tree. There are no stated prerequisites, exclusions, or scenarios. The agent must infer the context from the tool name and sibling list, which is insufficient.

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 full burden of behavioral disclosure. It does not state what invoking the tool does—whether it starts a session, presents a question, advances state, or returns data. The noun-phrase description leaves the actual behavior largely implied.

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 single sentence with no filler and it front-loads the essential role of the tool. It earns its place, though it is too sparse to provide deeper 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 no output schema and no annotations, the description should explain what the agent will receive and how to proceed. It only says 'first question' without clarifying the response format or the next step, so an agent has incomplete guidance for using this tool effectively.

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 schema description coverage is 100%, so there is no parameter documentation burden for the description to carry. Nothing is missing here.

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 resource—the EV charger checker decision guide—and states that this tool is the first question, making it clear this is the entry point. It does not use an explicit action verb like 'starts' or 'initiates', but the title 'Start' and the phrase 'first question' make the purpose reasonably clear. It also implicitly distinguishes itself from answer/tree siblings.

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?

Usage is implied: call this tool first when beginning the EV charger checker decision guide. However, there is no explicit guidance about when not to use it, no mention of alternatives, and no indication of how it connects to checker_answer or checker_tree.

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 conveys that the tool exposes static guide content, implying a read-only operation, but does not describe output shape, size, or whether the entire tree is returned at once. This is acceptable but not detailed.

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 single, well-structured sentence that communicates scope and intended use without filler. It is front-loaded with the key information that this is the complete decision tree.

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 parameterless tool, the description is reasonably complete: it states the content scope and the reasoning purpose. It does not explain the output format, and there is no output schema, but the 'decision tree' concept sufficiently implies a structured representation.

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, so there is no parameter semantics burden. A baseline of 4 is appropriate because there is nothing for the description to clarify about inputs.

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 tool's resource: the complete EV charger checker decision tree, including every question, option, and verdict. It distinguishes itself from siblings like checker_answer and checker_start by emphasizing the 'whole' tree, though it lacks an explicit verb like 'retrieve' or 'return'.

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?

'For reasoning end to end' provides a clear context for when to use the tool: when an agent needs the full guide rather than a single step/answer. It does not explicitly mention alternatives or exclusions, but the purpose is evident enough from the wording.

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 burden, and it does disclose key behavioral facts: nothing is bought, ordered, or paid; no quote is guaranteed; it is free; and it returns who receives details, the consent wording, and confirmation method. It does not explicitly state that enquiry_describe itself is read-only or side-effect free, but the descriptive framing implies it.

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 sentence adds useful content about the enquiry's behavior or return value. It is slightly redundant with the title's mention of 'not a purchase, not a guaranteed quote,' but overall it is compact and well-ordered.

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 zero-parameter informational tool with no output schema, the description is quite complete: it states what the related submit_enquiry does, what it does not do, and what this tool returns. It could be more precise about the exact return format, but that is a minor gap for a descriptive tool.

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 schema description coverage is 100%, so the baseline is 4. The description adds no parameter-specific information, but none is needed because there are no parameters to explain.

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 and resource: it 'states plainly what submit_enquiry does on Which EV Charger,' and clarifies the expected outcome (an enquiry, not a purchase or guaranteed quote). It does not explicitly differentiate itself from sibling tools like submit_enquiry or enquiry_fields, so it falls short of a 5, but the purpose is clear and non-tautological.

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 directive to use this tool before proceeding with submit_enquiry, and the description explains what to expect from that submission. It gives clear context but does not spell out when not to use this tool or name alternatives, so it lacks the full exclusionary guidance needed for a 5.

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 full behavioral burden. It discloses the complete set of returned attributes and notes that options are included only where they exist. The read-only nature is implied by the content and phrasing, though not explicitly stated; this is a minor gap.

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 with no filler. The first sentence front-loads the exact content of the response, and the second sentence gives a clear downstream use. Every word 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?

For a parameterless introspection tool, the description is complete: it names the enquiry, lists all field metadata returned, and explains how to use the field keys with submit_enquiry. No output schema or annotations are present, but the description covers what an agent needs to know to call and consume this tool.

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, so parameter semantics are trivially satisfied and the baseline is 4. The description adds value by explaining how the output keys relate to submit_enquiry, which is more than an empty schema requires.

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 — 'Every field of the Which EV Charger enquiry' — and enumerates exactly what is exposed: key, label, type, required, help text, and options. It lacks an explicit action verb like 'retrieves' or 'lists', and it does not differentiate itself from siblings such as enquiry_describe, so it stops short of a 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 description provides practical usage context: 'Pass answers to submit_enquiry keyed by field key.' This tells an agent why it would call this tool and how the result feeds another tool. It does not explicitly address when not to use it or contrast it with sibling tools, so the guidance is useful but not exhaustive.

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 present, the description carries the full disclosure burden and meets it: it explains validation before submission, the returned summary/consent/token, the required consent line, and the post-submission email-link requirement. It also clarifies that no provider sees the enquiry until the person clicks the link.

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 longer than average but every sentence earns its place: the non-purchase disclaimer is front-loaded, and the two steps are clearly numbered. The consent line is repeated verbatim, which removes ambiguity about what consent means.

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 consent-sensitive two-step submission with no annotations and no output schema, this description gives enough guidance to call the tool correctly end-to-end. It covers prerequisites, the two call phases, the consent text, and the delivery/visibility outcome; missing error-handling details are not essential 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?

The schema already describes all three parameters (100% coverage), so the baseline is 3; the description adds useful sequencing by tying 'confirmation' to the step-1 return value and 'answers' to enquiry_fields. It does not exhaustively redefine the parameter types, but it gives the agent the workflow context needed to populate them correctly.

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 a specific action ('submits an enquiry') and a specific target ('Which EV Charger', human providers), and explicitly disambiguates from a purchase or guaranteed quote. This separates it from the sibling enquiry_describe/enquiry_fields tools by outcome, so an agent knows what this tool is for.

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 provides a precise two-step invocation protocol, states the condition for proceeding to step 2 ('only if the person agrees'), and gives a when-not boundary ('NOT a purchase, NOT a guaranteed quote'). It also points to enquiry_fields as the source of answer keys, giving the agent the surrounding workflow context.

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