Mode d’emploi
- Copiez la commande et examinez le paquet avant de l’installer dans votre environnement agent.
- Consultez le document original pour les outils, identifiants et environnements requis.
- Décrivez les entrées et le livrable souhaité ; comparez la sortie aux sources.
npx skills add https://github.com/full-stack-skills/threejs-skills --skill threejs-node-tslAvant de commencer
- L’installation n’inclut ni abonnement au modèle, ni quota API, ni accès aux fichiers.
- Étoiles et installations reflètent l’activité, pas un test indépendant de qualité ou de sécurité.
Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.
When to use this skill
ALWAYS use this skill when the user mentions:
NodeMaterial,TSL, imports fromthree/nodesor 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
| Situation | Skill |
|---|---|
| Standard PBR tuning, no nodes | threejs-materials |
| TSL graph, NodeMaterial, WGSL path | threejs-node-tsl |
Classic EffectComposer + Pass classes | threejs-postprocessing |
| Node post passes listed under Addons TSL in docs | threejs-node-tsl + threejs-postprocessing awareness |
Trigger phrases include:
- "TSL", "NodeMaterial", "three/nodes", "WebGPU", "node builder"
- "节点材质", "着色语言 TSL"
How to use this skill
- Decide path: WebGPU + nodes vs WebGL + classic materials—do not hybridize blindly.
- Anchor docs: start from Nodes index and TSL.html; use NodeMaterial for material entry.
- 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.
- Renderer: enable
WebGPURendererper docs; fall back notes belong in threejs-renderers. - Debugging: use version-stamped examples in three.js repo; avoid copying deprecated import paths.
- Post stack: if user names
PostProcessingcore class vs addon composer, clarify table in threejs-renderers / threejs-postprocessing.
Doc map (official)
| Docs section | Representative links |
|---|---|
| Nodes | https://threejs.org/docs/#Nodes |
| TSL | https://threejs.org/docs/TSL.html |
| NodeMaterial | https://threejs.org/docs/NodeMaterial.html |
| WebGPU renderer | https://threejs.org/docs/WebGPURenderer.html |
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
PostProcessingclass with addonsEffectComposer—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:
- Anchor on TSL.html and/or
#Nodesrather than inventing API names. - Contrast threejs-materials (classic) vs node/TSL path explicitly.
- Warn that WebGPU + nodes examples may require recent minors—cite version when known.
- Point to references/tsl-vs-classic.md and references/official-links.md for long lookups.
- Disambiguate core
PostProcessingvs addonEffectComposer(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