Delete a TikTok video

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

With no annotations provided, the description must fully disclose behavioral traits. It only indicates the scope ('connected account's videos') but omits critical details such as whether deletion is permanent or reversible, any permission requirements, or whether the operation might be asynchronous (suggested by tiktok_operation_status sibling).

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 with no redundancy or filler. It is front-loaded with the action and resource.

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 destructive operation with no output schema and no annotations, the description is too sparse. It does not mention success/error behavior, irreversibility, or any interaction with asynchronous status tools like tiktok_operation_status. This leaves the agent uncertain about expected outcomes.

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 description does not elaborate on parameters. video_url lacks a schema description, and the tool description adds no explanation of expected URL format or how it relates to account_id. Schema coverage is only 50%, and the description does not compensate.

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 action (Delete) and the resource (one of the connected account's videos). It distinguishes itself from sibling tools like tiktok_post or tiktok_cancel_scheduled by specifying the deletion of an existing video.

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 vs alternatives. For example, it does not clarify whether it handles scheduled videos (distinct from tiktok_cancel_scheduled) or any prerequisites like account connection status. The description offers no exclusions or alternative tool references.

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