Yi3D skill
The YI3D skill turns a part description into a Python script for the Yi3D CAD app, runs it and fixes errors over up to 10 retries.
- 148 ★ on the repository
- Last commit
- Apache-2.0
Extended access
Why this level
- The skill runs agent-written Python scripts inside the app and the `YI3D` executable from the working directory.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/yi3dDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The skill runs agent-written Python scripts inside the app and the `YI3D` executable from the working directory.
This is third-party code. Review the repository files before installing.
What it does
Yi3D is an open-source parametric 3D modelling app built on OpenCASCADE, Qt and OpenSceneGraph with a Python API. The `skills/YI3D` folder holds a Claude Code skill. The agent checks the connection with `ping`, starts `YI3D` if needed and creates a document with `NewFile`. From a model description the agent studies the examples in `scripts/samples/`, writes a script and sends it through `IpcClient.py` over TCP. It reads the result from the reply: on error the script is fixed, up to 10 iterations; on success the isometric view and `FitView` are applied. If the model is unsatisfying, `Undo` rolls the step back.
Who it is for. Engineers, designers and makers who describe a part in words and want to see a parametric model in CAD without drawing it by hand.
Good fit when
- A part with holes, chamfers and a pattern of features is described in text.
- A model must be rebuilt quickly with other dimensions: parameters sit at the top of the script.
- Modelling scripts are written for Yi3D in Python, but the API is unfamiliar.
- A sketch is turned into an extrusion, revolution or loft and the result should be visible at once.
- The agent checks geometry and rolls back a failed step with `Undo`.
Not a fit when
- The task lies outside Yi3D: the skill works only with this app.
- You need a build for macOS: the app ships for Windows and Linux only.
- The part needs strict engineering strength verification: the skill creates geometry, not calculations.
Example request
Create a flange with four bolt holes in Yi3D, put the dimensions in parameters and show the model in isometric view.Limitations
The skill does not work without a running Yi3D: build the app from source (Visual Studio on Windows, CMake on Linux) or get a prebuilt version from the author. Linux also needs the WYAF framework, free for non-commercial use only. The skill forbids taking examples from `scripts/agent/` or any `__pycache__` files. The Yi3D API has limits: `SketchArc` builds counterclockwise arcs only. The skill creates geometry but does not calculate strength or check tolerances.
How to disable. Remove the `skills/YI3D` folder from the agent's skills directory. Close the Yi3D app and its IPC port separately if you started them for the skill.
FAQ
What does the YI3D skill need?
A running Yi3D app and Python for `IpcClient.py`. The skill first tests the connection with `ping`, starts `YI3D` on failure and retries up to three times.
How many fix attempts are allowed?
Up to 10 iterations. Each pass changes one main problem so the cause of a failure stays clear.
How do I roll back a bad model?
With `Undo` through `IpcClient.py`. The skill does it when the user asks to recreate the model or apply changes.
Can I skip the agent and write scripts by hand?
Yes. Yi3D has a full Python API: the `wy3d` module and examples in `scripts/`. The skill only automates the write, run and fix loop.
Which file formats does Yi3D use?
Binary `.wy3db` and text `.wy3dt`. DXF import and export are available for sketches.
Discussion
No questions or reviews yet.
Related
SkillsPython SDK for parametric CAD with an agent skill: code-built models, STEP, STL and MJCF export, edits rerun only dependent cells.
CAD Skill
cad-skill
A parametric 3D model skill for printing on CadQuery. PolyForm Noncommercial 1.0.0 license: non-commercial use only
A library of agent skills for CAD, CAE and CAM: generate and edit models, export STEP, STL, 3MF, robot description files and mesh slicing to g-code
The create-cad-files skill builds a dimensioned part from a plain description and returns validated STEP and STL files.
A skill that creates and reviews other skills, weighing usefulness, trigger boundaries, setup and stability before release.
agentcad gives an AI agent 3D design: build123d scripts, STEP export, renders, geometry checks and a live browser preview
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Yi3D (this card) | no | 148 | ||
| CAD Skill | no | 720 | cad-skill describes a general CAD approach; YI3D drives one specific open-source app through its IPC and Python API | |
| FreeCAD MCP | no | not required | 3,310 | FreeCAD MCP exposes a different CAD tool as an MCP server; YI3D works as a skill with the Yi3D app |
README in short
The README covers the app, its modules and Python scripting, while the skill lives in `skills/YI3D/SKILL.md` with an IPC guide and right-handed coordinate rules for sketch planes.
README badge
Original SKILL.md
--- name: YI3D description: Generates YI3D Python modeling scripts, runs them through IpcClient.py and iterates on results until success or the stop condition. ---