threejs-node-tsl

When to use this skill

ALWAYS use this skill when the user mentions:

• NodeMaterial, TSL, imports from three/nodes or WebGPU entry points in docs
• Building materials or post effects from nodes instead of string GLSL
• WebGPURenderer, PostProcessing (core class) in a node-centric pipeline

IMPORTANT: node-tsl vs materials vs postprocessing

Trigger phrases include:

• "TSL", "NodeMaterial", "three/nodes", "WebGPU", "node builder"
• "节点材质", "着色语言 TSL"

How to use this skill

1. Decide path: WebGPU + nodes vs WebGL + classic materials—do not hybridize blindly.
2. Anchor docs: start from Nodes index and TSL.html; use NodeMaterial for material entry.
3. Progressive disclosure: keep SKILL.md navigational; long symbol lists live in references/official-links.md and references/tsl-vs-classic.md; see examples/workflow-tsl-entry.md for navigation habits.
4. Renderer: enable WebGPURenderer per docs; fall back notes belong in threejs-renderers.
5. Debugging: use version-stamped examples in three.js repo; avoid copying deprecated import paths.
6. Post stack: if user names PostProcessing core class vs addon composer, clarify table in threejs-renderers / threejs-postprocessing.

Doc map (official)

Scope

• In scope: Nodes/TSL discovery, architecture, renderer pairing, where to look next, migration hints from ShaderMaterial.
• Out of scope: Pasting entire TSL symbol tables into SKILL.md; guaranteeing API stability across rapid releases—always cite "current docs".

Common pitfalls and best practices

• Three.js node APIs evolve quickly—tie answers to a version or "current docs".
• Do not confuse core PostProcessing class with addons EffectComposer—names collide in conversation.
• WGSL vs GLSL expectations differ; TSL abstracts but limits still apply.
• Keep graphs modular; use references for lookup instead of bloating agent context.

Documentation and version

The Nodes index and TSL page are large and fast-moving. Treat https://threejs.org/docs/ as the source of truth for the user’s installed three.js; prefer linking NodeMaterial and WebGPURenderer over paraphrasing long symbol lists.

Agent response checklist

When answering under this skill, prefer responses that:

1. Anchor on TSL.html and/or #Nodes rather than inventing API names.
2. Contrast threejs-materials (classic) vs node/TSL path explicitly.
3. Warn that WebGPU + nodes examples may require recent minors—cite version when known.
4. Point to references/tsl-vs-classic.md and references/official-links.md for long lookups.
5. Disambiguate core PostProcessing vs addon EffectComposer (threejs-postprocessing).

References

• https://threejs.org/docs/#Nodes
• https://threejs.org/docs/TSL.html
• https://threejs.org/docs/NodeMaterial.html
• https://threejs.org/docs/WebGPURenderer.html

Keywords

English: tsl, node material, nodes, webgpu, wgsl, three.js shading language, node builder, nodematerial

中文： TSL、节点材质、WebGPU、着色语言、NodeMaterial、three.js