full-stack-skills/threejs-skills

threejs-objects

three.js scene graph objects: Object3D transforms and hierarchy, Group, Mesh, InstancedMesh, SkinnedMesh, BatchedMesh, LOD, Line/LineLoop/LineSegments, Points, Sprite, Bone, Skeleton, ClippingGroup; interaction via Raycaster, Layers masks, and EventDispatch…

查看源码

使用方法

  1. 复制安装命令,在自己的智能体环境安装前先检查源码包。
  2. 从原始文档核对所需工具、凭据和支持的宿主。
  3. 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/full-stack-skills/threejs-skills --skill threejs-objects

开始前需了解

  • 安装不包含模型订阅、API 额度或访问文件的权限。
  • 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
仓库原始内容

按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。

When to use this skill

ALWAYS use this skill when the user mentions:

  • Parent/child relationships, position/rotation/scale, matrixAutoUpdate, updateMatrixWorld
  • Choosing mesh types: static vs instanced vs skinned vs batched LOD
  • Picking: Raycaster.setFromCamera, intersectObjects, recursive flag, face/uv results
  • Layers: selective visibility for cameras/lights/objects

IMPORTANT: objects vs math

NeedSkill
Scene graph + pickingthreejs-objects
Box/ray math onlythreejs-math

Trigger phrases include:

  • "Object3D", "InstancedMesh", "SkinnedMesh", "Raycaster", "layers"
  • "父子节点", "射线拾取", "图层"

How to use this skill

  1. Compose scenes with Group and transforms; minimize deep hierarchies where possible.
  2. Instancing: set per-instance matrices; understand count and frustum culling behavior.
  3. SkinnedMesh: bind skeleton; clips in threejs-animation; skinning material flags in threejs-materials.
  4. Picking: normalize device coords, set ray from camera, filter by layers, sort intersections.
  5. Events: EventDispatcher on custom objects—patterns only, not DOM frameworks.
  6. Clipping: ClippingGroup usage per docs when user needs sectional cuts.
  7. Dispose: geometries/materials/textures when removing objects permanently.

See examples/workflow-raycaster-pick.md.

Doc map (official)

Docs sectionRepresentative links
Corehttps://threejs.org/docs/Object3D.html
Objectshttps://threejs.org/docs/Mesh.html
Objectshttps://threejs.org/docs/InstancedMesh.html
Corehttps://threejs.org/docs/Raycaster.html

Scope

  • In scope: Object3D graph, renderable object types, raycasting, layers, dispatcher basics.
  • Out of scope: Physics engines; XR input mapping (threejs-webxr).

Common pitfalls and best practices

  • Forgetting updateMatrixWorld before world-space ray tests on moved objects.
  • Raycaster without layers set picks unintended objects—set masks consistently on camera and objects.
  • InstancedMesh raycast hits need per-instance handling—check docs for your version.

Documentation and version

Object3D, mesh types, Raycaster, and Layers are documented under Objects and Core in three.js docs. Behavior of picking and layers can shift slightly—link the exact page for the user’s three.js line.

Agent response checklist

When answering under this skill, prefer responses that:

  1. Link Object3D, Mesh, InstancedMesh, Raycaster, or Layers as needed.
  2. Pair skeletal animation with threejs-animation and skinned mesh setup.
  3. Route pure linear-algebra questions without a scene graph to threejs-math.
  4. Route XR input to threejs-webxr when sessions/controllers are involved.
  5. Mention dispose() for geometries/materials when removing objects permanently.

References

  • https://threejs.org/docs/Object3D.html
  • https://threejs.org/docs/Raycaster.html
  • https://threejs.org/docs/Layers.html
  • https://threejs.org/docs/InstancedMesh.html

Keywords

English: object3d, mesh, instancedmesh, skinnedmesh, raycaster, layers, scene graph, three.js

中文: 场景图、Object3D、Mesh、实例化、骨骼网格、射线拾取、图层、three.js

来自同一仓库

更多 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日