td-python

Centralizes utility modules, linting, and environment management for TouchDesigner Python projects.

1|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/GuiGPaP/TD_starter_pack --skill td-python-guigpap
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: td-python
Source: https://github.com/GuiGPaP/TD_starter_pack/tree/main/.agents/skills/td-python
Command: npx skills add https://github.com/GuiGPaP/TD_starter_pack --skill td-python-guigpap

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

TouchDesigner Python tooling that centralizes utility modules, code quality workflows, and per-project environment management to streamline development and reliability in TD workflows.

Core Features & Use Cases

  • Utility modules for TD Python: TDFunctions, TDJSON, TDStoreTools, TDResources.
  • Linting, formatting, and type-checking using ruff/pyright with TD-aware guardrails.
  • Automated correction loops, JSON serialization of TD data, and environment setup via tdPyEnvManager.
  • Real-world scenarios include serializing operator data to JSON, persisting settings with StorageManager, and provisioning project-specific Python environments.

Quick Start

Install and activate the skill, then run linting on Python DATs, apply safe fixes, and configure a per-project TD Python environment with tdPyEnvManager.

Frequently Asked Questions about td-python

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

FAQPage Schema
How do I lint Python code in TouchDesigner DATs using ruff?

Lint Python code in TouchDesigner DATs using ruff by applying TD-aware guardrails that identify code quality issues specific to TD environments. The toolkit automates correction loops and applies safe fixes directly to your DATs.

What is the best way to serialize TouchDesigner operator data to JSON?

Serialize TouchDesigner operator data to JSON using built-in TDJSON utility modules. This toolkit provides standardized JSON serialization patterns to reliably export and persist TD data structures.

How do I set up a per-project Python environment for TouchDesigner?

Set up a per-project Python environment for TouchDesigner using tdPyEnvManager to configure venv or conda. This ensures reproducible TD projects by managing dependencies through requirements.txt and TDPyEnvManagerContext.yaml.

Can I persist settings in TouchDesigner using TDStoreTools?

Persist settings in TouchDesigner using TDStoreTools through the StorageManager pattern provided by this toolkit. It centralizes storage utilities so you can reliably save and retrieve project configurations.

Does TouchDesigner Python tooling support automated code fixing?

TouchDesigner Python tooling supports automated code fixing through correction loops that apply safe ruff fixes to Python DATs. It enforces code quality workflows with TD-specific guardrails to prevent breaking changes.