img2threejs

Установка

npx skillfoxx add skills/img2threejs

npx skills add img2threejs/img2threejs --skill img2threejs -a claude-code -y

npx skills add img2threejs/img2threejs --skill img2threejs -a cursor -y

npx skills add img2threejs/img2threejs --skill img2threejs -a github-copilot -y

npx skills add img2threejs/img2threejs --skill img2threejs -a codex -y

npx skills add img2threejs/img2threejs --skill img2threejs -a gemini-cli -y

npx skills add img2threejs/img2threejs --skill img2threejs -a cline -y

npx skills add img2threejs/img2threejs --skill img2threejs -a roo -y

npx skills add img2threejs/img2threejs --skill img2threejs -a opencode -y

img2 add img2threejs/plugin-<id> --ref <tag>

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Скилл ведет агента по многоэтапному пайплайну реконструкции объекта или персонажа с фотографии в процедурную модель Three.js на TypeScript. Сначала анализ изображения и оценка сложности, затем письменная спецификация с иерархией деталей, материалами и точками анимации, потом сборка проходами от общей формы до финальной детализации и освещения. После каждого прохода скилл снимает скриншот и сверяет его с референсом через отдельные проверки: силуэт, зеркальность левой и правой стороны, самопересечения, покрытие деталями. На выходе получается код, который можно анимировать и разбирать на части, вместо одноразовой генерации мешей.

Для кого. Для разработчиков, которые делают 3D-сцены на Three.js и хотят получить по фотографии читаемый код объекта вместо скачанной модели.

Пример запроса к агенту

По этому фото рюкзака собери процедурную 3D-модель для Three.js с расстегивающимися молниями

Ограничения

Пайплайн многоэтапный и рассчитан на серьезную работу агента с десятками скриптов на Python 3.10 без внешних зависимостей, это не быстрая генерация в один шаг. Одно изображение не может показать скрытые стороны объекта, скилл честно сообщает об этом вместо того, чтобы додумывать геометрию. Часть доменных плагинов для отдельных типов объектов устанавливается отдельно через собственный CLI img2.

Как отключить. Удалите папку или символьную ссылку img2threejs из ~/.claude/skills, ~/.codex/skills или другой папки скиллов вашего агента.

Проверка безопасности

• Запускает локальные Python-скрипты для проверки геометрии, но не выходит в сеть и не пишет за пределы проекта

Коротко о README

README описывает скилл как сборку объекта по фотографии кодом, с упором на управляемое качество и готовность к анимации, а не на скорость. Подчеркивается разница между построением модели и последующим экспортом в другие форматы: обещание про код держится только на этапе сборки. Отдельно описан харнесс img2 для установки доменных плагинов под конкретные категории объектов, например персонажей или технику. Лицензия Apache-2.0.

SKILL.md

---
name: img2threejs
description: Turn an object or character reference image into a quality-gated, animation-ready procedural Three.js model built in code. Use for image-to-3D reconstruction, detail-accurate object rebuilds, stylized/likeness-maximized human characters, sculpt specs, and staged code generation.
license: Apache-2.0
version: 2.0.0
---

# img2threejs — Image to procedural Three.js

Rebuild the object visible in a reference image as a **code-only** procedural Three.js model,
gated by a staged sculpting pipeline and an AI-vision self-correction loop. This is
reconstruction-by-code, **not** photogrammetry, mesh extraction, or downloaded art packs.

Agent-agnostic: works under Claude Code, Codex, or OpenCode.

## Core Promise

Sculpt from a photo, in order, never one-shot a mesh:
1. Run forge/next.py at every start, resume, and before every correction iteration.
2. Validate the image is a suitable 3D target.
3. Assess object class and complexity, then write a qualityContract before any code.
4. Spec it: component hierarchy, materials, lighting, pivots, sockets, action anchors.
5. Build pass-by-pass from blockout to structure, form, material, lighting, interaction, optimization.
6. Verify each pass with a screenshot compared against the reference.

Похожие