text-to-cad — библиотека скиллов для AI-агентов: CAD, робототехника и 3D-печать

· 2 мин чтения
ai-agents skills cad robotics 3d-printing
📂 Исходный код на GitHub

Библиотека агентских скиллов для CAD, CAE и CAM: генерация и правка CAD-моделей по тексту или картинке, экспорт в STEP/STL/3MF/GLB, файлы описания роботов (URDF, SRDF, SDF), поиск готовых деталей, проверка печатаемости, нарезка G-code и управление 3D-печатью.

text-to-cad — библиотека скиллов для AI-агентов: CAD, робототехника и 3D-печать

Обычно про AI-агентов говорят в контексте кода и текста. Проект text-to-cad идёт другим путём: он учит агентов работать с инженерной геометрией — создавать CAD-модели, готовить файлы описания роботов, проверять детали на печатаемость и даже запускать 3D-печать. Это библиотека из 11 агентских скиллов для CAD, CAE и CAM от разработчика @earthtojake, у проекта уже около 15 000 звёзд на GitHub, лицензия MIT, исходники открыты в репозитории earthtojake/text-to-cad.

Что это такое

text-to-cad — это набор скиллов (skills) для AI-агентов: генерация, инспекция, подбор, нарезка и передача дальше CAD-артефактов и файлов описания роботов на основе локальных файлов проекта. По сути, вы ставите скиллы в своего агента — Claude Code, Codex или другого поддерживаемого — и получаете workflow для инженерных задач: от «сделай мне корпус с отверстиями под крепёж» до «проверь эту модель на печатаемость и отправь на принтер».

Основной формат вывода — STEP, промышленный стандарт обмена CAD-геометрией. Дополнительно скилл CAD умеет экспортировать в STL, 3MF и GLB. Требуется Python 3.11+, а каждый скилл в своих requirements.txt пиннит конкретный релиз внутренней библиотеки cadgen, с которой он был опубликован — так агенты не ломаются от несовместимых обновлений.

Одиннадцать скиллов

Библиотека покрывает весь цикл: проектирование → ревью → производство.

Скилл Что делает
CAD Создаёт и правит CAD-модели по текстовому описанию или картинке; основной вывод — STEP, опционально STL, 3MF и GLB
CAD Viewer Показывает локальные превью CAD- и робо-файлов в браузере
step.parts Находит готовые STEP-детали: винты, подшипники, моторы, коннекторы
DXF Делает 2D-чертежи DXF — профили, шаблоны, прокладки, карты раскроя — из Python-кода или CAD-геометрии
URDF Пишет файлы структуры робота: links, joints, лимиты, инерции, меши
SRDF Добавляет к URDF planning-группы MoveIt, энд-эффекторы, позы и правила коллизий
SDF Создаёт модели и миры для симуляторов: фреймы, физика, сенсоры, источники света
SendCutSend Проверяет DXF и STEP перед загрузкой в сервис лазерной резки SendCutSend
DfAM Check Оценивает печатаемость меша по процессу: толщина стенок, свесы, объём поддержек, ориентация на столе
G-code Нарезает меши в валидированный FDM .gcode под профиль конкретного принтера через настоящие slicer CLI
Bambu Lab Делает dry-run, загружает и осторожно запускает печать на локальных принтерах Bambu Lab из проверенного .gcode

Несколько скиллов в этой связке особенно показательны. step.parts решает вечную проблему «не изобретать велосипед»: вместо моделирования стандартного винта агент находит готовую деталь. DfAM Check — это автоматизированный design for additive manufacturing: не «напечатается ли оно вообще», а измеримые метрики под конкретный процесс печати. А связка G-code + Bambu Lab доводит цепочку до физического мира: агент сам нарезает модель, прогоняет dry-run и только потом стартует задание на принтере.

Для робототехники есть свой мини-стек: URDF описывает геометрию и кинематику, SRDF добавляет планирование движения через MoveIt, SDF готовит модели для симуляции. Все три скилла имеют демо с просмотром результата в CAD Viewer — включая показ inverse kinematics для SRDF/MoveIt2.

Установка

Предпочитаемый способ — Skills CLI:

npx skills add earthtojake/text-to-cad

Команда ставит отдельные скиллы напрямую в поддерживаемых агентов. Обновление — той же командой add: она заново тянет пакет и перезаписывает установленное, попутно добавляя новые скиллы. Авторы специально предупреждают: npx skills update обновляет только то, что уже есть в lockfile, и молча пропустит новые скиллы — а релизы их действительно добавляют. Удалённые из апстрима скиллы сами не исчезнут; убирать их нужно вручную через npx skills remove <skill>.

Для агентов с нативной системой плагинов есть отдельные пути установки:

# Codex (требуется версия 0.142.0 или новее)
codex plugin marketplace add earthtojake/text-to-cad
codex plugin add cad@text-to-cad

Нюанс: Codex резолвит плагин из корня репозитория только начиная с 0.142.0. На более старых версиях он молча пропускается и даже не появляется в codex plugin list — если скиллы «не ставятся», обновите Codex через npm install -g @openai/codex@latest.

# Claude Code
claude plugin marketplace add earthtojake/text-to-cad
claude plugin install cad@text-to-cad
# Grok Build
grok plugin install earthtojake/text-to-cad --trust
grok plugin enable cad

Grok Build использует тот же манифест .claude-plugin/marketplace.json, что и Claude Code, — отдельного плагин-манифеста у него нет. Если после установки новые скиллы не появились, агента нужно перезапустить.

Репозиторий содержит каталог models/ с фикстурами, но он идёт как небольшие LFS-указатели и для использования скиллов не нужен — достаточно самого кода скиллов из ветки main.

Как это выглядит на практике

Типичный сценарий работы: вы просите агента «смоделируй кронштейн под серво с креплением на M3». Скилл CAD генерирует параметрическую геометрию и сохраняет STEP. CAD Viewer поднимает локальное превью в браузере, чтобы вы глазами оценили результат. Дальше по желанию: DfAM Check проверяет толщину стенок и свесы, G-code нарезает модель под ваш принтер, Bambu Lab запускает печать. Если деталь гибридная — печатаемая часть плюс стандартный крепёж — step.parts подберёт винты и подшипники в STEP-формате для сборочной модели.

Для 2D-производства скилл DXF делает чертежи для лазерной резки, а SendCutSend валидирует файлы под требования конкретного сервиса — с учётом его ограничений на материалы и геометрию.

Кому это полезно

  • Механикам-инженерам и мейкерам — быстрые итерации на эскизном этапе без ручного моделирования каждого варианта.
  • Робототехникам — генерация и правка URDF/SRDF/SDF с проверкой результата в превью и симуляции.
  • Владельцам 3D-принтеров — автоматическая нарезка, проверка печатаемости и запуск печати голосом... точнее, одним сообщением агенту.
  • Разработчикам агентских пайплайнов — как пример хорошо структурированной библиотеки скиллов: пиннинг зависимостей, отдельные SKILL.md на каждый workflow, поддержка нескольких агентов через плагины.

Ссылки

Источник: https://github.com/earthtojake/text-to-cad

Похожие материалы