full-stack-skills/threejs-skills

threejs-helpers

Debug and visualization helpers in three.js Core Helpers (AxesHelper, GridHelper, CameraHelper, light helpers, SkeletonHelper, bounding box helpers, PlaneHelper, PolarGridHelper, ArrowHelper) and Addons Helpers (VertexNormalsHelper, VertexTangentsHelper, Re…

Ver código-fonte

Como usar

  1. Copie o comando e verifique o pacote antes de instalar no seu ambiente de agente.
  2. Consulte no original as ferramentas, credenciais e ambientes necessários.
  3. Descreva os dados de entrada e a entrega esperada; confira a saída com as fontes.
npx skills add https://github.com/full-stack-skills/threejs-skills --skill threejs-helpers

Antes de começar

  • A instalação não inclui assinatura de modelo, franquia API ou acesso aos seus arquivos.
  • Estrelas e instalações indicam atividade, não um teste independente de qualidade ou segurança.
Documento original do Skill

Renderizado do repositório de origem, preservando títulos, exemplos, código, tabelas, links e imagens.

When to use this skill

ALWAYS use this skill when the user mentions:

  • Visualizing axes, grids, camera frusta, shadow cameras, light directions
  • Showing skeleton bones, bounding boxes, normals/tangents for mesh inspection
  • Light probe or rect area visualization via helper classes

IMPORTANT: helpers vs production meshes

  • Helpers are debug objects; do not use as final scene geometry.

Trigger phrases include:

  • "AxesHelper", "GridHelper", "CameraHelper", "SkeletonHelper", "VertexNormalsHelper"
  • "辅助线", "法线显示", "包围盒调试"

How to use this skill

  1. Attach helper to the object it describes (e.g., CameraHelper(light.shadow.camera)).
  2. Update when targets move—some helpers need per-frame refresh.
  3. Remove in production builds or behind debug flags.
  4. Performance: helpers add draw calls—disable when profiling performance issues.
  5. Addons: import from three/addons/helpers/... paths per threejs-dev-setup.

See examples/workflow-light-camera-helpers.md.

Doc map (official)

Docs sectionRepresentative links
Helpershttps://threejs.org/docs/AxesHelper.html
Helpershttps://threejs.org/docs/GridHelper.html
Helpershttps://threejs.org/docs/CameraHelper.html
Helpershttps://threejs.org/docs/SkeletonHelper.html

Scope

  • In scope: Core + Addons helpers for visualization.
  • Out of scope: Production meshes or shipping art (threejs-geometries, threejs-lights); orbit/transform gizmo behavior (threejs-controls); editor UX parity with DCC tools; physics debug beyond helper stubs.

Common pitfalls and best practices

  • Too many helpers obscures view—toggle per subsystem.
  • Wrong attachment parent misaligns helper transforms.
  • Helpers inherit scene graph transforms—parent under a debug group to batch hide/show.
  • Some helpers duplicate geometry cost; strip in production or use #ifdef DEBUG style flags.
  • CameraHelper for shadow cameras must reference light.shadow.camera, not the main view camera.

Documentation and version

Helpers are listed under Helpers (core) and Addons → Helpers in three.js docs. They are for debug only; production meshes and lighting should use real geometry/lights (threejs-geometries, threejs-lights).

Agent response checklist

When answering under this skill, prefer responses that:

  1. Link the helper class (AxesHelper, CameraHelper, …) being used.
  2. State that helpers are not shipping art—strip or gate behind debug flags.
  3. Pair shadow/light helpers with threejs-lights tuning workflows.
  4. Mention performance cost when many helpers are enabled.
  5. Import paths follow threejs-dev-setup addon conventions.

References

  • Manual (debug workflow context): https://threejs.org/manual/
  • Docs index (Helpers group): https://threejs.org/docs/#Helpers
  • Examples: https://threejs.org/docs/DirectionalLightHelper.html

Keywords

English: helper, debug, axes, grid, skeleton, normals, light helper, three.js

中文: 辅助、调试、坐标轴、网格、骨架、法线、Helper、three.js

do mesmo repositório

Mais Skills

Todos os Skills
full-stack-skills
Comunidade

threejs-audio

three.js audio spatialization: AudioListener attached to camera rig, Audio and PositionalAudio sources, AudioAnalyser for FFT/time-domain data, and integration with Web Audio API contexts; AudioLoader is referenced from threejs-loaders for file decoding. Use when placing 3D sound, configuring panner parameters, or visualization; not a replacement for full game audio middleware.

Instalações / 1h
3
GitHub Stars
14
Atualizado
3 de out.
full-stack-skills
Comunidade

threejs-camera

three.js cameras: Camera base, PerspectiveCamera, OrthographicCamera, CubeCamera, ArrayCamera, StereoCamera; projection matrices, aspect, FOV, orthographic frustum sizes, near/far planes, and dynamic environment maps with CubeCamera. Use when placing views, rendering reflections, or multi-view splits; for XR projections and eye matrices use threejs-webxr; for post pass camera tricks use threejs-postprocessing alongside threejs-renderers.

Instalações / 1h
3
GitHub Stars
14
Atualizado
3 de out.
full-stack-skills
Comunidade

threejs-controls

Addon camera and object manipulation controls: OrbitControls, MapControls, FlyControls, FirstPersonControls, TrackballControls, ArcballControls, DragControls, PointerLockControls, TransformControls; damping, target focal point, and integration with the animation loop. Use for editor-style navigation and gizmos—not a full game character controller stack; pair with Raycaster selection patterns in threejs-objects when transforming selections.

Instalações / 1h
3
GitHub Stars
14
Atualizado
3 de out.
full-stack-skills
Comunidade

threejs-dev-setup

Bootstrap and toolchain guidance for three.js applications using npm, Vite/Webpack/Rollup, bare ESM import maps, and TypeScript. Covers canonical import paths for three core versus three/addons/ (examples/jsm re-exports), version alignment with https://threejs.org/docs/, and fixing "module not found" for loaders and controls. Use when scaffolding a new 3D project, migrating bundler, or debugging resolution of addons—do not use for rendering API details (see threejs-renderers) or asset loading lo

Instalações / 1h
3
GitHub Stars
14
Atualizado
3 de out.