LumosLab-Innovation/3D-lab-skills / plugins/threejs-lab/skills/threejs-model-creator
threejs-model-creator
VerifiedCreate, 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.0 KB |
| agents/openai.yaml | config | 207 B |
| references/model-standards.md | markdown | 3.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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |