Dynamo Automation

Dynamo Automation Skill

Note for All AI Agents:
This is the Antigravity-specific Skill wrapper with auto-triggering capability.
Universal Documentation: See ../../docs/ai-guide/quick-start.md for complete guidance.

Fast-track workflow for controlling Autodesk Dynamo through Model Context Protocol (MCP).

For Non-Antigravity Users

If you're using Claude Desktop, Gemini CLI, or other AI agents:

• This Skill will not auto-trigger
• Please refer to docs/ai-guide/quick-start.md directly
• All MCP tools work the same across all AI agents

Quick Start

1. Environment Check

python .skills/dynamo-automation/scripts/check_connection.py

If connection fails → See Troubleshooting

2. Choose Your Strategy

Decision Tree:

User Request
    ├─ Simple geometry with fixed params?
    │  └─ Use Code Block Strategy → references/code_block_strategy.md
    │
    ├─ Parameterized nodes?
    │  └─ Use Native Node Strategy → references/native_node_strategy.md
    │
    ├─ Python script injection?
    │  └─ Use Python Injection → references/python_injection.md
    │
    └─ Connect nodes?
       └─ Use Connection Patterns → references/connection_patterns.md

Core Workflows

Node Creation

Strategy Selection:

Quick Templates:

• See assets/templates/ for ready-to-use JSON examples

Python Script Injection

Triple-Guarantee Mechanism:

1. Name Loop - Try multiple node names for cross-version compatibility
2. Dedicated Command - Use UpdatePythonNodeCommand via reflection
3. Forced UI Sync - Call OnNodeModified(true) to refresh UI

Full details: python_injection.md

Quick Template:

{
  "nodes": [{
    "id": "py_script",
    "name": "Python Script",
    "pythonCode": "OUT = IN[0]",
    "x": 500,
    "y": 300
  }]
}

Node Connection

Critical Rules:

• ✅ Use fromPort / toPort (0-indexed)
• ❌ Never use fromIndex / toIndex (invalid fields)
• ✅ Ensure ID mapping exists before connecting

Full details: connection_patterns.md

Quick Template:

{
  "connectors": [{
    "from": "node_a",
    "to": "node_b",
    "fromPort": 0,
    "toPort": 0
  }]
}

Workspace Analysis

Analyze current state:

python .skills/dynamo-automation/scripts/analyze_workspace.py

Returns:

• Workspace name & file path
• Node count & types
• Connection status
• Error/warning flags

Templates Library

Location: assets/templates/

Usage:

# Load template
import json
with open('.skills/dynamo-automation/assets/templates/point_basic.json') as f:
    template = json.load(f)

# Modify coordinates
template['nodes'][0]['value'] = "Point.ByCoordinates(100, 200, 300);"

# Execute
await execute_dynamo_instructions(json.dumps(template))

Common Patterns

Pattern 1: Code Block (Simple Geometry)

{
  "nodes": [{
    "id": "geom1",
    "name": "Number",
    "value": "Point.ByCoordinates(0, 0, 0);",
    "x": 300,
    "y": 300
  }]
}

Pattern 2: Native Node (Parameterized)

{
  "nodes": [{
    "id": "cube1",
    "name": "Cuboid.ByLengths",
    "params": {"width": 100, "length": 50, "height": 30},
    "x": 500,
    "y": 300
  }]
}

Pattern 3: Python Script

{
  "nodes": [{
    "id": "py1",
    "name": "Python Script",
    "pythonCode": "import clr\nOUT = 'Hello Dynamo'",
    "x": 500,
    "y": 300
  }]
}

Troubleshooting

Issue: Connection failed

Check:

1. Is Python WebSocket server running? (python bridge/python/server.py)
2. Is Dynamo open with workspace active?
3. Run scripts/check_connection.py for diagnostics

Solutions: See troubleshooting.md

Issue: Node created but not visible

Cause: Ghost connection (old Dynamo session)

Solution:

1. Close Dynamo completely
2. Restart Python server
3. Reopen Dynamo
4. Reconnect

Details: troubleshooting.md

References

All detailed technical documentation is in references/:

• code_block_strategy.md - Code Block approach (Track A)
• native_node_strategy.md - Native Node approach (Track B)
• python_injection.md - Python Script automation
• connection_patterns.md - Node connection mechanics
• troubleshooting.md - Common issues & solutions

Skill Version: 1.0
Last Updated: 2026-01-24
Maintained by: Dynamo MCP Team

Converted and distributed by TomeVault — claim your Tome and manage your conversions.