earthtojake / text-to-cad
earthtojake / text-to-cad
A skills library for CAD, robotics, and hardware design agents. 这是一个用于 CAD、机器人技术和硬件设计智能体的技能库。
Docs | Demo
文档 | 演示
CAD Skills
CAD Skills is a library of agent skills for generating, inspecting, sourcing, slicing, and handing off CAD and robot-description artifacts from local project files. CAD Skills 是一个智能体技能库，用于从本地项目文件中生成、检查、采购、切片以及交付 CAD 和机器人描述制品。
🧰 Skills
🧰 技能
Install the library to give agents focused workflows for CAD, fabrication, robot description files, simulation, and local review. 安装此库可为智能体提供针对 CAD、制造、机器人描述文件、仿真和本地审查的专注工作流。
| 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) |
| Source CAD | 根据自然语言或图像请求创建和编辑 CAD 模型，以 STEP 为主要输出格式，并支持导出为 STL、3MF 和 GLB。(skills/cad) |
| CAD Viewer | Shows local browser previews for CAD, G-code, and robot files. (skills/cad-viewer) |
| CAD Viewer | 提供 CAD、G-code 和机器人文件的本地浏览器预览。(skills/cad-viewer) |
| step.parts | Finds off-the-shelf STEP parts like screws, bearings, motors, and connectors. (skills/step-parts) |
| step.parts | 查找现成的 STEP 标准件，如螺丝、轴承、电机和连接器。(skills/step-parts) |
| DXF | Creates 2D DXF drawings like profiles, templates, gaskets, and cut layouts from Python sources or CAD geometry. (skills/dxf) |
| DXF | 从 Python 源码或 CAD 几何图形创建 2D DXF 图纸，如轮廓、模板、垫片和切割布局。(skills/dxf) |
| URDF | Writes robot structure files with links, joints, limits, inertials, and meshes. (skills/urdf) |
| URDF | 编写包含连杆、关节、限制、惯性参数和网格的机器人结构文件。(skills/urdf) |
| SRDF | Adds MoveIt planning groups, end effectors, poses, and collision rules to a URDF. (skills/srdf) |
| SRDF | 为 URDF 添加 MoveIt 规划组、末端执行器、姿态和碰撞规则。(skills/srdf) |
| SDF | Creates simulator models and worlds with frames, physics, sensors, and lights. (skills/sdf) |
| SDF | 创建包含坐标系、物理属性、传感器和灯光的仿真模型与世界。(skills/sdf) |
| SendCutSend | Checks DXF and STEP files before upload to SendCutSend. (skills/sendcutsend) |
| SendCutSend | 在上传至 SendCutSend 之前检查 DXF 和 STEP 文件。(skills/sendcutsend) |
| G-code | Slices supported mesh files into validated, printer-profiled FDM .gcode with real slicer CLIs. (skills/gcode) |
| G-code | 使用真实切片器 CLI 将支持的网格文件切片为经过验证的、适配打印机配置文件的 FDM .gcode 文件。(skills/gcode) |
| Bambu Labs | Dry-runs, uploads, and cautiously starts local Bambu Lab print jobs from validated .gcode. (skills/bambu-labs) |
| Bambu Labs | 从经过验证的 .gcode 文件进行空运行、上传并谨慎启动本地 Bambu Lab 打印任务。(skills/bambu-labs) |
| Implicit CAD | Creates browser-native implicit CAD models using GLSL signed-distance fields and CAD Viewer raymarch rendering. Experimental. (skills/implicit-cad) |
| Implicit CAD | 使用 GLSL 符号距离场 (SDF) 和 CAD Viewer 光线步进渲染创建浏览器原生的隐式 CAD 模型。实验性功能。(skills/implicit-cad) |
💻 Installation
💻 安装
For production use, install or clone from main; that branch contains the generated skill/plugin outputs needed by provider installers. 对于生产环境，请从 main 分支安装或克隆；该分支包含提供商安装程序所需的已生成技能/插件输出。
Skills
Install CAD Skills with the Skills CLI:
使用 Skills CLI 安装 CAD Skills：
npx skills install earthtojake/text-to-cad
This is the preferred installation path. It installs the individual skills directly for supported agents.
这是推荐的安装路径。它会直接为受支持的智能体安装各个技能。
Plugins Provider-native plugin installs are also available for Codex and Claude Code: Codex 和 Claude Code 也提供原生插件安装方式：
# Codex
codex plugin marketplace add earthtojake/text-to-cad
codex plugin add cad@text-to-cad
# Claude Code
claude plugin marketplace add earthtojake/text-to-cad
claude plugin install cad@text-to-cadRestart your agent if newly installed skills do not appear. For local development, branch from develop, open PRs against develop, and use the symlink workflow in CONTRIBUTING.md. 如果新安装的技能未显示，请重启智能体。对于本地开发，请基于 develop 分支创建分支，向 develop 分支提交 PR，并使用 CONTRIBUTING.md 中的符号链接工作流。
📸 Screenshots
📸 截图
- CAD
- URDF
- SRDF / MoveIt2
🧪 Benchmarks
🧪 基准测试
The repo stores heavyweight assets in assets/** and benchmarks/** through Git LFS and excludes those trees from default LFS pulls so lightweight clones do not fetch GIF assets. Benchmark markdown remains normal Git for readable diffs. To hydrate only the benchmark assets locally, run:
本仓库通过 Git LFS 将重量级资源存储在 assets/** 和 benchmarks/** 中，并从默认的 LFS 拉取中排除这些目录，以确保轻量级克隆不会下载 GIF 资源。基准测试的 Markdown 文件保留在普通 Git 中以便于阅读差异。若要在本地仅填充基准测试资源，请运行：
git lfs pull --include="benchmarks/**"
# Target Prompt Output
# 目标提示词输出
(List of 10 CAD generation tasks including blocks, flanges, brackets, shafts, enclosures, clevises, cylinders, impellers, staircases, and gears.) (包含 10 项 CAD 生成任务的列表，涵盖块、法兰、支架、轴、外壳、U型夹、气缸、叶轮、楼梯和齿轮等。)
🛠️ Contributing
🛠️ 贡献
Development happens from the develop branch; open PRs against develop, not main. For local contribution workflow, skill linking, and validation guidance, see CONTRIBUTING.md. 开发工作在 develop 分支进行；请向 develop 分支提交 PR，而非 main 分支。有关本地贡献工作流、技能链接和验证指南，请参阅 CONTRIBUTING.md。