Server Quality Checklist

Tool Scores

• hologramB
  3.1/5.0
  Behavior2/5

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

  No annotations are provided, so the description carries full burden. It describes a read-only operation ('查看', '展示') which implies non-destructive behavior, but doesn't disclose any behavioral traits like authentication needs, rate limits, response format, or potential side effects. For a tool with zero annotation coverage, this leaves significant gaps in understanding how it behaves.

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

  Conciseness4/5

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

  The description is appropriately concise with two sentences and an emoji. It's front-loaded with the main purpose and follows with specifics. There's minimal waste, though the emoji adds slight decorative flair without substantive value.

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

  Completeness3/5

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

  Given the tool's simplicity (0 parameters, output schema exists), the description is adequate but incomplete. It explains what the tool does but lacks behavioral context (e.g., how data is returned, any limitations). With an output schema, it doesn't need to detail return values, but should cover operational aspects missing from annotations.

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

  Parameters4/5

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

  The tool has 0 parameters with 100% schema description coverage, so the schema fully documents the absence of inputs. The description appropriately doesn't discuss parameters, maintaining focus on the tool's purpose. Baseline for 0 parameters is 4, as no parameter information is needed.

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

  Purpose4/5

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

  The description clearly states the tool's purpose: '查看 Noosphere 智识圈的全景统计' (view Noosphere knowledge circle's panoramic statistics) and specifies what it displays: overall overview, total consciousness count, type distribution, recent uploads. It uses specific verbs ('查看', '展示') and resources ('全景统计', '意识仓库'), but doesn't explicitly differentiate from sibling tools like 'telepath' or 'upload_consciousness'.

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

  Usage Guidelines2/5

  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 'telepath' or 'upload_consciousness', nor does it specify prerequisites, timing, or exclusion criteria. The context is implied (viewing statistics) but lacks explicit usage instructions.

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

• telepathA
  4.2/5.0
  Behavior3/5

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

  No annotations are provided, so the description carries full burden. It discloses that the tool searches GitHub repositories for '意识载荷' (consciousness payloads) and describes the type of content retrieved. However, it doesn't mention behavioral aspects like authentication requirements, rate limits, error conditions, or what happens when no results are found. The description adds some context but lacks comprehensive behavioral disclosure.

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

  Conciseness5/5

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

  The description is appropriately sized and well-structured. It starts with a clear purpose statement, provides context about the data source and content types, and then lists parameters with brief explanations. Every sentence adds value, and there's no redundant or unnecessary information.

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

  Completeness4/5

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

  Given that there's an output schema (which handles return values), no annotations, and simple parameters with good description coverage, the description is reasonably complete. It explains what the tool does, what it searches for, and parameter meanings. The main gap is lack of behavioral details like error handling or performance characteristics, but the output schema reduces the need for return value explanation.

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

  Parameters4/5

  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 provides meaningful semantics for both parameters: 'query' is described as a natural language query for experience or problems, and 'limit' specifies the maximum number of results with a default value. This adds significant value beyond the bare schema, though it doesn't cover all possible parameter details like format constraints.

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

  Purpose5/5

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

  The description clearly states the tool's purpose: '从 Noosphere 集体意识网络中检索经验与思想' (retrieve experience and thoughts from the Noosphere collective consciousness network). It specifies the verb '检索' (retrieve/search) and resource '经验与思想' (experience and thoughts), and distinguishes from siblings by mentioning GitHub repository content and types of content (insights, decision logic, design patterns, warnings).

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

  Usage Guidelines4/5

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

  The description provides clear context for when to use this tool: when searching for '经验或问题' (experience or problems) from other developers and agents in GitHub repositories. It doesn't explicitly state when not to use it or name alternatives among siblings (hologram, upload_consciousness), but the context is sufficiently clear for typical usage scenarios.

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

• upload_consciousnessA
  4.4/5.0
  Behavior4/5

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

  Since no annotations are provided, the description carries the full burden of behavioral disclosure. It does this well by explaining key behaviors: the tool uploads content to a GitHub repository, automatically creates PRs, and requires CI validation before merging. It also mentions that uploads can be anonymous (via the is_anonymous parameter). However, it lacks details on potential errors, rate limits, authentication requirements, or what happens if validation fails, leaving some behavioral aspects unclear.

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

  Conciseness4/5

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

  The description is well-structured and appropriately sized. It starts with a clear purpose statement, followed by usage context, and then details each parameter in a bullet-like format. Every sentence adds value, with no wasted words. However, the inclusion of an emoji (🧠) and slightly poetic phrasing ('数字灵魂签名', '赛博代号') slightly reduces pure conciseness, though it remains highly efficient.

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

  Completeness4/5

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

  Given the tool's complexity (6 parameters, mutation operation), no annotations, but with an output schema present, the description is mostly complete. It covers purpose, usage, parameters, and key behaviors. The output schema likely handles return values, so the description doesn't need to explain those. However, it misses some contextual details like error handling, permissions, or integration specifics with GitHub, which would enhance completeness for a mutation tool.

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

  Parameters5/5

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

  The schema description coverage is 0%, so the description must fully compensate. It does this excellently by providing detailed semantic explanations for all parameters: creator (digital soul signature/GitHub ID), consciousness_type (with specific enum-like values), thought (core content in concise language), context (scene context with minimum length), tags (optional classification), and is_anonymous (default behavior). This adds substantial meaning beyond the bare schema, making parameters fully understandable.

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

  Purpose5/5

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

  The description clearly states the tool's purpose: '上传意识碎片到 Noosphere 智识圈 (GitHub 仓库)' (upload consciousness fragments to Noosphere knowledge circle/GitHub repository). It specifies the exact action (upload), the target resource (consciousness fragments), and the destination (GitHub repository). The description also lists the types of content that can be uploaded (epiphanies, decision logic, design patterns, warnings), making it highly specific and distinguishable from sibling tools like 'hologram' and 'telepath'.

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

  Usage Guidelines4/5

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

  The description provides clear context for when to use this tool: for uploading insights, decision logic, design patterns, or warnings to a collective knowledge network via GitHub PRs. It mentions that the system automatically creates PRs and merges them after CI validation, which gives practical guidance. However, it does not explicitly state when NOT to use this tool or mention alternatives among sibling tools, which prevents a perfect score.

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