td-network-analysis

Analyzes and explains existing TouchDesigner .toe and .tox networks via offline MCP tools.

1|Updated Jun 4, 2026
One-click install
npx skills add https://github.com/TrueFiasco/TD_Builder_alpha --skill td-network-analysis-truefiasco
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: td-network-analysis
Source: https://github.com/TrueFiasco/TD_Builder_alpha/tree/main/Agents/td_network_analysis
Command: npx skills add https://github.com/TrueFiasco/TD_Builder_alpha --skill td-network-analysis-truefiasco

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Understanding an unfamiliar TouchDesigner network requires manually expanding .toe files, reading raw node and parameter files, and cross-referencing hundreds of operator types. This Skill automates that workflow by expanding and parsing the network in one call, then grounding every explanation in the official operator knowledge base. ## Core Features & Use Cases - One-Call Network Expansion: Uses expand_toe_file to parse a .toe/.tox into a structured map of operators, non-default parameters, and connections. - KB-Grounded Explanations: Looks up any of 640 TouchDesigner 2025 operators and their parameters via get_operator_info, get_parameter_detail, and hybrid_search instead of guessing. - Performance & Pattern Analysis: Identifies GPU/CPU bottlenecks, recognizes common patterns (audio-reactive, generative, 3D rendering), and corroborates findings against mined real-world network patterns. - Use Case: A user inherits a legacy .toe project and asks "what does this network do?" — the Skill expands the file, traces sources through transformations to outputs, and returns a plain-English pipeline summary with optimization recommendations. ## Quick Start Analyze the attached project.toe file and explain what the network does, including any performance bottlenecks.

Frequently Asked Questions about td-network-analysis

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze what a TouchDesigner .toe file does?

Call expand_toe_file with mode="summary" to get the full node and connection map with each operator's type and non-default parameters. Then trace sources through transformations to outputs and look up unfamiliar operators with get_operator_info.

How to find performance bottlenecks in a TouchDesigner network?

Check TOP resolutions above 1920x1080, count expensive operators like Blur, Edge, and Convolve, look for high-sample-rate CHOPs, and inspect complex Python Execute DATs. The Skill's Step 4 workflow covers GPU memory, CPU, and cook-time issues.

Can this skill edit or build TouchDesigner networks?

No, this skill is strictly read-only analysis of existing networks. To build new networks or live-edit a running TouchDesigner instance, load the td-builder-howto skill instead, which covers the build pipeline and live-TD tools.

Does TouchDesigner network analysis require an API key or internet access?

No, all required tools run offline through the local td-builder MCP server with no API key. The operator knowledge base is downloaded once during install via the fetch_vector_db.py script.

What TouchDesigner operator families are supported for analysis?

All seven families are covered: TOP, CHOP, SOP, MAT, DAT, COMP, and POP. The knowledge base documents 640 of the 647 operators in TouchDesigner 2025.32820, plus 23 retired or renamed entries.