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 adds the directive 'ALWAYS use format: "md" for best results', which is useful behavioral guidance, but it does not disclose return structure, rate limits, or potential side effects. Since this is a fetch operation, the lack of explicit read-only disclosure is mitigated but not fully addressed.

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 sentences, front-loaded with the primary purpose, and every word earns its place. It is concise without sacrificing 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?

With 8 parameters and no output schema, the description leaves out explanations of resource, testament, organization, and language. It does cover the main usage modes, but relies heavily on the schema for full context, making it minimally sufficient rather than complete.

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 75%, and the description adds meaningful context by explaining when to use reference versus search/filter, and strongly recommends format 'md'. This clarifies parameter relationships beyond the schema's individual field descriptions.

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 'Fetch Bible scripture text' with a specific verb and resource, and clearly distinguishes this tool from sibling translation resources. It also differentiates the discovery modes (reference vs search/filter), making the scope 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 provides guidance on when to use reference versus search/filter, but does not explicitly mention alternatives or when not to use this tool relative to siblings like search_biblical_resources. Usage is implied rather than explicitly contrasted with other tools.

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 bears the full burden of behavioral disclosure. It states the tool 'gets' or 'searches' which implies read-only behavior, but it doesn't disclose details about response structure, pagination, rate limits, or any side effects. The schema adds some filter behavior (stemmed regex) but the description itself is thin on behavioral traits.

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, front-loaded with the main action. It avoids unnecessary words. However, it might be too terse given the tool's complexity, but for conciseness it earns a good score.

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 5 parameters, no annotations, and no output schema, the description is insufficiently complete. It does not explain what the returned articles look like, how language/organization affect results, or provide examples of usage. For a tool with this complexity, the description should offer more context to enable correct invocation.

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

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

Schema coverage is 60%, with descriptions for filter, category, and moduleId. The description adds a small amount of semantic value by explaining that the filter searches across all modules, which parallels the schema's description. However, it does not clarify language or organization parameters, and the added value over the schema is minimal. Given moderate schema coverage, a baseline 3 is appropriate.

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

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

The description clearly identifies the tool's purpose: retrieving Translation Academy articles. It also mentions an alternative mode (using filter to search across modules), which adds specificity. It distinguishes itself from siblings like fetch_translation_notes and fetch_translation_questions by explicitly naming the resource type (Translation Academy), though it doesn't contrast directly.

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 explicit guidance on when to use this tool versus alternatives. It does not mention siblings or exclusions. The only implicit hint is that it's for Translation Academy content, but there is no when-to-use/when-not-to-use 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?

With no annotations provided, the description carries the full burden of behavioral disclosure. It only says 'Fetch' (implying read-only) and describes two lookup modes, but does not explain the output format differences, default markdown behavior, or any limitations. The description adds minimal context beyond what the tool name already suggests.

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, well-structured sentence that states the core purpose and an alternative usage mode. Every word contributes meaning, and the filter parameter is mentioned to clarify a non-obvious usage.

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 tool with 7 parameters, no output schema, and no annotations, the description is functional but sparse. It relies heavily on the schema to convey parameter details and does not mention output formats or default values, which are important for a fetch tool. The description is adequate for straightforward use but lacks depth for edge cases.

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 71%, with good descriptions for filter, format, search, reference, and testament, but language and organization are undocumented. The description highlights the filter parameter's role in searching, aligning with the schema, but does not compensate for the missing parameter descriptions. Overall, the schema does most of 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 fetches translation notes, either for a specific Bible reference or via a filter search across all notes. This distinguishes it from sibling tools like fetch_translation_questions and fetch_translation_word by naming the resource type and its unique search 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 two usage modes (reference lookup or filter search) but does not explicitly mention which sibling tool to use instead for other resource types. The context is evident from the tool name, but there are no explicit alternatives or when-not-to-use 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 must carry the full burden of behavioral disclosure. It only mentions the two input modes but leaves critical ambiguities: what happens if both reference and filter are given, what happens when no parameters are supplied (since all are optional), and what the return structure looks like. These omissions limit 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, concise sentence that front-loads the primary action and clearly contrasts the two usage modes. Every word contributes meaning, with no redundancy or 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?

Given the tool has 6 optional parameters, no output schema, and no annotations, the description is too brief to be considered complete. It fails to explain parameter interactions, default behaviors, ambiguity when both reference and filter are used, or the shape of the returned data, leaving an AI agent under-informed for proper invocation.

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

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

The schema already covers 67% of parameters with descriptions for filter, search, reference, and testament. The description adds value by explaining the relationship between reference (specific Bible reference) and filter (search across all questions), but it does not clarify the remaining undocumented parameters like language and organization. Baseline for moderate coverage is 3.

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 the specific verb 'Fetch' with the clear resource 'translation questions', and explicitly defines two modes: fetching by Bible reference or searching via the filter param. This clearly distinguishes it from sibling tools like fetch_translation_notes and fetch_translation_word, which target different resource types.

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 clearly indicates the two primary use cases: retrieving questions for a specific Bible reference, or using the filter param to search across all questions. However, it does not explicitly name sibling tools or provide when-not-to-use guidance, such as when to prefer fetch_translation_notes over this tool.

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 present, so the description carries full burden. It adds context about the library's size ('thousands of articles') but doesn't disclose behavior such as whether it returns a list or single item, nor any read-only/auth implications beyond the verb 'Get'.

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 concise sentences: the first states the tool's purpose and scope, the second provides a key usage tip. No fluff, front-loaded.

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 straightforward lookup tool with all-optional parameters and no output schema, the description covers the primary use case and the main search parameter. It doesn't detail return format, but that's not expected without an output schema. Minor gaps like language/organization are covered by defaults.

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

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

The schema already describes term, filter, and category. The description adds a practical hint to use filter for searching, but doesn't explain the interaction between term and filter or the remaining language/organization parameters. With 60% schema coverage, this is adequate but not highly informative.

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 phrase 'Get Translation Word articles' and enumerates content types (key biblical terms, names, places, other words), clearly distinguishing it from sibling tools like fetch_translation_notes or fetch_scripture.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives an explicit directive to use the filter parameter for searching across all words, and the description implies that this tool is for word/article lookups. However, it doesn't explicitly contrast with alternatives or state when not to use it, so not a 5.

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

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

With no annotations provided, the description carries the full burden of behavioral disclosure. It only states that the tool 'gets' or 'searches,' implying read-only behavior, but does not describe what 'word links' are, the return format, pagination, or effects of invalid or missing parameters. This is a significant transparency gap even for a read operation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence with no filler, front-loading the core action ('Get translation word links') and then adding the alternative filter mode. Every word earns its place; it is excellently concise.

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 description leaves many gaps: it does not define 'translation word links,' clarify the relationship between reference and filter, mention default values for language/organization, or explain what the output looks like. With 6 optional parameters and no output schema or annotations, the description is not sufficiently complete for effective tool 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 67% (filter, category, reference, testament have descriptions; language and organization rely on defaults). The description adds minimal extra parameter meaning—only that 'filter' enables a broader search. It does not explain language, organization, or the interplay between reference and filter, but the schema partially covers this.

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 ('Get') and resource ('translation word links') with two clear modes: for a Bible reference or via filter. This distinguishes it from sibling tools like fetch_translation_word (singular) and search_biblical_resources, though it does not explicitly name alternatives. The resource is specific enough to convey its unique purpose.

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 two usage scenarios: use it with a reference to get links, or use a filter to search across all word links. However, it provides no explicit guidance on when to prefer this over fetch_translation_word or search_biblical_resources, and does not mention exclusions or preconditions. The usage context is implied but not fully clarified.

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. 'Get' implies a read operation, but the description does not state whether this action is safe, non-mutating, or requires any special permissions. It also doesn't disclose potential side effects or what happens if the optional parameter is omitted. The transparency-focused wording does not compensate for these gaps.

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 that directly states the tool's purpose with minimal waste. It is appropriately sized and front-loaded.

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 with one optional parameter and no output schema. The description clearly indicates what the tool returns (system prompt and constraints), but it lacks usage guidance and behavioral disclosure. Given the simplicity, the description is adequate but not fully complete, especially due to missing annotations.

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 full coverage (100%) for the single parameter 'includeImplementationDetails', which includes its own description. The tool description adds no additional meaning about the parameter beyond the schema, so a baseline score of 3 is appropriate.

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 function: 'Get the complete system prompt and constraints'. It uses a specific verb and resource, and the purpose is distinct from sibling tools which focus on biblical resources and translations.

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 'for full transparency about AI behavior' implies a usage context, but there is no explicit guidance on when to use this tool versus alternatives, no when-not-to-use cases, and no mention of prerequisites. The sibling tools are clearly different in domain, so the purpose is understandable, but explicit guidelines are missing.

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 must carry the burden of behavioral disclosure. It adds useful context by naming the BM25 scoring algorithm and the resource types searched, but it does not explicitly state that the operation is read-only or describe any side effects, rate limits, or permission requirements. For a simple search tool this is adequate but not thorough.

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 of 12 words. It contains no repetition, filler, or unnecessary details. Every word contributes to conveying the purpose and key behavioral attribute (BM25), making it highly efficient and well-structured.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has 6 parameters, no annotations, and no output schema, the description is too sparse. It does not mention return format, pagination, parameter usage, or relationship to sibling fetch tools. The brief description covers only the core purpose, leaving the agent without adequate context to invoke the tool correctly in varied scenarios.

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 only 33% (query and reference have descriptions). The description itself does not explain the remaining parameters (limit, language, includeHelps, organization) and only mentions resource types, which are not directly tied to parameters. This leaves the agent to guess meanings of several important fields, so the description fails to compensate for the low schema coverage.

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

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

The description clearly states the tool performs a search over biblical translation resources (scripture, notes, questions, words) using BM25 scoring. This verb+resource combination is specific and distinguishes it from sibling fetch_* tools, which retrieve specific resources by identifier rather than searching across 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?

The description implies usage as a discovery/search mechanism but does not explicitly state when to use it versus the fetch_* siblings. There is no mention of alternatives or exclusions, so the guidance remains implicit rather than spelled out. The tool name itself signals a search role, but the description alone lacks explicit direction.

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