feat(skills): expand touchdesigner-mcp coverage with 9 new reference docs#16768
Merged
kshitijk4poor merged 2 commits intoApr 28, 2026
Merged
Conversation
…icles, projection refs Adds four new reference docs covering common TD use cases not previously documented in the skill: - animation.md: LFOs, timers, keyframes, easing, time references - midi-osc.md: MIDI controllers, OSC routing, TouchOSC, multi-machine sync - particles.md: POPs and particleSOP — emission, forces, collisions, render - projection-mapping.md: windowCOMP, corner pin, mesh warp, edge blending Also clarifies the SKILL.md tool quick reference: adds td_screen_point_to_global and notes that 4 admin/dev-mode tools (td_project_quit, td_test_session, td_dev_log, td_clear_dev_log) live only in mcp-tools.md to keep the main reference focused on creative workflows. No SKILL.md workflow or critical-rules changes. References load on demand so no token-budget impact at session start.
…ator, dat-scripting, 3d-scene Five additional reference docs covering common TD use cases that were not yet documented in any reference (operators.md lists the ops, but no usage patterns). - external-data.md: webDAT, webclientDAT, webserverDAT, websocketDAT, mqttClientDAT, serialDAT, tcpipDAT — auth, polling, push, JSON parsing - panel-ui.md: custom parameter pages, button/slider/field/list COMPs, containerCOMP layouts, panelExecuteDAT callbacks - replicator.md: replicatorCOMP for data-driven cloning, per-row overrides, recreatemissing pattern, replicator vs Python loop - dat-scripting.md: full Execute DAT family — chopExecuteDAT, datExecuteDAT, parameterExecuteDAT, panelExecuteDAT, opExecuteDAT, executeDAT lifecycle - 3d-scene.md: light types, three-point rigs, shadows, IBL/cubemaps, PBR materials with idiom table, multi-camera, DOF Same conventions as existing refs: code-first, verify param names with td_get_par_info, no token-budget impact (load on demand).
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds 9 new reference docs to the
touchdesigner-mcpskill covering common TD use cases the skill didn't yet document, and tightens SKILL.md to accurately reflect tool coverage. The goal is closing real gaps between the skill's content and what TD users actually do — not exhaustive TD documentation.What's added
Motion / time / signal
references/animation.mdabsTimevsme.time, easing in expressions, animationCOMP keyframesreferences/midi-osc.mdVisual / output / sim
references/particles.mdpopSourceTOP→ forces → solver), legacy particleSOP, instancing/renderreferences/projection-mapping.mdreferences/3d-scene.mdData / control / network
references/external-data.mdreferences/panel-ui.mdreferences/replicator.mdreferences/dat-scripting.mdSKILL.md changes
td_screen_point_to_globalto Input Automation quick reference (was missing — natural companion to the screenshot tools).td_project_quit,td_test_session,td_dev_log,td_clear_dev_logare admin/dev-only and live only inmcp-tools.md.No changes to: critical rules, workflow steps, setup/install, the 36-native-tools claim.
Architecture compliance
td_get_par_infoif param names look fishy" style ofaudio-reactive.mdandpostfx.md.Caveats
td_get_par_infobefore trusting specific names.popSourceTOP.par.burst,glslMAT.par.instancingTOP,envlightCOMPexact param names, animationCOMP keyframe API), the doc explicitly directs the agent totd_get_par_info/td_get_docsrather than asserting a specific name.Still uncovered (for follow-up PRs)
These remain gaps, intentionally left for separate PRs:
videoDeviceInTOP, NDI in/out, Syphon/Spout patterns)bulletSolverCOMPrigid body, cloth, constraints)Diff stats
10 files changed, 2327 insertions(+), 1 deletion(-) — all inside
skills/creative/touchdesigner-mcp/.