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…

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/full-stack-skills/threejs-skills --skill threejs-helpers

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

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

같은 저장소의 Skills

더 많은 Skills

모든 Skills
full-stack-skills
커뮤니티

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.

1시간 설치 수
3
GitHub Stars
14
업데이트
10월 3일
full-stack-skills
커뮤니티

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.

1시간 설치 수
3
GitHub Stars
14
업데이트
10월 3일
full-stack-skills
커뮤니티

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.

1시간 설치 수
3
GitHub Stars
14
업데이트
10월 3일
full-stack-skills
커뮤니티

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

1시간 설치 수
3
GitHub Stars
14
업데이트
10월 3일