img2threejs

Agent skill by img2threejs · for Claude Code, Codex, OpenCode and Hermes

An agent skill that rebuilds an object or character from one reference image as a code-only, procedural, animation-ready Three.js model, with pass-gated vision review instead of mesh downloads.

  • Engine: three.js
  • 4 agents
  • License: Apache-2.0
  • Free
  • 21.7k stars

Install

npx --yes img2threejs@latest install

Run 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

Guides that cover img2threejs

Browse all 84 agent skills