img2threejs
An Agent Skill that rebuilds the object or character in a reference image as a code-only, animation-ready Three.js model, checked pass by pass.
- GitHub stars
- 18,610 (GitHub stars as of 2026-10-22)
- License
- Apache-2.0
- Last commit
- 2026/10/21
- By
- img2threejs
Listed from the author's README. GameSkill has not run this end to end yet. Agent support and install steps are as documented by the author.
Install
npx --yes img2threejs@latest install
npx --yes img2threejs@latest doctorinstall links the skill into every agent it finds; doctor prints "managed" for each agent it is installed in. docs/INSTALL.md covers manual installs and other agents such as Cursor.
npx --yes @img2threejs/img2@latest install --yesOnly needed for plugins such as character rigging (img2 add character --yes) or img2glb.
Commands are copied from the project's README. Check the repository before running anything on your machine.
What you get
- A staged pipeline: blockout → structural → form → material → surface → lighting → interaction → optimization
- A vision review after each pass and Python gates that block weak results
- Separate tracks for objects and characters
- Resumable state (forge/state.py and forge/next.py)
Good fit
- Game props, vehicles and stylized characters for Three.js games without mesh files
- Animation-ready models made from primitives and procedural shaders
Not for
- Photogrammetry or exact mesh extraction: it rebuilds the object in code
- Guaranteed likeness from one photo: the README reports per-region confidence and asks for more views
Overview
img2threejs is a single agent skill with a narrow job: take a reference image and rebuild the subject as a procedural Three.js model. It does not use photogrammetry or downloaded art packs. The live gallery at img2threejs.io shows every result running as generated code in the browser.
The skill first turns the image into a spec, then builds the model in eight passes. Deterministic Python scripts handle validation and gating, so model tokens go only to visual review and code. The authors describe this as token-efficient image-to-3D. Characters go through a separate anatomy-aware track, and plugins add rigging, CS2 weapon skins or GLB export.
It pairs well with Three.js Game Skills: one pack builds the game, the other builds its hero models.
Requirements
- Node.js 18+, Git and Python 3.10+
- Claude Code, Codex, OpenCode or Hermes
Topics
FAQ
Works well with
Skills the author points to as related or as the better fit for neighbouring tasks.
Similar skills
Godogen
Autonomous game development with Claude Code and Codex. Publishes a ready game repo for Godot, Bevy, Babylon.js or three.js.
3dviz Pro Max
Turn an idea into a Three.js or Blender scene: 223 recipes, 440 knowledge records and runnable studio examples.
Awesome Gamedev Agent Skills
74 portable SKILL.md skills for Godot, Unity, Unreal, Phaser, PixiJS, three.js, Bevy, pygame, LÖVE and Roblox, with a router.
Novel to Game
Agent skills for source-grounded adaptation of novels into games: cited design docs, target-runtime builds and evidence-based QA.