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 states the tool extracts entities but doesn't describe how (e.g., via NLP, accuracy, rate limits), what the output looks like (since no output schema exists), or any constraints (e.g., video length limits, processing time). This leaves significant gaps for an AI agent to understand the tool's behavior beyond the basic action.

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, efficient sentence that clearly states the tool's purpose without unnecessary words. It is front-loaded with the core action and resource, making it easy to parse. Every part of the sentence contributes essential information, earning 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 complexity of entity extraction (which involves NLP processing) and the lack of annotations and output schema, the description is incomplete. It doesn't explain the output format, accuracy, limitations, or how it integrates with other tools (e.g., needing 'get_transcript' first). For a tool with no structured behavioral data, more context is needed to guide effective use.

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 100% description coverage, with the single parameter 'video_id' documented as a YouTube video ID. The description adds no additional parameter semantics beyond what the schema provides, such as format examples or validation rules. However, with high schema coverage and only one parameter, the baseline score of 3 is appropriate as the schema adequately covers parameter details.

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 states the tool's purpose: extracting structured entities from video transcripts. It specifies the resource (video transcripts) and the action (extracting entities), and lists the types of entities (companies, indices, people, sectors, etc.). However, it does not explicitly differentiate this tool from sibling tools like 'segment_topics' or 'search_transcripts', which might also process transcripts, so it doesn't fully distinguish from alternatives.

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 no guidance on when to use this tool versus alternatives. It doesn't mention prerequisites (e.g., needing a transcript first), exclusions, or compare it to siblings like 'segment_topics' or 'search_transcripts' that might handle similar data. Usage is implied by the purpose but lacks explicit context or 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 are provided, so the description carries the full burden. It mentions the report includes summary, topic segments, entities, and optionally comments, but lacks details on behavioral traits like processing time, error handling, authentication needs, or rate limits. For a tool with no annotations, this is a significant gap in transparency.

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, efficient sentence that front-loads the main purpose and lists key components. It avoids unnecessary details, though it could be slightly more structured for clarity.

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 no annotations, no output schema, and 3 parameters with full schema coverage, the description is adequate but incomplete. It covers the purpose and components but lacks behavioral context and output details, making it minimally viable for a report-generation 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?

Schema description coverage is 100%, so the schema already documents all parameters (video_id, include_comments, llm_provider). The description adds minimal value by implying the report uses an LLM for summary and includes comment analysis, but doesn't provide additional syntax or format details beyond what the schema provides.

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 states the verb 'generate' and the resource 'structured markdown report for a YouTube video', specifying the content includes summary, topic segments, entities, and optionally comments. It distinguishes from siblings like get_transcript or extract_entities by focusing on report generation, though it doesn't explicitly contrast with all alternatives.

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 when a comprehensive report is needed, mentioning optional comment inclusion, but doesn't specify when to use this versus siblings like get_video or segment_topics individually. No explicit alternatives or exclusions are provided, leaving some ambiguity.

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 states the tool gets top comments and optionally summarizes them, but it doesn't reveal critical behavioral traits such as whether this is a read-only operation, potential rate limits, authentication needs, error handling, or what 'top' means (e.g., by likes, recency). This leaves significant gaps for an AI agent to understand how the tool behaves in practice.

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 extremely concise and front-loaded, consisting of just one sentence that directly states the tool's purpose and optional feature. Every word earns its place without any redundancy or unnecessary elaboration, making it efficient and easy to parse.

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's moderate complexity (3 parameters, no output schema, no annotations), the description is incomplete. It lacks details on behavioral aspects like safety, performance, or output format, and doesn't compensate for the absence of annotations or output schema. For a tool that retrieves and potentially summarizes comments, more context is needed to ensure the agent can use it 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 input schema has 100% description coverage, clearly documenting all parameters (video_id, top_n, summarize) with their types and defaults. The description adds minimal value beyond this, only implying the optional summarization feature, which is already covered in the schema. According to the rules, with high schema coverage (>80%), the baseline is 3 even with no additional param info in the description.

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

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

The description clearly states the tool's purpose: 'Get top comments for a video' specifies the verb ('Get') and resource ('top comments for a video'), making it understandable. However, it doesn't explicitly differentiate from sibling tools like 'get_video' or 'get_transcript', which might also involve video-related data retrieval, so it lacks sibling differentiation for a perfect score.

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 no guidance on when to use this tool versus alternatives. It mentions an optional summarization feature but doesn't explain when to use 'summarize' or how this tool compares to siblings like 'search_transcripts' or 'get_video' for video analysis tasks. Without any usage context or exclusions, it falls short of providing helpful 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 full burden of behavioral disclosure. It states the tool retrieves metadata and video lists, implying a read-only operation, but doesn't cover important aspects like rate limits, authentication needs, error handling, or pagination behavior. This leaves significant gaps in understanding how the tool behaves beyond its basic function.

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, efficient sentence that directly states the tool's purpose without any unnecessary words or fluff. It is front-loaded with the core action and resources, making it highly concise and well-structured for quick understanding.

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's moderate complexity (retrieving playlist data with two parameters), lack of annotations, and no output schema, the description is incomplete. It doesn't explain what metadata is included, the format of the video list, potential limitations, or error cases, leaving the agent with insufficient context for effective use.

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 100% description coverage, with clear documentation for both parameters ('playlist_id' and 'max_videos'), including examples and defaults. The description adds no additional parameter semantics beyond what the schema provides, so it meets the baseline of 3 for adequate but not enhanced parameter information.

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 states the verb 'Get' and the resources 'playlist metadata and video list from a YouTube playlist', making the purpose specific and understandable. However, it doesn't explicitly distinguish this tool from sibling tools like 'get_video' or 'monitor_channel', which might also involve YouTube content retrieval, so it doesn't reach the highest score 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?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention any prerequisites, context for usage, or comparisons to sibling tools such as 'get_video' for individual videos or 'search_youtube' for broader searches, leaving the agent without explicit usage instructions.

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. It discloses key behavioral traits: default mode, token length for summary (~300), file-saving behavior for 'full' mode, and segmentation for 'chunks'. However, it doesn't mention rate limits, authentication needs, error conditions, or what happens with invalid video IDs.

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?

Extremely concise and front-loaded: the first three words state the core purpose, followed by efficient mode explanations. Every sentence earns its place by providing essential operational details without redundancy.

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 3-parameter tool with no annotations and no output schema, the description provides adequate but incomplete context. It covers mode behaviors well but lacks information about return values (beyond 'returns path' for full mode), error handling, or performance characteristics that would help an agent use 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?

Schema description coverage is 67% (2 of 3 parameters have descriptions). The description adds significant value beyond the schema: it explains what each 'mode' does (summary length, file saving for full, segmentation for chunks) and clarifies the default behavior. This compensates well for the schema's partial 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?

The description clearly states the tool's purpose: 'Get video transcript' with specific modes. It distinguishes from siblings like 'get_video' (metadata) and 'search_transcripts' (searching). However, it doesn't explicitly contrast with 'segment_topics' which might overlap with 'chunks' mode.

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 different modes ('summary' for brief, 'full' for complete, 'chunks' for segmented), but doesn't provide explicit guidance on when to choose this tool over alternatives like 'search_transcripts' or 'get_video'. No exclusions or prerequisites are mentioned.

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. It mentions the output includes 'metadata + summary (~300 tokens)', which gives some behavioral context about the response format and length. However, it doesn't address important aspects like whether this is a read-only operation, potential rate limits, authentication requirements, or error conditions.

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 extremely concise with just two sentences that each serve a clear purpose: first states what the tool does, second specifies the required input. There's zero wasted language or redundancy.

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 operation with no output schema, the description provides basic functionality but lacks important context. It doesn't explain what specific metadata fields are returned, how the summary is generated, or any limitations. The ~300 token mention is helpful but insufficient for full understanding of the tool's 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 100%, so the schema already documents the single parameter completely. The description adds minimal value beyond the schema by specifying 'YouTube video ID' (implied in schema's example) and reinforcing it's required. Baseline 3 is appropriate when the schema does the heavy lifting.

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 states the tool's purpose: 'Get video metadata + summary (~300 tokens)' with the specific resource being a YouTube video. It distinguishes from siblings like get_transcript (which gets transcript text) and get_comments (which gets comments), but doesn't explicitly mention these distinctions.

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 minimal usage guidance: 'Provide a YouTube video ID' indicates the required input but offers no context about when to use this tool versus alternatives like get_transcript or search_youtube. There's no mention of prerequisites, limitations, or comparative use cases.

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 full burden but is insufficient. It mentions actions but doesn't disclose behavioral traits such as whether 'add' requires authentication, if 'check' polls at a specific rate, what 'list' returns, or if 'remove' is destructive. This leaves critical operational details unclear for an 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 highly concise and front-loaded: the first sentence states the core purpose, followed by a compact breakdown of actions. Every sentence earns its place with no wasted words, making it easy for an agent 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?

Given the tool's moderate complexity (2 parameters, multiple actions), no annotations, and no output schema, the description is incomplete. It fails to explain return values, error conditions, or behavioral nuances like subscription persistence or polling intervals, which are essential for proper agent invocation.

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

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

Schema description coverage is 50% (channel_ref has a description, action does not). The description adds value by explaining action enum values (e.g., 'add' means subscribe), which compensates partially for the missing schema description for action. However, it doesn't clarify channel_ref formats beyond what the schema states, leaving gaps in parameter understanding.

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 states the tool's purpose: 'Monitor a YouTube channel via RSS' with specific actions. It distinguishes itself from siblings like get_video or search_youtube by focusing on RSS-based monitoring rather than direct API queries. However, it doesn't explicitly contrast with all siblings (e.g., get_playlist might also involve channel content).

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 through the action parameter breakdown (add, check, list, remove), suggesting when to use each mode. However, it lacks explicit guidance on when to choose this tool over alternatives like get_video for video retrieval or search_youtube for direct searches, and doesn't mention prerequisites like needing an RSS feed setup.

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 full burden for behavioral disclosure. It mentions the tool 'returns matching snippets,' which gives some output context, but lacks details on permissions, rate limits, error handling, or whether it's read-only/destructive. For a search tool with zero annotation coverage, this is insufficient.

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 two concise sentences with zero waste—it states the action and the result directly. It's appropriately sized and front-loaded, 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?

Given the tool's moderate complexity (search with two parameters), no annotations, and no output schema, the description is minimally adequate. It covers the basic purpose and return type but lacks details on usage context, behavioral traits, and parameter nuances, leaving gaps for an AI agent.

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 50% (only 'query' has a description, 'limit' has none). The description adds no parameter semantics beyond what's in the schema—it doesn't explain 'query' further or clarify 'limit' behavior (e.g., max value, pagination). With partial schema coverage, the description doesn't compensate adequately, meeting the baseline.

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 states the tool's purpose with a specific verb ('search') and resource ('stored transcripts'), and mentions the return type ('matching snippets'). However, it doesn't explicitly differentiate from sibling tools like 'get_transcript' or 'search_youtube', which would require 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 no guidance on when to use this tool versus alternatives like 'get_transcript' (which might retrieve full transcripts) or 'search_youtube' (which might search YouTube content). It only states what the tool does, not when it's 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 of behavioral disclosure. It mentions that the tool 'Returns metadata list (~200 tokens),' which gives some insight into output format and size, but lacks critical details like whether this is a read-only operation, rate limits, authentication requirements, or error handling. For a search tool with no annotations, this is insufficient.

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 extremely concise and front-loaded: two sentences that directly state the tool's function and output. Every word earns its place, with no redundant information or fluff. It efficiently communicates the core purpose without unnecessary elaboration.

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's moderate complexity (5 parameters, no output schema, no annotations), the description is minimally adequate. It covers the basic purpose and output format but lacks details on behavioral traits, usage context, and parameter nuances. Without annotations or an output schema, the agent might struggle with full operational understanding, though the core function is clear.

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 description coverage is 80% (high), so the baseline score is 3. The description adds minimal value beyond the schema—it mentions 'by keyword,' which aligns with the 'query' parameter, but doesn't explain parameter interactions or provide additional context like search scope or result formatting. This meets the baseline but doesn't enhance understanding significantly.

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 states the tool's purpose: 'Search YouTube videos by keyword.' It specifies the verb ('Search') and resource ('YouTube videos'), making the function unambiguous. However, it doesn't explicitly differentiate this tool from sibling tools like 'search_transcripts' or 'get_video', which could cause confusion about when to use each.

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 no guidance on when to use this tool versus alternatives. It doesn't mention sibling tools like 'search_transcripts' (for searching within video transcripts) or 'get_video' (for retrieving specific video details), leaving the agent to infer usage context. There are no explicit when-to-use or when-not-to-use instructions.

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 states the tool segments transcripts but doesn't describe what 'transition markers' are, how topics are defined, the output format (e.g., list of segments with timestamps), error handling, or any rate limits. This leaves significant gaps for a tool that performs analysis on video content.

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, efficient sentence that directly states the tool's purpose without unnecessary words. It's front-loaded with the core action and resource, making it easy to parse. Every part of the sentence earns its place by conveying essential information.

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 complexity of segmenting video transcripts (an analysis task) with no annotations and no output schema, the description is incomplete. It lacks details on behavioral traits, output format, and usage context, which are critical for an AI agent to invoke it correctly. The high schema coverage doesn't compensate for these gaps in a non-trivial 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 input schema has 100% description coverage, with the single parameter 'video_id' documented as 'YouTube video ID.' The description adds no additional meaning beyond this, such as format examples or constraints. With high schema coverage, the baseline score of 3 is appropriate as the schema does the heavy lifting.

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 states the action ('segment') and resource ('video transcript') with the specific purpose of dividing it 'into topics based on transition markers.' It distinguishes from siblings like 'get_transcript' (retrieval) or 'search_transcripts' (searching), but doesn't explicitly contrast with all alternatives. The purpose is specific but not fully differentiated from all 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?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention prerequisites (e.g., needing a transcript first), exclusions, or compare to siblings like 'extract_entities' or 'search_transcripts' for similar text analysis tasks. Usage is implied by the purpose but lacks explicit context.

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