earthtojake/text-to-cad

<div align="center">

<img src="assets/text-to-cad-demo.gif" alt="CAD 스킬이 CAD 형상을 생성하고 미리보는 데모" width="100%">

<br>

<pre> ██████╗ █████╗ ██████╗ ███████╗██╗ ██╗██╗██╗ ██╗ ███████╗ ██╔════╝██╔══██╗██╔══██╗ ██╔════╝██║ ██╔╝██║██║ ██║ ██╔════╝ ██║ ███████║██║ ██║ ███████╗█████╔╝ ██║██║ ██║ ███████╗ ██║ ██╔══██║██║ ██║ ╚════██║██╔═██╗ ██║██║ ██║ ╚════██║ ╚██████╗██║ ██║██████╔╝ ███████║██║ ██╗██║███████╗███████╗███████║ ╚═════╝╚═╝ ╚═╝╚═════╝ ╚══════╝╚═╝ ╚═╝╚═╝╚══════╝╚══════╝╚══════╝ </pre>

CAD, 로봇공학 및 하드웨어 설계 에이전트를 위한 스킬 라이브러리

Docs | Demo

</div>

CAD Skills

CAD Skills는 로컬 프로젝트 파일에서 CAD 및 로봇 설명 아티팩트를 생성, 검사, 조달, 슬라이싱 및 전달하기 위한 에이전트 스킬 라이브러리입니다.

🧰 스킬

라이브러리를 설치하면 에이전트가 CAD, 제작, 로봇 설명 파일, 시뮬레이션 및 로컬 검토를 위한 집중된 워크플로우를 사용할 수 있습니다.

💻 설치

프로덕션 사용을 위해 main 브랜치에서 설치하거나 클론하세요. 해당 브랜치에는 제공자 설치 프로그램에 필요한 생성된 스킬/플러그인 출력이 포함되어 있습니다.

스킬

Skills CLI로 CAD Skills를 설치하세요:

npx skills install earthtojake/text-to-cad

이것이 권장되는 설치 경로입니다. 지원되는 에이전트에 대해 개별 스킬을 직접 설치합니다.

플러그인

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-cad

새로 설치된 스킬이 나타나지 않으면 에이전트를 다시 시작하세요. 로컬 개발의 경우 develop에서 브랜치를 생성하고, develop에 PR을 열며, CONTRIBUTING.md의 심볼릭 링크 워크플로우를 사용하세요.

📸 스크린샷

<table> <tr> <td width="33%"> <a href="./assets/text-to-cad-demo.gif"> <img src="./assets/text-to-cad-demo.gif" alt="CAD Viewer에서 생성된 형상을 보여주는 CAD 스킬 데모" 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="CAD Viewer에서 로봇 설명 출력을 보여주는 URDF 스킬 데모" 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="CAD Viewer에서 역기구학을 보여주는 SRDF MoveIt2 스킬 데모" width="100%"> </a> <a href="./skills/srdf/SKILL.md"><strong>SRDF / MoveIt2</strong></a> </td> </tr> </table>

🧪 벤치마크

이 저장소는 Git LFS를 통해 assets/ 및 benchmarks/에 대용량 자산을 저장하며, 기본 LFS 풀에서 해당 트리를 제외하여 가벼운 클론이 GIF 자산을 가져오지 않도록 합니다. 벤치마크 마크다운은 읽기 쉬운 diff를 위해 일반 Git으로 유지됩니다. 로컬에서 벤치마크 자산만 가져오려면 다음을 실행하세요:

git lfs pull --include="benchmarks/**"

<table> <thead> <tr> <th>#</th> <th>대상</th> <th>프롬프트</th> <th>출력</th> </tr> </thead> <tbody> <tr> <td>1</td> <td><a href="benchmarks/01-rectangular-calibration-block.md">4개의 구멍이 있는 직사각형 교정 블록</a></td> <td>중앙에 100 x 60 x 20 mm 블록을 만들고 4개의 8 mm 수직 관통 구멍을 추가하세요. 상단 외부 둘레에만 2 mm 모따기를 추가하세요.</td> <td><img src="benchmarks/benchmark01rectangularcalibrationblock.gif" alt="직사각형 교정 블록 회전 gif" width="220"></td> </tr> <tr> <td>2</td> <td><a href="benchmarks/02-circular-flange.md">볼트 구멍 패턴이 있는 원형 플랜지</a></td> <td>직경 80 mm, 두께 10 mm의 원형 플랜지를 만들고 중앙에 30 mm 관통 보어를 추가하세요. 60 mm 볼트 원 위에 6개의 6 mm 관통 구멍을 추가하고 외부 원형 모서리를 필렛 처리하세요.</td> <td><img src="benchmarks/benchmark02circularflange.gif" alt="원형 플랜지 회전 gif" width="220"></td> </tr> <tr> <td>3</td> <td><a href="benchmarks/03-l-bracket.md">거셋과 두 방향 구멍이 있는 L브래킷</a></td> <td>베이스 플레이트와 후면 수직 플레이트로 L브래킷을 만드세요. 수직 베이스 구멍, 수평 백플레이트 구멍, 두 개의 삼각형 거셋, 필렛 처리된 베이스/백 전환부를 추가하세요.</td> <td><img src="benchmarks/benchmark03lbracket.gif" alt="L브래킷 회전 gif" width="220"></td> </tr> <tr> <td>4</td> <td><a href="benchmarks/04-stepped-shaft-keyway.md">키홈이 있는 단차 샤프트</a></td> <td>X축을 따라 120 mm 샤프트를 만들고 20/30/20 mm 직경의 단차 섹션을 추가하세요. 끝단 모따기와 중간 섹션 상단에 얕은 직사각형 키홈을 추가하세요.</td> <td><img src="benchmarks/benchmark04steppedshaftkeyway.gif" alt="단차 샤프트 회전 gif" width="220"></td> </tr> <tr> <td>5</td> <td><a href="benchmarks/05-open-top-electronics-enclosure.md">보스가 있는 상단 개방형 전자기기 인클로저</a></td> <td>3 mm 벽과 바닥이 있는 중공 상단 개방형 인클로저를 만드세요. 중앙에 막힌 구멍이 있는 4개의 내부 스탠드오프와 2 mm 외부 수직 모서리 필렛을 추가하세요.</td> <td><img src="benchmarks/benchmark05opentopelectronicsenclosure.gif" alt="상단 개방형 전자기기 인클로저 회전 gif" width="220"></td> </tr> <tr> <td>6</td> <td><a href="benchmarks/06-clevis-bracket-lightening-cutouts.md">경량화 컷아웃이 있는 항공우주 스타일 클레비스 브래킷</a></td> <td>베이스 플레이트, 두 개의 둥근 러그, 베이스 장착 구멍, 수평 러그 보어가 있는 대칭 클레비스 브래킷을 만드세요. 삼각형 경량화 컷아웃, 보강 리브, 둥근 전환부를 추가하세요.</td> <td><img src="benchmarks/benchmark06clevisbracketlighteningcutouts.gif" alt="클레비스 브래킷 회전 gif" width="220"></td> </tr> <tr> <td>7</td> <td><a href="benchmarks/07-radial-engine-cylinder.md">냉각 핀이 있는 방사형 엔진 스타일 실린더</a></td> <td>중앙 배럴, 12개의 냉각 핀, 베이스 플랜지, 상단 캡이 있는 수직 엔진 실린더 형태를 만드세요. 35도 각도의 점화 플러그 보스와 동축 관통 구멍을 추가하세요.</td> <td><img src="benchmarks/benchmark07radialenginecylinder.gif" alt="방사형 엔진 스타일 실린더 회전 gif" width="220"></td> </tr> <tr> <td>8</td> <td><a href="benchmarks/08-centrifugal-impeller.md">후방 곡선 블레이드가 있는 원심 임펠러</a></td> <td>백플레이트, 허브, 관통 보어가 있는 원심 임펠러를 만드세요. 루트에서 팁까지 약 45도 휘어지는 12개의 융합된 후방 곡선 블레이드를 추가하세요.</td> <td><img src="benchmarks/benchmark08centrifugalimpeller.gif" alt="원심 임펠러 회전 gif" width="220"></td> </tr> <tr> <td>9</td> <td><a href="benchmarks/09-spiral-staircase.md">나선형 난간이 있는 나선형 계단</a></td> <td>중앙 기둥, 베이스 디스크, 20개의 상승 쐐기형 디딤판이 있는 소형 나선형 계단을 만드세요. 1회전 나선형 난간과 디딤판 외부 끝에 수직 난간동자를 추가하세요.</td> <td><img src="benchmarks/benchmark09spiralstaircase.gif" alt="나선형 계단 회전 gif" width="220"></td> </tr> <tr> <td>10</td> <td><a href="benchmarks/10-planetary-gear-stage.md">단순화된 유성 기어 단</a></td> <td>별도의 선 기어, 유성 기어, 링 기어, 캐리어, 핀 본체가 있는 평면 유성 기어 어셈블리를 만드세요. 단순화된 사다리꼴 치형을 사용하고 42 mm 반경 원에 선 기어 주위에 3개의 유성 기어를 배치하세요.</td> <td><img src="benchmarks/benchmark10planetarygearstage.gif" alt="유성 기어 단 회전 gif" width="220"></td> </tr> </tbody> </table>

🛠️ 기여

개발은 develop 브랜치에서 이루어집니다. main이 아닌 develop에 PR을 열어주세요. 로컬 기여 워크플로우, 스킬 연결 및 검증 지침은 CONTRIBUTING.md를 참조하세요.