text-to-cad README

The project's README from github.com/earthtojake/text-to-cad. As one markdown file: README.md.

Demo of the CAD skill generating and previewing CAD geometry
████████╗███████╗██╗  ██╗████████╗██████╗  ██████╗ █████╗ ██████╗ 
╚══██╔══╝██╔════╝╚██╗██╔╝╚══██╔══╝╚════██╗██╔════╝██╔══██╗██╔══██╗
   ██║   █████╗   ╚███╔╝    ██║    █████╔╝██║     ███████║██║  ██║
   ██║   ██╔══╝   ██╔██╗    ██║   ██╔═══╝ ██║     ██╔══██║██║  ██║
   ██║   ███████╗██╔╝ ██╗   ██║   ███████╗╚██████╗██║  ██║██████╔╝
   ╚═╝   ╚══════╝╚═╝  ╚═╝   ╚═╝   ╚══════╝ ╚═════╝╚═╝  ╚═╝╚═════╝ 

A library of agent skills for CAD, CAE and CAM

Docs

Tests Join Discord GitHub stars License: MIT Follow @earthtojake Python STEP STL 3MF URDF SDF SRDF

text-to-cad

text-to-cad is a library of agent skills for generating, inspecting, sourcing, slicing, and handing off CAD and robot-description artifacts from local project files.

CAD skill demo showing generated geometry in CAD Viewer CAD URDF skill demo showing robot description output in CAD Viewer URDF SRDF MoveIt2 skill demo showing inverse kinematics in CAD Viewer SRDF / MoveIt2

🧰 Skills

Install the library to give agents focused workflows for CAD, fabrication, robot description files, simulation, and local review.

Skill Summary Source
CAD Creates and edits CAD models from plain-language or image requests, with STEP as the main output along with options to export to STL, 3MF and GLB. skills/cad
CAD Viewer Shows local browser previews for CAD and robot files. skills/cad-viewer
step.parts Finds off-the-shelf STEP parts like screws, bearings, motors, and connectors. skills/step-parts
DXF Creates 2D DXF drawings like profiles, templates, gaskets, and cut layouts from Python sources or CAD geometry. skills/dxf
URDF Writes robot structure files with links, joints, limits, inertials, and meshes. skills/urdf
SRDF Adds MoveIt planning groups, end effectors, poses, and collision rules to a URDF. skills/srdf
SDF Creates simulator models and worlds with frames, physics, sensors, and lights. skills/sdf
SendCutSend Checks DXF and STEP files before upload to SendCutSend. skills/sendcutsend
DfAM Check Measures mesh printability per process: wall thickness, overhangs, support volume, and build orientation. skills/dfam-check
G-code Slices supported mesh files into validated, printer-profiled FDM .gcode with real slicer CLIs. skills/gcode
Bambu Labs Dry-runs, uploads, and cautiously starts local Bambu Lab print jobs from validated .gcode. skills/bambu-labs

💻 Installation

Install or clone from main: it is the source tree, and every skill's requirements.txt pins the cadgen release it was published with. (models/, the fixture corpus, arrives as small LFS pointers and is not needed to use the skills.)

Skills

Install text-to-cad with the Skills CLI:

npx skills add earthtojake/text-to-cad

This is the preferred installation path. It installs the individual skills directly for supported agents.

Use the same command to update. add re-fetches the package and overwrites what is already installed, so it both refreshes existing skills and installs any skill added in a newer release. npx skills update only refreshes skills already in your lockfile, so it silently misses new ones — which matters here, because releases do add skills.

Neither command removes a skill that was retired upstream; drop one with npx skills remove <skill> if you need to.

(npx skills install … still works — it is an undocumented alias for add.)

Plugins

Provider-native plugin installs are also available for Codex, Claude Code, and Grok Build:

# Codex (requires Codex 0.142.0 or newer)
codex plugin marketplace add earthtojake/text-to-cad
codex plugin add cad@text-to-cad

Codex resolves this repository-root plugin only from 0.142.0 onward. On older versions the plugin is skipped silently and never appears in codex plugin list; upgrade with 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 uses the existing .claude-plugin/marketplace.json; there is no separate Grok plugin manifest.

# Grok Build
grok plugin install earthtojake/text-to-cad --trust
grok plugin enable cad

Restart your agent if newly installed skills do not appear. For local development, branch from main, open PRs against main, and follow CONTRIBUTING.md.

🛠️ Contributing

Branch from main and open PRs against main. For local contribution workflow, skill linking, and validation guidance, see CONTRIBUTING.md.

text-to-cad (earthtojake/text-to-cad)

Searching Database…

Что это такое?text-to-cad — это библиотека навыков для агентов в области CAD, CAE и CAM: она даёт программным агентам готовые рабочие процессы, чтобы генерировать, проверять, подбирать, нарезать на слои и передавать дальше CAD-файлы и описания роботов прямо из файлов вашего локального проекта.
То есть это CAD-программа, которую я открываю, или то, чем пользуется мой агент для программирования?Это не приложение, которое вы открываете, — оно устанавливает набор навыков и встроенных плагинов в агентов для программирования, которыми вы уже пользуетесь, и дальше агент применяет эти рабочие процессы к вашим локальным файлам.
Как установить его в моего агента?Установите через Skills CLI (npx skills add) — это предпочтительный способ: он ставит отдельные навыки напрямую в поддерживаемые агенты, и той же командой их потом можно обновить.
С какими агентами для программирования он работает?Установка встроенных плагинов доступна для Codex, Claude Code и Grok Build, причём Grok Build использует манифест маркетплейса плагинов Claude. Codex должен быть версии 0.142.0 или новее — на старых версиях плагин молча пропускается.
Есть ли подводные камни при установке или обновлении?Устанавливайте и обновляйте через npx skills add — команда npx skills update обновляет только навыки из lockfile и молча пропускает недавно добавленные. Удалённые навыки не убираются автоматически (уберите их через npx skills remove), и перезапустите агента, если новые навыки не появились.
Что агент реально может с его помощью сделать?CAD-модели, которые создаются и редактируются по запросу обычным языком или по картинке: основной формат — STEP, плюс экспорт в STL, 3MF и GLB; 2D-чертежи DXF — профили, шаблоны, прокладки, карты раскроя; а также файлы для роботов — структура URDF со звеньями, суставами и ограничениями, группы планирования SRDF для MoveIt и модели и миры SDF для симулятора.
Можно довести деталь до 3D-печати?Да. step.parts находит готовые STEP-детали — винты, подшипники, моторы, разъёмы; DfAM Check оценивает пригодность полигональной модели к печати для каждого техпроцесса (толщина стенок, свесы, объём поддержек, ориентация на столе); навык G-code нарезает полигональные модели в проверенный FDM-файл .gcode под профиль конкретного принтера; навык Bambu Labs делает пробный прогон, загружает файл и осторожно запускает локальную печать; SendCutSend проверяет файлы DXF и STEP перед загрузкой.
Нужна ли большая загрузка или дополнительная настройка помимо самих навыков?Нет — каталог models/ (набор тестовых файлов) приходит в виде маленьких LFS-указателей и для работы навыков не нужен. Файл requirements.txt каждого навыка закрепляет ту версию cadgen, с которой навык был выпущен.
Можно посмотреть модели без настольной CAD-программы?Да — навык CAD Viewer показывает предпросмотр CAD-файлов и файлов роботов в браузере прямо с вашего компьютера.
Size
377.6 MB
Stars
21.3K
Age
5mo
Commits · 90 Days