site

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

With no annotations provided, the description carries the full burden of disclosing behavior. It states the operation is a lookup/return but does not mention whether the action has side effects, requires authentication, or is part of a stateful flow. The description also doesn't indicate what happens on invalid input or whether the 'return' is purely read-only.

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 compact sentence with no filler. It front-loads the core action (return next question or verdict) and includes the key input parameters, making it easy to parse quickly.

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 2-parameter tool with no output schema, the description covers the basic operation but lacks crucial context: it doesn't mention that this is part of a sequence (likely after checker_start), how the returned next question is formatted, or what the final verdict looks like. An agent might call it in the wrong order or misinterpret the response.

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 adds modest meaning by clarifying that 'question' is an id and 'choice' is an index. However, it doesn't explain what the question id refers to, what the choice index indexes into (e.g., an array of options from a previous question), or any constraints beyond the schema's minimum 0.

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 uses a specific verb ('return') and identifies the resource ('the next question or the final verdict'), clearly stating what the tool does. However, it doesn't explicitly distinguish this from sibling tools like checker_start or checker_tree, which could be confused as similar navigation steps.

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 when to use the tool (after receiving a question, choose an option to advance) but doesn't explicitly state when not to use it or mention alternatives. There is no guidance about prerequisites, such as needing to call checker_start first, which an agent would benefit from knowing.

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 of behavioral disclosure. It says the tool is 'the first question' but does not state what happens when invoked—whether it returns a question, initializes a session, or produces any output. The description is a static characterization rather than a disclosure of behavior, leaving side effects and return behavior unexplained.

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 short sentence, so it is compact. However, it is on the edge of under-specification, omitting an action verb and any behavioral detail. It is not overly verbose, but it does not fully earn its place as a complete tool definition.

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 is simple (no parameters), but there is no output schema and no annotations. The description does not mention return values, the overall decision guide flow, or how this first question connects to checker_answer or checker_tree. An agent would be left guessing at the interaction pattern beyond 'first question.' The sibling names hint at a flow, but the description itself is incomplete for a confident 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 tool has zero parameters, so the schema and description have nothing to clarify. The baseline of 4 applies because no parameter explanation is needed, and the description does not need to compensate for any undocumented parameters.

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 the tool as 'The first question of the Exit readiness checker decision guide,' which names a specific resource and its position in a sequence. However, it uses a noun phrase rather than a verb, so it does not explicitly state an action like 'starts the guide' or 'returns the first question.' It is distinguishable from siblings by the word 'first,' but the lack of a clear verb makes the purpose slightly vague.

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?

There is no guidance on when to use this tool versus alternatives. The sibling list includes checker_answer and checker_tree, which likely belong to the same flow, but the description does not say 'use this to begin' or 'use instead of...'. The 'first question' wording weakly implies sequencing, but no explicit usage direction or exclusions are provided.

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 provided, the description carries the full burden of behavioral disclosure, but it only describes content rather than behavior. It does not state that this is a read-only operation, what the output structure looks like, or how the tree is presented to the agent.

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 concise sentence with no filler. 'Every question, option and verdict' is information-dense, though 'for reasoning end to end' is somewhat vague and could have been replaced with a more concrete statement about output or use.

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 content-retrieval tool, the description conveys the main content and purpose sufficiently. However, with no output schema and no annotations, it leaves the output format and relationship to sibling decision-tree tools unspecified, so an agent must infer some context.

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 an empty input schema, so there are no parameter semantics to document. The baseline of 4 applies, and no information is missing in this dimension.

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 entire decision tree of the Exit readiness checker, including every question, option, and verdict. It distinguishes itself from step-oriented siblings like checker_start and checker_answer by signaling whole-tree content, though it lacks an explicit verb such as '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?

The description gives no explicit guidance on when to use this tool versus checker_start or checker_answer. The phrase 'for reasoning end to end' implies whole-traversal use, but there is no stated when-to-use, when-not-to-use, or mention of 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 present, the description carries the full burden of behavioral disclosure. It meaningfully discloses key traits: the enquiry is free, no payment is made, no quote is guaranteed, and it returns who receives the details, consent wording, and confirmation method. This goes well beyond a simple 'describes' statement, though it does not explicitly address whether the tool itself has side effects (e.g., whether it sends anything).

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 uses short, punchy sentences that each convey a distinct fact. There is slight redundancy with the title (both mention 'not a purchase, not a guaranteed quote'), but the repetition is justified as a reinforcing safety message. Overall it is tight and easily scannable.

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 simple 0-parameter describe tool with no output schema, the description covers the essential ground: what it explains, what the user can expect, and what the returned explanation contains. It could more explicitly connect to the wider enquiry flow (e.g., 'use before enquiry_fields'), but 'Read first' plus naming submit_enquiry provides enough context 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 tool has 0 parameters and 100% schema coverage, so the baseline is 4. There are no parameter definitions to clarify. The description instead focuses on return content, which is appropriate here since parameter semantics are irrelevant.

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 explicitly states the tool's function: 'States plainly what submit_enquiry does on Sellable Score.' The verb 'states' plus the resource 'what submit_enquiry does' makes the purpose unambiguous. It also differentiates from siblings by clarifying it is not the actual submission tool and that no purchase or guaranteed quote is involved.

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 phrase 'Read first' gives a clear usage signal: this tool should be used before submit_enquiry. It also clarifies what the tool does not do ('Nothing is bought, ordered or paid; no quote is guaranteed'), which helps distinguish it from purchase or quote tools. However, it does not explicitly name alternative sibling tools or provide exclusion conditions for checker_* or enquiry_fields.

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 behavioral burden. It communicates the informational payload and implies a read-only schema lookup, and it explains how the output feeds submit_enquiry. However, it never explicitly states that the tool has no side effects or what the response structure looks like.

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 tight sentences with no filler. The field contents are front-loaded and the workflow linkage is placed at the end, making the description easy to scan and act on.

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 introspection tool with no output schema, the description covers what is returned and how to use it with submit_enquiry. It omits an explicit verb and response format, but these gaps are low-risk given the simple, no-input context.

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 has zero parameters, so there are no parameter semantics to document. The description adds practical meaning by explaining that the returned field keys are the keys to use when submitting answers.

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 the resource (Sellable Score enquiry fields) and precisely enumerates what is exposed: key, label, type, required, help text, and allowed options. It lacks an explicit operational verb like 'list' or 'get', which prevents a top score, but it clearly differentiates from submit_enquiry by explaining how the data is meant to be used.

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 final sentence gives concrete workflow guidance: use this tool's field keys when passing answers to submit_enquiry. It provides clear context but does not explicitly contrast this tool with siblings such as enquiry_describe or checker_start.

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 provided, the description carries the full burden, and it does so thoroughly. It discloses validation behavior, the returned confirmation token, the email-with-link requirement, and the condition that providers only see the enquiry after 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 long but every sentence earns its place: it front-loads the critical exclusions, then gives a clear step-by-step protocol, and finishes with the exact consent wording. 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 two-step tool with no output schema and nested parameters, the description is remarkably complete. It explains step-1 return values (summary, consent line, confirmation token), step-2 execution, and the email-link prerequisite—everything needed to call the tool 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 schema already covers parameters well (100% coverage), so the baseline is 3. The description adds meaningful operational context beyond the schema by explaining that answers must key off enquiry_fields and by clarifying exactly when each parameter, especially confirmation, is used across the two steps.

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 action ('Submits an enquiry'), a target resource ('Sellable Score'), and clarifies what it is NOT ('NOT a purchase, NOT a guaranteed quote'). It also references enquiry_fields, helping distinguish this from related 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 two-step calling sequence is explicitly described with exact conditions: call first with answers+consent, show the summary and consent line, then call again only if the person agrees. The description also states when not to use the tool, i.e., it is not for purchase or quote requests.

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