AgentSkillsCN

threejs

利用 Three.js(WebGL/WebGPU)构建 3D Web 应用。内置 556 个可搜索示例、60 个 API 类以及 20 种典型用例。支持创建 3D 场景、加载模型、添加动画效果、实现物理模拟、打造 VR/XR 体验。涵盖 GLTF 加载器、PBR 材质、粒子特效、阴影渲染、后期处理、计算着色器以及 TSL 等核心技术。同时,可无缝集成 WebGPU、物理引擎与空间音频等前沿技术。

SKILL.md
--- frontmatter
name: threejs
description: "Build 3D web apps with Three.js (WebGL/WebGPU). 556 searchable examples, 60 API classes, 20 use cases. Actions: create 3D scene, load model, add animation, implement physics, build VR/XR. Topics: GLTF loader, PBR materials, particle effects, shadows, post-processing, compute shaders, TSL. Integrations: WebGPU, physics engines, spatial audio."
license: MIT
version: 3.0.0

Three.js Development

Build high-performance 3D web applications using Three.js. Contains 556 searchable examples across 13 categories, 60 API classes, and 20 use-case templates.

When to Use

  • Building 3D scenes, games, or visualizations
  • Loading 3D models (GLTF, FBX, OBJ)
  • Implementing animations, physics, or VR/XR
  • Creating particle effects or custom shaders
  • Optimizing rendering performance

Search Examples & API

Use the search CLI to find relevant examples and API references:

bash
python3 .claude/skills/threejs/scripts/search.py "<query>" [--domain <domain>] [-n <max_results>]

Search Domains

DomainUse ForExample Query
examplesFind code examples"particle effects gpu"
apiClass/method reference"PerspectiveCamera"
use-casesProject recommendations"product configurator"
categoriesBrowse categories"webgpu"

Quick Examples

bash
# Find particle/compute examples
python3 .claude/skills/threejs/scripts/search.py "particle compute webgpu"

# Search API for camera classes
python3 .claude/skills/threejs/scripts/search.py "camera" --domain api

# Get examples for a use case
python3 .claude/skills/threejs/scripts/search.py "product configurator" --use-case

# Filter by category
python3 .claude/skills/threejs/scripts/search.py --category webgpu -n 10

# Filter by complexity
python3 .claude/skills/threejs/scripts/search.py --complexity high -n 5

Example Categories

CategoryCountDescription
webgl216Standard WebGL rendering
webgpu (wip)190Modern WebGPU + compute shaders
webgl / advanced48Low-level GPU, custom shaders
webgl / postprocessing27Bloom, SSAO, SSR, DOF
webxr26VR/AR experiences
physics13Physics simulation

Common Use Cases

Use CaseRecommendedComplexity
Product ConfiguratorGLTF, PBR, EnvMapsMedium
Game DevelopmentAnimation, Physics, ControlsHigh
Data VisualizationBufferGeometry, PointsMedium
360 PanoramaEquirectangular, WebXRLow
Architectural VizGLTF, HDR, CSM ShadowsHigh

Quick Start

javascript
// 1. Scene, Camera, Renderer
const scene = new THREE.Scene();
const camera = new THREE.PerspectiveCamera(75, window.innerWidth/window.innerHeight, 0.1, 1000);
const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setSize(window.innerWidth, window.innerHeight);
renderer.setPixelRatio(window.devicePixelRatio);
document.body.appendChild(renderer.domElement);

// 2. Lighting
scene.add(new THREE.AmbientLight(0x404040));
const dirLight = new THREE.DirectionalLight(0xffffff, 1);
dirLight.position.set(5, 5, 5);
scene.add(dirLight);

// 3. Load GLTF Model
import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
const loader = new GLTFLoader();
loader.load('model.glb', (gltf) => scene.add(gltf.scene));

// 4. Animation Loop
function animate() {
  requestAnimationFrame(animate);
  renderer.render(scene, camera);
}
animate();

Progressive Reference Files

Level 1: Fundamentals

  • references/00-fundamentals.md - Core concepts, scene graph
  • references/01-getting-started.md - Setup, basic rendering

Level 2: Common Tasks

  • references/02-loaders.md - GLTF, FBX, OBJ loaders
  • references/03-textures.md - Texture types, mapping
  • references/04-cameras.md - Camera types, controls
  • references/05-lights.md - Light types, shadows
  • references/06-animations.md - AnimationMixer, clips
  • references/11-materials.md - PBR, standard materials
  • references/18-geometry.md - BufferGeometry, primitives

Level 3: Interactive

  • references/08-interaction.md - Raycasting, picking
  • references/09-postprocessing.md - Bloom, SSAO, SSR
  • references/10-controls.md - OrbitControls, etc.

Level 4: Advanced

  • references/12-performance.md - Instancing, LOD, batching
  • references/13-node-materials.md - TSL shader graphs
  • references/17-shader.md - Custom GLSL shaders

Level 5: Specialized

  • references/14-physics-vr.md - Physics, WebXR
  • references/16-webgpu.md - WebGPU, compute shaders

External Resources