browser_paste_from_clipboard

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

With no annotations, the description carries the full burden and does disclose the critical behavior: content never returns, only character count, and whitespace trimming default. It could add failure behavior but covers the privacy-relevant trait well.

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, front-loaded with the most important safety trait and purpose, no 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?

Low-complexity 2-param tool with no output schema; description explains what comes back (only character count) and the default trim behavior, which is sufficient for correct invocation. Minor gap: no mention of failure cases, but not essential.

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 already documents selector and trim with 100% coverage; description reinforces the trim default and how to disable it but adds no meaning beyond schema. Selector semantics are self-explanatory in 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?

States a specific action ('paste system clipboard into a form field') plus its key privacy property and pairing with browser_copy_to_clipboard, so it is clearly distinguishable from fill/click 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?

Explicitly frames the use case: moving credentials between pages/apps alongside browser_copy_to_clipboard. It does not spell out when to prefer fill or other input methods, but the context is clear enough for tool selection.

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