img2threejs — скилл
Скилл пересобирает объект с референсного изображения в процедурную 3D-модель Three.js, написанную кодом, а не скачанную
- 21 299 ★ репозитория
- Последний коммит
- Apache-2.0
Минимальный доступ
Почему такой уровень
- Запускает локальные Python-скрипты для проверки геометрии, но не выходит в сеть и не пишет за пределы проекта
Установка
- Работает в
Ручная установка
img2 add img2threejs/plugin-<id> --ref <tag>Ставит доменный плагин, например для персонажей, через отдельный CLI img2. Требует его установки.
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Запускает локальные Python-скрипты для проверки геометрии, но не выходит в сеть и не пишет за пределы проекта
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл ведет агента по многоэтапному пайплайну реконструкции объекта или персонажа с фотографии в процедурную модель Three.js на TypeScript. Сначала анализ изображения и оценка сложности, затем письменная спецификация с иерархией деталей, материалами и точками анимации, потом сборка проходами от общей формы до финальной детализации и освещения. После каждого прохода скилл снимает скриншот и сверяет его с референсом через отдельные проверки: силуэт, зеркальность левой и правой стороны, самопересечения, покрытие деталями. На выходе получается код, который можно анимировать и разбирать на части, вместо одноразовой генерации мешей.
Для кого. Для разработчиков, которые делают 3D-сцены на Three.js и хотят получить по фотографии читаемый код объекта вместо скачанной модели.
Подходит, если
- Нужна процедурная 3D-модель предмета или персонажа по референсному изображению
- Нужен объект, который можно анимировать или разобрать на части в игре или сцене
- Нужна детальная реконструкция материала и формы, а не грубое приближение
Не подходит, если
- Достаточно готового меша из фотограмметрии или купленного ассета
- Нужна точная геометрия со всех сторон, а есть только один ракурс изображения
Пример запроса к агенту
По этому фото рюкзака собери процедурную 3D-модель для Three.js с расстегивающимися молниямиОграничения
Пайплайн многоэтапный и рассчитан на серьезную работу агента с десятками скриптов на Python 3.10 без внешних зависимостей, это не быстрая генерация в один шаг. Одно изображение не может показать скрытые стороны объекта, скилл честно сообщает об этом вместо того, чтобы додумывать геометрию. Часть доменных плагинов для отдельных типов объектов устанавливается отдельно через собственный CLI img2.
Как отключить. Удалите папку или символьную ссылку img2threejs из ~/.claude/skills, ~/.codex/skills или другой папки скиллов вашего агента.
Частые вопросы
Это фотограмметрия или извлечение меша?
Нет, скилл прямо заявляет обратное: модель собирается кодом с нуля, а не извлекается из скана или скачанного пакета.
С какими агентами скилл работает?
Автор описывает его как агент-агностичный: подтверждена работа с Claude Code, Codex и OpenCode, для зрения и браузера используется то, что предоставляет хост-агент.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл рисует интерактивные изометрические иллюстрации в SVG: шейдеры WebGL, страница HTML или компонент React, идея объясняется работающим устройством
Скилл scan-to-threejs превращает запись с телефона в код сцены, уточняя модель за несколько проверочных кругов.
Скилл ведет Live2D-проект от слоев и привязки в Cubism до проверки в браузере и отката, а рядом лежат код и модель-образец.
Одна строка с названием машины, и Claude Code собирает интерактивную 3D-модель с физикой в одном HTML-файле
Скилл делает по фото и источникам офлайн-страницу с 3D-чертежом памятника в синем стиле или сводит несколько моделей в одну
Скилл-цикл: агент генерирует эталонный скриншот, строит под него сцену и через субагента-критика доводит результат до совпадения
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| img2threejs (эта карточка) | нет | 21 299 | ||
| Machine Skill | нет | 650 | одна строка с названием машины | |
| Kiln | нет | не нужна | 327 | локальный MCP-сервер и CLI |
Коротко о README
README описывает скилл как сборку объекта по фотографии кодом, с упором на управляемое качество и готовность к анимации, а не на скорость. Подчеркивается разница между построением модели и последующим экспортом в другие форматы: обещание про код держится только на этапе сборки. Отдельно описан харнесс img2 для установки доменных плагинов под конкретные категории объектов, например персонажей или технику. Лицензия Apache-2.0.
Бейдж для README
Исходный 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.