Telegram Agent by Nova (CIVAI)

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

No annotations are provided, so the description carries the full burden. It discloses what gets cleared (seen handles / WA progress), which is useful, but says nothing about reversibility, permission requirements, or side effects on in-progress scans (e.g., continue_scan). For a destructive operation with zero annotation coverage this is a significant 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?

One compact sentence with the imperative verb front-loaded and no wasted words. Its brevity, however, edges toward under-specification rather than true conciseness.

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?

A destructive, zero-annotation, no-output-schema tool with an undocumented parameter requires more context than this provides. The description omits the safety profile, parameter semantics, and any relationship to the scan workflow it affects.

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 single required parameter (agent_id) is undocumented in the schema. The description only alludes to 'an agent' without specifying format, source, or whether it accepts names versus IDs, so it fails to compensate for the coverage gap.

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 a specific verb and resource ('Clear Leads Discovery scan cache') and clarifies what is being cleared ('seen handles / WA progress'), which helps distinguish it from siblings like delete_scans. However, it does not explicitly differentiate itself from the closely related delete_scans or explain the scope of 'cache' versus scan records.

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?

No guidance on when to clear the cache versus using delete_scans, delete_scan_schedule, or any other sibling. No prerequisites or conditions are stated, leaving the agent to infer when this destructive operation is appropriate.

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. It says a paused scan is continued but does not state whether this resumes, restarts, or mutates the scan, whether it needs specific permissions, whether the pause state is consumed, or what happens on failure. For a mutation tool with zero annotation coverage, this is a significant 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?

A single, front-loaded sentence with no filler. It is efficient, though its brevity contributes to the surrounding documentation gaps rather than being a purely positive trait.

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 4-parameter mutation tool with no annotations, no output schema, and 0% schema coverage, the description is far too thin. It omits required-parameter meaning, the effect of continuing, and success/failure behavior.

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% with 4 parameters. The description only vaguely gestures at 'selected_resources' (groups/targets) and says nothing about agent_id, scan_id, or the optional max_contacts_per_group, so it fails to compensate for the completely undocumented schema.

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 (continue) and resource (a scan paused for selection), plus names the kinds of resources involved. However, it doesn't distinguish this tool from siblings like run_scan or trigger_scan_schedule, and 'paused for selection' is domain jargon an agent may not fully parse.

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 phrase 'paused for selection' implies the tool is only used after a scan has reached a selection state, which gives some conditional guidance. But there is no explicit when-to-use/when-not-to-use statement and no mention of alternatives such as run_scan.

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 must carry the full behavioral burden for a mutating create operation. It does not state required permissions, side effects, default values, what happens when a schedule already exists, or what the two outreach modes actually change. The parenthetical adds a small behavioral hint but is far from sufficient for a 14-parameter creation 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?

The description is a single front-loaded sentence with no wasted words. It is efficient, though the parenthetical is slightly opaque and the overall size is arguably too small for the complexity of the tool.

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 create tool with 14 parameters, a nested object, no annotations, and no output schema, the description is grossly incomplete. It does not explain required fields, scheduling behavior, mode selection, or any operational constraints, leaving the agent with almost no context beyond the tool's name.

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% across 14 parameters, including a nested object, so the description would need to compensate heavily. It only loosely hints at the auto_import/auto_outreach distinction via 'Import Only or Message now outreach', without naming parameters, accepted values, required fields, or formats. Most parameter meaning remains undisclosed.

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 ('Create') and resource ('auto-scan schedule'), and the parenthetical names two schedule modes ('Import Only' vs 'Message now outreach'). This clearly distinguishes it from sibling tools like update_scan_schedule, trigger_scan_schedule, and delete_scan_schedule. It is not a tautology, but the parenthetical is cryptic rather than fully explanatory.

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 choose this tool over update_scan_schedule, trigger_scan_schedule, or run_scan. The two modes are mentioned but not framed as usage conditions or prerequisites, leaving the agent to infer everything from the name alone.

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. It usefully discloses scope ('completed scan runs', not schedules), but says nothing about irreversibility, required permissions, or what happens to associated results. Partial behavioral context 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?

A single front-loaded sentence with the scope boundary in parentheses. No wasted words, and the key constraint is immediately visible.

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 destructive mutation tool with no annotations, no output schema, and 0% parameter documentation, the description does far too little. It should at minimum cover irreversibility and parameter semantics, which are entirely absent.

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 both required parameters (agent_id, scan_ids) are completely undocumented in both schema and description. The description adds no meaning about what a scan_id is, the batch semantics of the array, or the agent_id's role.

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 a specific verb (delete) and resource (completed scan runs), and explicitly contrasts with the sibling delete_scan_schedule by noting it does not delete schedules. An agent can distinguish this from the schedule-deletion tool without opening either schema.

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 parenthetical gives a clear exclusion (does not delete schedules), which routes the agent toward the schedule-deletion sibling, and the word 'completed' implies it only targets finished runs. However, it does not name the alternative tool explicitly or state prerequisites.

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 behavioral burden for a destructive operation, yet it says nothing about permanence, required permissions, or any side effects on associated scans. 'Delete' restates the tool name rather than disclosing 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?

A single front-loaded sentence with zero wasted words. It is efficient, though its brevity reflects under-specification as much as conciseness.

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 destructive, two-parameter tool with no annotations, no output schema, and no parameter documentation, the description is far too thin. An agent lacks the information needed to call it safely or 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% and the description mentions neither agent_id nor schedule_id, so it adds no meaning beyond the schema's bare property names. Only the self-descriptive parameter names keep this from being a 1.

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 (Delete) and resource (auto-scan schedule), which distinguishes it from siblings like delete_scans, update_scan_schedule, and trigger_scan_schedule. It is clear but does no explicit sibling differentiation beyond the resource name itself.

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, no prerequisites (e.g., whether the schedule must be disabled first), and no warning that the operation is irreversible. The agent must infer all usage 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?

No annotations are provided, so the description carries the full behavioral burden and largely fails it. It implies a read operation but never states it is read-only, whether it requires specific permissions, whether results are cached or paginated, or what triggers recomputation. The only behavioral hint is the '(window e.g. 7d, 30d)' parenthetical.

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 single compact sentence with the resource front-loaded and the window format as a parenthetical aside. Nothing is wasted and the parenthetical earns its place by documenting the undocumented param.

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 annotations, no output schema, and 0% param coverage, the definition is thin for an analytics endpoint: it never describes what analytics are returned (counts, trends, groupings), how they are aggregated over the window, or the empty-result case. An agent can call it but cannot anticipate 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 for both params. It adds genuine meaning for 'window' by showing accepted values ('7d', '30d'), but gives no meaning for the required 'agent_id' beyond the name, and doesn't state the default window or granularity.

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 a specific verb ('Get') and resource ('sourced-leads analytics') scoped to an agent, which is more concrete than the tool name alone. However, 'analytics' is left undefined, so the agent still doesn't know what metrics or shape of data comes back. No sibling is close enough to require explicit differentiation, so no penalty there.

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 an example input format for the window but never says when to reach for this tool versus the scan-oriented siblings (list_scan_results, get_scan). There is no when-to-use, no prerequisites, and no 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?

No annotations exist, so the description carries the full burden. It does disclose that leads come back paginated and what the payload contains (status, progress, leads), which is genuinely useful behavior beyond the schema. However it omits permission requirements, error behavior for a bad scan_id/agent_id, and any indication of whether the call is side-effect free.

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 single front-loaded sentence with no filler; the parenthetical efficiently packs in the return contents. It is appropriately sized, though the brevity comes at the cost of the missing detail noted elsewhere.

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?

No output schema, no annotations, and 0% parameter coverage mean the description should do more heavy lifting. It covers the return payload shape but leaves all four parameters undocumented and does not describe pagination defaults or how to page through leads.

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% for all four parameters, and the description only hints at pagination, without explaining limit, offset, scan_id, or agent_id. The relationship between agent_id and scan_id (both required) and the pagination syntax are left entirely to inference.

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 a specific verb+resource ('Get one scan') and enumerates the payload it returns (status, progress, leads), which implicitly distinguishes it from the singular/plural siblings. It does not explicitly name list_scans or list_scan_results, so differentiation relies on the reader inferring 'one' vs 'list'.

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?

No when-to-use guidance is given. With siblings list_scans and list_scan_results available, the agent gets no explicit rule for choosing this single-scan fetch over the list endpoints, and no prerequisites (auth, ownership) are stated.

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, and it does disclose a meaningful side effect via the outreach modes (none|immediate|bulk_followup), warning the agent that import can trigger outreach. However it says nothing about permissions, duplicate handling, or reversibility of the CRM write.

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 single compact sentence with the action front-loaded and the optional mode values parenthetically scoped. It is efficient, though arguably too terse to be self-sufficient.

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 5-parameter mutation tool with no annotations, no output schema, and no schema descriptions, this one-liner is insufficient. It should at least clarify what lead_ids/scan_id refer to and what happens to the CRM record after import.

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 coverage is 0% across 5 parameters. The description only documents the outreach field and its allowed values (which the schema lacks), leaving agent_id, scan_id, lead_ids, and label entirely unexplained in both places.

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?

Specific verb+resource: 'Import discovered leads into the agent CRM', which reads clearly as a CRM write operation rather than a scan operation. It does not name any sibling tool or explicitly distinguish itself from list_scan_results or suggest_targets, 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?

No when-to-use guidance, prerequisites, or alternatives are given. The agent must infer that this follows a scan and consumes lead_ids from discovery results; nothing in the text routes it against the many scan/discovery siblings.

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. The verb 'List' does signal a non-mutating read of status data, which is the key behavioral fact here, but the description says nothing about permissions, response shape, or whether the list can be empty/filtered.

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?

One tight sentence with no filler, and the enumerated connector types come early. It is efficiently sized for a simple list tool, if a touch sparse.

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 single-parameter read tool with no output schema, the description covers what is listed and for whom, which is the essential information. It falls short on the one parameter it takes and on what the returned status values look like.

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 single parameter agent_id is undocumented. The phrase 'for a support agent' hints that agent_id identifies the support agent, but the description never confirms this or explains the expected identifier format.

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 a specific verb (List) and resource (connector status) and enumerates the connector types covered (WhatsApp, Instagram, Email, X), scoped to a support agent. It is clearly distinguishable from the scan-related siblings, though it does not explicitly contrast with them.

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 call this tool, what preconditions apply, or what alternatives exist. The agent must infer from the name alone that this retrieves connector status rather than modifying anything.

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 behavioral burden. It implies a read operation but discloses nothing about pagination, authentication, whether leads are truncated, or what is returned for an active vs completed scan.

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 single short sentence, front-loaded with the alias relationship and the resource. It wastes no words, though the extreme brevity is under-specification rather than elegance.

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 4-parameter tool with no annotations, no output schema, and no schema descriptions, this eight-word description is far too thin. It omits return shape, pagination behavior, and any distinction from get_scan, leaving the agent to infer nearly everything.

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% across four parameters, including two required ones (agent_id, scan_id) plus limit/offset. The description mentions no parameter at all, so an agent gets zero guidance on identifier formats or pagination semantics.

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 a specific verb and resource ("read leads from an active or completed scan") and explicitly names the sibling it duplicates (get_scan), so an agent can immediately tell what it mirrors. It does not explain what distinguishes it from get_scan beyond being an alias, but the core purpose is unambiguous.

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 never says when to prefer this tool over get_scan, which is the only decision that matters for an alias. The phrase "active or completed scan" hints at scope but offers no explicit when-to-use, prerequisites, or selection criteria.

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. It conveys only that results include past and active scans; nothing about permissions, pagination, ordering, or result volume is disclosed.

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?

One tight sentence with the scope qualifier front-loaded and no filler. It is appropriately brief for a simple list operation, though the brevity comes at the cost of substance.

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 annotations, no output schema, and an undocumented required parameter, the definition leaves too much unspecified for an agent to call it confidently. A tool whose only input is a bare agent_id needs at least a note on its meaning and the result shape.

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 single required parameter agent_id has 0% schema description coverage, and the description never explains what the agent identifier is or where it comes from. The parameter is effectively undocumented in both places.

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 a specific verb ('List') and resource ('leads discovery scans') scoped to an agent, and the phrase 'past and active' distinguishes it from a singular get_scan. It does not explicitly contrast with siblings like list_scan_results, 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?

No when-to-use guidance and no alternatives named, despite many closely related siblings (get_scan, list_scan_results, list_scan_schedules). The agent must infer the choice from the name alone.

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 exist, so the description carries the full behavioral burden, yet it says nothing about whether inactive/disabled schedules are included, ordering, pagination, or what happens for an unknown agent_id. For a read tool with zero annotation coverage this leaves the agent guessing about the result set.

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?

One short, front-loaded sentence with no filler. It is efficient, but its brevity reflects under-specification rather than deliberate compression of rich content.

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 annotations, no output schema, and an undocumented parameter, the description would need to explain return contents and scoping to be complete. As written, an agent knows only the general topic of the call.

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 single agent_id parameter has no documented meaning beyond the vague phrase 'for an agent'. The description does not clarify format, source, or whether it accepts an ID versus a name.

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 a specific verb (List) and resource (auto-scan schedules) scoped to an agent. It is distinguishable from create_scan_schedule, delete_scan_schedule, update_scan_schedule and trigger_scan_schedule by the 'list' verb, though it never explicitly contrasts itself with those 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?

Gives no when-to-use or when-not-to-use guidance and names no alternative. An agent must infer that this is the read-only enumeration counterpart to trigger_scan_schedule/update_scan_schedule on its own.

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. 'Start' implies a mutating, likely asynchronous operation, but it says nothing about whether the call blocks, what identifier is returned, whether the target agent must be connected first, or any rate limits. Only the channel enumeration adds value beyond the schema.

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 single tight sentence with the action front-loaded and the allowed channels attached. It is efficient, though its brevity is partly under-specification rather than economy.

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 three-parameter tool with a nested params object, no annotations, and no output schema, the description is thin. It omits what agent_id refers to, what keys params accepts, and what the caller receives after starting a scan.

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% across three parameters, and the description only constrains the 'channel' values (helpful, since the schema has no enum). 'agent_id' and the nested 'params' object are left entirely undocumented in both the schema and 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 a specific verb and resource ('Start a leads discovery scan') and enumerates supported channels. It is clear on its own, but does not explicitly differentiate from siblings like continue_scan, trigger_scan_schedule, or create_scan_schedule.

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?

No indication of when to use this versus continue_scan (resuming an existing scan), trigger_scan_schedule (running a scheduled scan), or create_scan_schedule. The channel list is a value hint, not usage guidance, so the agent gets no routing help.

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, yet it discloses nothing about cost, latency, rate limits, or whether proposed targets are persisted or ephemeral. The word 'AI-propose' hints the output is generated rather than ground truth, but that is not made explicit.

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 single front-loaded sentence with no wasted clauses; the constrained parenthetical keeps it tight. It is efficient, though the parenthetical is terse to the point of underspecification.

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 6-parameter, 0%-coverage tool with no annotations and no output schema, one sentence is inadequate. An agent cannot tell what it will receive back, how to size depth/breadth, or what min_followers and disable_hard_filter do.

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% across 6 parameters, so the description must compensate, but it only maps the channel concept (Instagram/X) and vaguely flags depth/breadth as optional. min_followers, disable_hard_filter, and the required agent_id are left entirely unexplained.

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 a specific verb (AI-propose) and resource (@targets) scoped to Instagram or X for a discovery scan, which is more informative than the bare name. It does not, however, distinguish itself from siblings like run_scan or trigger_scan_schedule, so an agent must infer where suggestion ends and scanning begins.

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 only usage signal is the parenthetical noting depth/breadth are optional, which is vague and says nothing about prerequisites or sequencing relative to run_scan/continue_scan. No when-to-use, when-not-to-use, or alternative is named.

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 exist, so the description carries the full behavioral burden. It reveals that this is an execution/trigger action rather than a query, but says nothing about side effects, whether the scan runs asynchronously, resource consumption, permissions, or whether the schedule's own state is modified.

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 single short, front-loaded sentence with no filler; the action and the immediacy clause are stated first. It is efficient, though arguably too terse given the undocumented parameters.

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 annotations, no output schema, and 0% parameter coverage, the description leaves too much unspecified for a mutating trigger tool — an agent cannot tell what the scan produces, what state changes occur, or how the two IDs relate.

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 there are two required parameters (agent_id, schedule_id). The description does not mention either parameter or explain their relationship, relying entirely on the self-evident naming, which is insufficient compensation for a total coverage gap.

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 a specific verb and resource (run/trigger a scan schedule) and adds the 'Run now' cue to indicate immediate rather than scheduled execution. It distinguishes reasonably well from create_scan_schedule and update_scan_schedule, though it doesn't clearly separate itself from sibling run_scan or continue_scan.

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 parenthetical '(Run now)' implies use when you want the schedule to fire immediately instead of at its scheduled time, but no explicit when-to-use guidance, prerequisites, or alternatives (e.g., run_scan vs this) 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, the description carries the full behavioral burden but only restates the operation. It omits permission requirements, reversibility, partial-update semantics, and the immediate effects of changing enabled or frequency fields for a 13-param mutation 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?

Single front-loaded sentence with no filler, so it is concise. However, given the tool's complexity, its brevity borders on under-specification rather than optimal conciseness.

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 13 parameters with zero schema descriptions, no annotations, and no output schema, the description is far too thin to use the tool correctly. It omits parameter meanings, behavioral constraints, and expected outcomes.

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% for 13 parameters, including a nested 'params' object, and the description names none of them. No semantics for required IDs, enabled flag, frequency, or other controls are provided.

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 a specific verb (update, pause/resume) and resource (auto-scan schedule), letting an agent distinguish it from create/delete/list siblings. However, it does not name alternative tools explicitly, so it lacks full sibling differentiation.

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?

No when-to-use conditions, prerequisites, or alternative tools are mentioned. The phrase 'Update or pause/resume' implies modifying an existing schedule but gives no guidance on when to choose it over trigger_scan_schedule or create_scan_schedule.

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