MUST READ before creating, modifying, or querying annotations. Contains parameter names, coordinate model, and API quirks.
MUST READ before creating, modifying, or querying annotations. Contains parameter names, coordinate model, and API quirks.
npx skills add https://github.com/dylanroscover/Embody --skill manage-annotations复制此命令并粘贴到 Claude Code 中以安装该技能
MUST READ before calling create_op. Contains required verification, positioning, and error-checking steps.
MUST READ before writing TD Python via execute_python, set_dat_content, or edit_dat_content. API reference for parameters, storage, operators, threading.
Workflow for running multiple TD instances with Envoy, switching between them, and understanding the instance registry.
MUST READ before first MCP tool call in a session. Complete Envoy tool catalog with parameters and usage.
MUST READ before calling externalize_op or save_externalization. Required workflow steps.
MUST READ before calling create_extension. Required parameters, lifecycle methods, and wiring steps.
| name | manage-annotations |
| description | MUST READ before creating, modifying, or querying annotations. Contains parameter names, coordinate model, and API quirks. |
create_annotation(
parent_path='/path/to/network',
mode='annotate', # 'annotate' (title bar), 'comment', or 'networkbox'
title='My Group',
text='Description of this group',
x=..., y=..., width=..., height=...,
color=[r, g, b], # Optional, floats 0-1
opacity=0.5 # Optional
)
Always favor annotations over OP comments for documenting operators or groups.
To create an annotation that encloses a group of operators:
get_network_layout on the parent COMP (includes all operator positions and bounding box)min_x, max_x, min_y, max_y (max includes operator width/height: max_x = max(op_x + op_w), max_y = max(op_y + op_h))nodeX = min_x - 70nodeY = min_y - 70 (BELOW operators, not above!)nodeWidth = max_x - min_x + 140nodeHeight = max_y - min_y + 240 (70 bottom + 170 top)nodeX/nodeY = bottom-left corner, width/height extend rightward and upwardnodeY above the operators. nodeY must be BELOW (less than) the lowest operator's Y.get_annotations — list all annotations in a COMP with properties and enclosed operatorsget_enclosed_ops — get operators enclosed by an annotation, or annotations enclosing an operatorset_annotation — modify text, title, color, opacity, position, or sizeannotateCOMP Quirksutility property: True from TD UI, False from code. Set ann.utility = True to match TD behavior..type returns 'annotate' (not 'annotateCOMP')findChildren(type=annotateCOMP) requires the class object, not the string