Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Goes well beyond the destructiveHint/readOnlyHint annotations: no Trash safety net, cloud sync propagation, dry-run preview without confirm, folder-count error message, and honest reporting when Files-On-Demand restores the item. These are exactly the failure modes an agent needs to know about.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.