cad
Create, modify, inspect, and validate parametric CAD parts and assemblies authored as cadgen model scripts. Use for natural-language CAD spe
Open source Repository Open in the app JSON README (API)
About
Create, modify, inspect, and validate parametric CAD parts and assemblies authored as cadgen model scripts. Use for natural-language CAD specs, reference images, 2D technical drawings, STEP/STP generation or direct inspection, Python CAD source, source-level joints, selector references, geometry facts, measurements, mating deltas, snapshots, and STL/3MF/native GLB outputs from CAD geometry. Also covers project structure for multi-part CAD work - src/ for model scripts and shared code, format folders (STEP/, DXF/, STL/) for raw outputs, naming, and commit policy for projects with several @step/@dxf model scripts and imported source files; use it when starting a CAD project with more than a couple of models, when asked how to organize CAD code and artifacts, or when growing a flat folder of models into a project.
Details
- Kind
- Agent skills
- Topic
- Version control
- Publisher
- earthtojake
- Origin
- skillssh
- Category
- ferramentas
- Stars
- 15,476
- Forks
- 1,598
- Open pull requests
- 17
- Last push
- 2026-09-13T05:44:55Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-08-30 15:21:20
- Updated
- 2026-09-11 16:02:08
- Origin id
earthtojake/text-to-cad/cad
README
<div align="center">
<img src="assets/text-to-cad-demo.gif" alt="Demo of the CAD skill generating and previewing CAD geometry" width="100%">
<br>
<pre>
████████╗███████╗██╗ ██╗████████╗██████╗ ██████╗ █████╗ ██████╗
╚══██╔══╝██╔════╝╚██╗██╔╝╚══██╔══╝╚════██╗██╔════╝██╔══██╗██╔══██╗
██║ █████╗ ╚███╔╝ ██║ █████╔╝██║ ███████║██║ ██║
██║ ██╔══╝ ██╔██╗ ██║ ██╔═══╝ ██║ ██╔══██║██║ ██║
██║ ███████╗██╔╝ ██╗ ██║ ███████╗╚██████╗██║ ██║██████╔╝
╚═╝ ╚══════╝╚═╝ ╚═╝ ╚═╝ ╚══════╝ ╚═════╝╚═╝ ╚═╝╚═════╝
</pre>
A library of agent skills for CAD, CAE and CAM
[Docs](https://www.texttocad.dev)
[](https://github.com/earthtojake/text-to-cad/actions/workflows/test.yml?query=branch%3Amain)
[](https://discord.gg/5FGB9DwJYU)
[](https://github.com/earthtojake/text-to-cad/stargazers)
[](LICENSE)
[](https://x.com/earthtojake)
[](skills/cad/requirements.txt)
[](skills/cad/SKILL.md)
[](skills/cad/SKILL.md)
[](skills/cad/SKILL.md)
[](skills/urdf/SKILL.md)
[](skills/sdf/SKILL.md)
[](skills/srdf/SKILL.md)
</div>
# 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.
<table>
<tr>
<td width="33%">
<a href="./assets/text-to-cad-demo.gif">
<img src="./assets/text-to-cad-demo.gif" alt="CAD skill demo showing generated geometry in CAD Viewer" width="100%">
</a>
<a href="./skills/cad/SKILL.md"><strong>CAD</strong></a>
</td>
<td width="33%">
<a href="./assets/urdf-demo.gif">
<img src="./assets/urdf-demo.gif" alt="URDF skill demo showing robot description output in CAD Viewer" width="100%">
</a>
<a href="./skills/urdf/SKILL.md"><strong>URDF</strong></a>
</td>
<td width="33%">
<a href="./assets/srdf-moveit2-demo.gif">
<img src="./assets/srdf-moveit2-demo.gif" alt="SRDF MoveIt2 skill demo showing inverse kinematics in CAD Viewer" width="100%">
</a>
<a href="./skills/srdf/SKILL.md"><strong>SRDF / MoveIt2</strong></a>
</td>
</tr>
</table>
## 🧰 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](skills/cad/SKILL.md) |
| CAD Viewer | Shows local browser previews for CAD and robot files. | [skills/cad-viewer](skills/cad-viewer/SKILL.md) |
| step.parts | Finds off-the-shelf STEP parts like screws, bearings, motors, and connectors. | [skills/step-parts](skills/step-parts/SKILL.md) |
| DXF | Creates 2D DXF drawings like profiles, templates, gaskets, and cut layouts from Python sources or CAD geometry. | [skills/dxf](skills/dxf/SKILL.md) |
| URDF | Writes robot structure files with links, joints, limits, inertials, and meshes. | [skills/urdf](skills/urdf/SKILL.md) |
| SRDF | Adds MoveIt planning groups, end effectors, poses, and collision rules to a URDF. | [skills/srdf](skills/srdf/SKILL.md) |
| SDF | Creates simulator models and worlds with frames, physics, sensors, and lights. | [skills/sdf](skills/sdf/SKILL.md) |
| SendCutSend | Checks DXF and STEP files before upload to SendCutSend. | [skills/sendcutsend](skills/sendcutsend/SKILL.md) |
| DfAM Check | Measures mesh printability per process: wall thickness, overhangs, support volume, and build orientation. | [skills/dfam-check](skills/dfam-check/SKILL.md) |
| G-code | Slices supported mesh files into validated, printer-profiled FDM `.gcode` with real slicer CLIs. | [skills/gcode](skills/gcode/SKILL.md) |
| Bambu Labs | Dry-runs, uploads, and cautiously starts local Bambu Lab print jobs from validated `.gcode`. | [skills/bambu-labs](skills/bambu-labs/SKILL.md) |
## 💻 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:
```bash
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:
```bash
# 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`.
```bash
# 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.
```bash
# 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.md).
## 🛠️ Contributing
Branch from `main` and open PRs against `main`.
For local contribution workflow, skill linking, and validation guidance, see
[CONTRIBUTING.md](CONTRIBUTING.md).