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. While it states what the tool does, it doesn't describe important behavioral aspects like whether it returns a list of note titles or full content, if there are pagination limits, what happens if the note doesn't exist, or if there are performance considerations for large note collections.

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 perfectly concise at just one sentence that directly states the tool's purpose with zero wasted words. It's front-loaded with the core functionality and doesn't include any unnecessary 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 that there are no annotations and no output schema, the description is incomplete for a tool that presumably returns results. It doesn't explain what format the backlinks are returned in (titles, IDs, full notes), whether there are limitations, or what happens in edge cases. For a query tool with no structured output documentation, this leaves significant gaps.

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 100%, with the single parameter 'note_title' clearly documented in the schema. The description doesn't add any additional parameter semantics beyond what's already in the schema, so it meets the baseline score of 3 where 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 with a specific verb ('Find') and resource ('all notes that link to a specific note'), making it immediately understandable. However, it doesn't explicitly differentiate from sibling tools like knowledge_related or knowledge_graph, which might also involve note relationships, so it doesn't reach the highest 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. With siblings like knowledge_related, knowledge_graph, and knowledge_search that might overlap in functionality, there's no indication of when this specific backlink-finding tool is appropriate or when other tools should be preferred.

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 full burden. It states the basic action but lacks behavioral details like whether it returns a list or count, if results are paginated, what happens with non-existent tags, or any rate limits. 'Find all notes' suggests a read operation, but this isn't explicitly confirmed.

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 with zero waste. It's front-loaded with the core purpose and appropriately sized for a simple tool with one parameter.

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

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

For a simple read tool with no annotations, no output schema, and 100% schema coverage, the description is minimally adequate. It covers the basic purpose but lacks details on behavior, output format, or sibling differentiation, leaving gaps in context.

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

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

Schema description coverage is 100%, with the parameter 'tag' documented as 'Tag to search for (with or without #)'. The description adds no additional meaning beyond this, as it only restates 'specific tag'. Baseline 3 is appropriate since 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 verb ('Find') and resource ('all notes'), with the specific constraint 'with a specific tag'. It doesn't explicitly differentiate from sibling tools like knowledge_search or knowledge_related, but the tag-based filtering is a clear specialization.

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 is provided on when to use this tool versus alternatives like knowledge_search (which might support tag filtering) or knowledge_related (which might find related notes). The description implies usage for tag-based queries but doesn't mention exclusions or 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 burden. It discloses key behavioral traits: the tool returns JSON with nodes and edges compatible with graph visualizations, and it explains the two modes of operation (clusters vs. subgraph). However, it doesn't mention potential limitations like rate limits, authentication needs, or data size constraints.

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

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

The description is front-loaded with the core purpose, followed by usage guidelines and output format. Every sentence earns its place, with no wasted words, making it highly 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 (graph generation with optional parameters) and no output schema, the description does well by explaining the output format and behavior. However, it could be more complete by detailing error cases or performance considerations, though the lack of annotations isn't fully compensated.

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 thoroughly. The description adds some context by explaining the effect of 'center_note' on output, but doesn't provide additional meaning beyond what's in the schema descriptions. This meets the baseline for high 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's purpose: 'Generate a graph view of links between notes.' It specifies the verb ('generate') and resource ('graph view of links between notes'), and distinguishes it from siblings by focusing on graph visualization rather than backlinks, tags, reading, or writing operations.

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 explicitly states when to use this tool vs. alternatives: 'Without center_note, returns the most connected clusters. With center_note, returns the subgraph around that note.' This provides clear context for both scenarios and differentiates it from sibling tools like knowledge_backlinks or knowledge_related.

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 describes the read operation but lacks details on permissions, error handling (e.g., if the note doesn't exist), or output format (e.g., plain text, structured data). For a tool with zero annotation coverage, 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 two sentences with zero waste, front-loading the core purpose and efficiently adding usage guidance. Every word serves a clear function, making it appropriately sized 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's low complexity (single parameter, no output schema, no annotations), the description is minimally adequate but lacks completeness. It doesn't explain the return values or behavioral traits, which is a gap since there's no output schema to compensate. However, the simple nature of a read operation keeps it from being severely inadequate.

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 100%, so the schema already documents the 'note_path' parameter with examples. The description adds marginal value by reinforcing that the path can come from 'search results' or be a 'note title', but doesn't provide additional syntax or format details beyond what the schema provides, meeting the baseline for high 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 verb 'Read' and the resource 'full content of a specific note', making the purpose understandable. However, it doesn't explicitly differentiate from sibling tools like knowledge_search or knowledge_write, which would require a more specific scope statement.

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 implied usage guidance by mentioning 'Use the path from search results or the note title', suggesting it's for retrieving content after identifying a note. However, it doesn't explicitly state when to use this tool versus alternatives like knowledge_search for finding notes or knowledge_write for modifying them, 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 notes but doesn't mention critical aspects like whether it's read-only, requires authentication, has rate limits, or what the output format is. This leaves significant gaps in understanding how the tool behaves.

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 with zero waste. It's front-loaded with the core purpose, making it easy to parse quickly, which is ideal for 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 the lack of annotations and output schema, the description is incomplete. It doesn't explain what 'recently modified' entails (e.g., time window), the return format, or any behavioral traits. For a tool with no structured data beyond the input schema, this leaves too much unspecified.

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 'count' parameter fully documented in the schema itself. The description doesn't add any meaning beyond the schema, such as explaining what 'recently modified' means (e.g., time frame). Baseline 3 is appropriate since 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 with a specific verb ('Get') and resource ('recently modified notes'), making it immediately understandable. However, it doesn't differentiate from sibling tools like knowledge_search or knowledge_read, which might also retrieve notes, so it falls short of 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. With siblings like knowledge_search (for searching notes) and knowledge_read (for reading specific notes), there's no indication of when 'recently modified' retrieval is preferred, leaving usage ambiguous.

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 the retrieval mechanisms (links, tags, mentions) but doesn't describe what 'related' means operationally (e.g., ranking, thresholds), whether results are paginated, or any performance characteristics like rate limits. This leaves significant gaps for a tool with potential complexity.

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 core purpose ('Find notes related to a concept') and adds clarifying detail ('by links, tags, or mentions') without redundancy. Every word earns its place, making it highly concise 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 lack of annotations and output schema, the description is incomplete for a tool that likely returns complex results (notes with relationships). It doesn't explain what the output contains (e.g., note metadata, relevance scores) or behavioral aspects like error conditions. For a retrieval tool with no structured support, more context is needed.

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 input schema already documents both parameters ('concept' and 'max_results') adequately. The description adds no additional semantic context beyond implying the 'concept' parameter is used for finding relatedness, which is already clear from the schema. Baseline 3 is appropriate when 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: 'Find notes related to a concept' with specific mechanisms mentioned ('by links, tags, or mentions'). It distinguishes itself from siblings like 'knowledge_search' by focusing on relationship-based retrieval rather than general search, though it doesn't explicitly name 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 context through 'related to a concept' and the mechanisms listed, suggesting this tool is for discovering connections between notes. However, it doesn't explicitly state when to use this versus alternatives like 'knowledge_search' or 'knowledge_backlinks', nor does it provide exclusion 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 of behavioral disclosure. It mentions that the tool 'Returns matching notes with snippets,' which gives some insight into output behavior. However, it lacks details on permissions needed, rate limits, error handling, or whether results are paginated. For a search tool with no annotation coverage, this leaves significant gaps in understanding how it 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: two sentences that directly state the action and result. Every word earns its place, with no redundant or vague language. It efficiently communicates the core functionality without unnecessary elaboration, making it easy for an AI 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 (search with two parameters) and no annotations or output schema, the description is minimally adequate. It covers the basic purpose and output format ('matching notes with snippets'), but lacks details on behavioral traits, usage context, and deeper parameter insights. For a search tool, this leaves room for improvement in guiding effective use, though it meets the bare minimum for understanding.

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 ('query' and 'max_results'). The description adds no additional parameter semantics beyond what's in the schema—it doesn't explain query syntax, ranking, or snippet generation. Since the schema already does the heavy lifting, the baseline score of 3 is appropriate, as the description doesn't compensate but also doesn't detract.

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 notes in the Knowledge vault by content or title.' It specifies the verb ('Search'), resource ('notes in the Knowledge vault'), and scope ('by content or title'), making it easy to understand what the tool does. However, it doesn't explicitly differentiate from siblings like 'knowledge_explore_tag' or 'knowledge_graph', which might also involve searching or exploring notes.

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. With siblings like 'knowledge_explore_tag' (likely tag-based exploration), 'knowledge_graph' (graph-based queries), and 'knowledge_related' (finding related notes), there's no indication of when this content/title search is preferred over other search or exploration methods. The description only states what it does, not when it's the right choice.

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 full burden. It states it's a read operation ('Get'), but doesn't disclose behavioral traits like whether it requires authentication, has rate limits, returns structured data, or how 'recent notes' is defined. The description is minimal and lacks operational context.

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 sentence, front-loaded with the core purpose, and lists specific statistics efficiently. Every word earns its place with no redundancy or wasted text.

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 0 parameters and no output schema, the description is adequate but minimal. It specifies what statistics are retrieved, but lacks details on format, scope, or behavioral context. For a tool with no annotations, it could benefit from more operational transparency.

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?

There are 0 parameters, and schema description coverage is 100% (empty schema). The description adds no parameter information, which is appropriate here. Baseline for 0 parameters is 4, as no compensation is needed.

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 resource 'statistics about the Knowledge vault', specifying what metrics are included (total notes, types, tags, recent notes). It distinguishes from siblings like knowledge_read (read content) or knowledge_search (search), but doesn't explicitly contrast 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?

No guidance on when to use this tool versus alternatives like knowledge_recent (which might overlap with 'recent notes') or knowledge_explore_tag (which might relate to tags). The description implies usage for statistical overviews but provides no explicit when/when-not rules or 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?

With no annotations provided, the description carries the full burden of behavioral disclosure. It effectively describes key behaviors: it creates notes with frontmatter, enforces naming conventions, and performs duplicate checks before creation. However, it doesn't mention potential side effects (e.g., file system changes), error handling, or response format, which would be helpful for a 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?

The description is appropriately sized and front-loaded, starting with the core action ('Create a new note') followed by important constraints. Both sentences add value: the first covers creation and conventions, the second adds duplicate checking. There's no wasted verbiage, though it could be slightly more structured (e.g., separating behavioral aspects).

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 complexity (mutation with 6 parameters, no annotations, no output schema), the description provides good context: it explains the creation purpose, naming rules, and duplicate checking. However, it lacks details on error conditions, response format, or how the 'type' parameter maps to the naming conventions, leaving some gaps for the agent to infer.

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 6 parameters thoroughly. The description adds minimal parameter semantics beyond the schema—it mentions naming conventions that relate to the 'title' parameter and note types, but doesn't explain how parameters like 'folder' or 'related' interact with the creation process. Baseline 3 is appropriate when the schema does most of the work.

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 specific action ('Create a new note'), the target resource ('Knowledge vault'), and key behavioral aspects ('with proper frontmatter and naming conventions', 'Checks for duplicates before creation'). It distinguishes this tool from sibling tools like knowledge_read, knowledge_search, and knowledge_stats by focusing on creation rather than retrieval or analysis.

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 context through naming conventions (e.g., 'C_' for concepts, date-based prefixes for conversations/troubleshooting), but doesn't explicitly state when to use this tool versus alternatives like knowledge_write versus knowledge_read or knowledge_search. No explicit exclusions or prerequisites are mentioned, leaving the agent to infer usage from the naming rules.

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