npx --yes img2threejs@latest installRun it in a terminal, then start a new agent session so the skill loads. Read the repo's README and scripts before you install: skills run with your agent's permissions.
What it does
img2threejs is an Agent Skill that turns a single reference image into a procedural Three.js model written as TypeScript code. It is reconstruction-by-code: the agent builds the object from primitives, procedural shaders and generated geometry, then reviews rendered screenshots against the reference pass by pass. The result is a THREE.Group factory with pivots, sockets and colliders so the model is meant to animate, not a downloaded mesh pack.
As of 2026-11-06 the project is at skill version 2.0.1 under the Apache-2.0 license. Install links the skill into Hermes, Claude Code, Codex or OpenCode with one command. Optional plugins (separate installs) add character rigging, CS2 weapon-skin gates and other domain profiles. A live demo gallery at img2threejs.io shows browser-running reconstructions built entirely as code.
The workflow is resumable: forge scripts keep an evidence-backed checklist, and each stage (blockout through optimization) must pass geometric gates and an agent-vision comparison before the next unlocks. Character builds can bind a SkinnedMesh to a shared Skeleton after the component tree is approved. It needs Node.js 18+, Git and Python 3.10+, plus an agent that can read images or screenshots.
Features
- Reference image to procedural Three.js Group factory
- Pass-gated sculpt pipeline with vision review
- Animation-oriented hierarchy with pivots, sockets and colliders
- Optional domain plugins for characters and CS2 skins
- Live demo gallery of code-only reconstructions
- Works with Hermes, Claude Code, Codex and OpenCode
Limits
- Needs Node.js 18+, Git, Python 3.10+ and an agent with vision or screenshot tools
- Reconstruction-by-code, not photogrammetry or mesh download
- Windows install is limited; README targets macOS and Linux