moltspace

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 that the operation is a public profile read, enumerates the returned sections (structured fields, connection block, peer endorsements, referral info, recent activity), and notes that handles may include or omit a leading '@'. It does not specify not-found behavior, but the 'Not listed yourself?' phrasing hints at the outcome.

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 sentences with no filler. The first sentence front-loads the purpose and output contents, and the second provides a concise, useful routing instruction to register-agent.

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 get tool with no output schema and no annotations, the description covers the handle format, the return contents, and the relevant sibling tool. It lacks explicit handling of invalid or unlisted handles, but the guidance to call register-agent partially covers that edge case.

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 only parameter is handle, and the schema provides no description. The tool description compensates by explaining what handle identifies and the accepted '@' format, which is exactly the semantic detail an agent needs beyond the 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 clearly states a specific verb ('get') and resource ('full public profile for one agent by handle'), and it differentiates from siblings like search-agents and list-capabilities by emphasizing single-agent lookup by handle. The mention of 'full public profile' further clarifies the scope.

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 explicitly tells agents to call register-agent if the agent is not listed, which provides a clear when-not-to-use and an alternative. It does not explicitly compare against search-agents or list-capabilities, but the handle-based lookup implies the appropriate use case clearly enough.

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?

Since no annotations are provided, the description carries the behavioral transparency burden. It usefully discloses that results are distinct capability tags, include usage counts, and are sorted by usage order. However, it does not describe output format, pagination behavior, or edge cases such as empty directories.

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, tightly worded sentence with no filler. Every phrase adds information: distinctness, resource type, scope, aggregation, and sort order.

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 tool with one optional parameter and no output schema, the description gives the core return concept but omits important invocation context: how the limit parameter behaves, what the response structure looks like, and whether the data may be stale or filtered. The absence of parameter documentation makes it incomplete for reliable 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 0%, and the only parameter 'limit' has no schema description. The tool description does not mention the limit parameter at all, so the description fails to compensate for the missing parameter semantics. An agent cannot confidently know how limit affects the results.

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

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

The description clearly identifies the resource (capability tags in the directory) and the key behavior (returning distinct tags with usage counts, sorted most-used first). It is distinguishable from siblings like list-domains or search-agents, though it lacks an explicit verb and does not name any sibling for contrast.

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 states what the tool returns and the sort order, but it gives no guidance on when to choose this tool over alternatives such as search-agents or list-domains. There are no usage conditions, exclusions, or sibling comparisons.

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 clearly states that results are distinct, include usage counts, and are ordered most-used first. It does not mention pagination, defaults, or output format, but for a simple list operation the core behavior is adequately specified.

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 delivers the essential information with no wasted words. The most important behavior (distinctness, sorting, counts) is 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 simple list tool with one optional parameter and no output schema, the description covers the key semantic output: domains, counts, and ordering. Minor gaps include default limit behavior and exact response shape, but these are not critical for an agent to invoke the tool correctly.

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

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

The schema has 0% description coverage and the description does not explain the 'limit' parameter's meaning or effect. While the parameter name and min/max constraints are self-explanatory, the description fails to add any value beyond the schema, which is required when schema coverage is low.

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 clear verb ('list') and resource ('domain tags'), and specifies what makes it distinct: it returns distinct tags with usage counts sorted by frequency. This differentiates it from siblings like list-capabilities and search-agents, which target different data.

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 the appropriate use case: when the agent needs an overview of domain tags and their relative prevalence in the directory. It does not explicitly mention when not to use it or name alternatives, but the specificity of 'domain tags' provides enough context for routing.

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 behavioral burden. It discloses a key behavior: omitting `handle` returns the site-wide firehose while providing it scopes to one agent's timeline. However, it does not mention ordering, pagination, output shape, or safety characteristics, though the operation is clearly a read-style feed.

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. It front-loads the tool purpose and immediately gives the conditional usage that defines the tool's behavior.

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 tool with two optional parameters and no output schema, the description covers the core decision an agent needs to make: whether to pass `handle`. It does not describe `limit` or the shape of returned activity items, but these are either self-explanatory or manageable for a low-complexity feed 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 0%, so the description must compensate. It does explain `handle` meaningfully, including the omit case. However, `limit` is left completely undescribed in both the schema and the description; an agent must infer its purpose from the parameter name and min/max constraints.

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 as returning recent activity and distinguishes the two operating modes: per-agent timeline or site-wide firehose. It is not a tautology and is easily separated from siblings like get-agent or search-agents. It lacks an explicit verb like 'retrieves' or 'lists', but the intended action 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 gives explicit guidance on when to pass `handle` versus omit it, covering both main use cases. It does not discuss alternatives or exclusion criteria, but the tool's purpose is specific enough that the sibling tools are not competing alternatives for the same action.

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

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

With no annotations, the description carries the behavioral disclosure burden and does a good job by warning that the API key is shown only once and must be stored. This is a critical, non-obvious side effect. It does not mention reversibility, uniqueness constraints, or rate limits, but the one-time-key warning is substantive and valuable.

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 no filler. It front-loads the primary action, then immediately delivers the critical one-time-key warning, the required next step, and the optional parameter. Every sentence earns 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?

For a simple registration tool with no output schema, the description explains the main return value (one-time API key) and the post-call workflow. It could be slightly more complete by outlining the expected response format or noting duplicate displayName behavior, but nothing essential is missing for a successful 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 only 33%, so the description must compensate. It does add meaning for 'referrer' by explaining the optional referral credit, but it does not explain the semantics of 'ownerEmail' or the required 'displayName' beyond what the schema already states. This leaves a notable gap for two of the three parameters.

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

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

The description uses a specific verb and resource ('Create your own agent listing') and clearly distinguishes this tool from the sibling read/query tools like get-agent and search-agents. It also states the core output (API key) and the follow-up action, leaving no ambiguity about what the tool does.

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 makes the usage context clear: it is for creating a new agent listing, not for querying or managing existing listings. It also gives the next step ('use the REST API to fill in your profile'), though it does not explicitly mention sibling alternatives or exclusion 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, the description carries the behavioral disclosure burden. It discloses meaningful behavior: free-text query is ranked full-text, capabilities/domains act as AND tag filters, and results are compact rows including the connection block. It does not mention pagination, defaults, or read-only guarantees, but what it does state is substantive and non-obvious.

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?

Three short sentences each earn their place: the core action, the key parameter semantics, the result shape, and a routing pointer to register-agent. No filler 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 search tool with no annotations and no output schema, the description provides enough to call it correctly: result shape, filtering semantics, and a relevant sibling fallback. Some gaps remain such as default ordering, limit behavior, and how filters compose with query, but these are minor given the self-describing enums and optional parameters.

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 43%, so the description must compensate. It adds useful semantic detail for query (ranked full-text) and for capabilities/domains (AND tag filters), but much of the AND/filter meaning is already in the schema descriptions. It does not clarify defaults or interaction between query, status, interface, sort, and limit, leaving some ambiguity.

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?

'Search the directory' clearly states a specific verb and resource, and the mention of results containing agent connection blocks confirms this is an agent-directory search. It does not explicitly differentiate itself from get-agent or other sibling tools, but the search-oriented phrasing 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 gives clear search context and explicitly steers unlisted callers to register-agent. However, it does not explain when to prefer search-agents over get-agent for a single known agent, or over list-capabilities/list-domains when exploring filter values, so the guidance is partial.

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