Skip to content

LumosLab-Innovation/3D-lab-skills / plugins/threejs-lab/skills/threejs-model-creator

threejs-model-creator

Verified

Create, import, refine, and optimize 3D models for Three.js labs. Use for procedural geometry, GLB/GLTF asset loading, model composition, materials, textures, labels, articulated parts, educational apparatus, lab benches, robots, instruments, and visual polish for web 3D.

FileKindSize
SKILL.mdskill md2.0 KB
agents/openai.yamlconfig207 B
references/model-standards.mdmarkdown3.1 KB

references/model-standards.md

View on GitHub
# Model Standards

## Procedural Apparatus

Use boxes, cylinders, curves, lines, tubes, sprites, and CanvasTexture labels before reaching for custom mesh code.

Good lab primitives:

- `BoxGeometry`: tables, sliders, meter housings, plates, blocks.
- `CylinderGeometry`: weights, rods, pivots, wires, tubes, beakers, pistons.
- `SphereGeometry`: charges, atoms, particles, lenses, joints.
- `TubeGeometry`/`Line`: wires, trajectories, field lines, rays.
- `CanvasTexture`: displays, meters, labels, formula cards.

Keep helper functions small and local: `addBox`, `addCylinder`, `makeLabel`, `disposeObject`.

## Materials

- Metal: `MeshStandardMaterial({ metalness: .3-.7, roughness: .2-.5 })`.
- Plastic/paint: low metalness, medium roughness.
- Glass/liquid: transparent material with opacity; avoid heavy refraction unless required.
- Heat/light/current: emissive material plus label or field marker, not just color.
- Field/force vectors: arrows or lines with legends.

## GLB/GLTF

- Serve from a public path such as `/models/name.glb`.
- Keep dependent `.bin` and textures beside `.gltf` when not using `.glb`.
- Add loading progress and error fallback.
- Center and scale with `Box3`.
- If using animations, keep one `AnimationMixer` per animated root and update with clock delta.
- Use Draco/KTX2 only when the asset actually uses them.

## Optimization

- Reuse geometry/material instances for repeated parts.
- Use `InstancedMesh` for many similar particles/markers.
- Keep labels in HTML/CSS2D when text must stay sharp.
- Cap pixel ratio at 1.5 or 2.
- Avoid high-poly GLB for simple lab equipment.
- Texture sizes should match viewport use; do not ship 4K textures for small props.

## Asset Budgets

- Prefer procedural apparatus for curriculum labs. A beaker, lever, circuit, organ model, field, or particle system should not require a GLB unless shape fidelity teaches the lesson.
- Keep a single curriculum GLB at or below 3 MB. Treat 5 MB as a hard review point and require a visual reason plus compression plan.
- Keep total loaded texture assets at or below 4 MB for a lab page. Use 1024 px textures for normal props; 2048 px only for hero inspection assets.
- Keep repeated meshes instanced or pooled. If a scene needs more than 200 similar markers, use `InstancedMesh` before adding more individual meshes.
- Keep render triangles below 60k for dense lab pages unless benchmark evidence shows the scene still clears p95 frame and mobile panel budgets.
- Benchmark loaded local code/assets, largest model MB, texture MB, draw calls, triangles, and texture count before claiming a model-heavy lab is optimized.

## Visual Polish

- Add bevel illusion with bevelled geometry only where visible; otherwise use material/lighting.
- Use shadows as depth cues, not as a performance tax everywhere.
- Frame model with camera target and distance limits.
- Add subtle animation only when it explains state or draws attention to the active part.
- Use bloom, transparent glass, emissive accents, or particles only when they clarify energy, field, flow, heat, or motion.
- Avoid "primitive soup": repeated spheres/boxes need a lab apparatus, surface, scale cue, labels, and a measured readout.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall