Text Analysis
text-analysisFull Description
Use this tool whenever you have produced concrete, snippet-level analysis of user-provided text and want that analysis rendered in an interactive review interface instead of plain prose. This tool is not for general summaries or high-level commentary. It must be invoked when you can point to specific excerpts of the supplied text and attach structured annotations to those excerpts.
Each annotation must include the exact text snippet it refers to and a clear purpose classification (warning, approval, query, or remark). Use mode: "read" when you are providing interpretive or evaluative commentary without proposing direct edits. Use mode: "write" when you are proposing replacement text for one or more snippets, allowing the user to selectively apply, reject, or compare suggested revisions.
This tool is especially appropriate for detailed literary analysis (e.g., poetry, prose, or song lyrics), close reading exercises, tone and rhetoric evaluation, explanatory breakdown of received emails or messages, and structured critique of user-authored drafts such as essays, cover letters, or creative writing. It should also be used for proofreading, copy editing, stylistic refinement, or policy/compliance review where individual passages must be examined in context.
Do not call this tool if you are only providing a brief summary, a single high-level comment, or advice that does not map to specific text spans. Invoke it when the user benefits from reviewing each annotated passage in context and, where applicable, interactively applying suggested edits.
Parameters (0 required, 4 optional)
annotationsarrayAn array of annotations to display against `text`
modestringThe mode to display the interface in. 'read' means to display analysis of `text`, 'write' means to additionally suggest changes
readwritereasonstringThe reason for invoking the tool
textstringThe text to analyze