CAD Skills 소개
CAD Skills는 Codex나 Claude Code 같은 코딩 에이전트가 자연어 설명으로부터 CAD 모델과 로봇 기술 파일을 생성하고 검토할 수 있도록 묶어 둔 스킬 모음입니다. 저장소 이름은 text-to-cad 이지만, CAD Skills 라는 이름으로 프로젝트를 소개하며, 단일 명령 한 줄을 자연어로 요청하는 텍스트 -> CAD 사용 경험을 코드 편집 에이전트 위에 얹는 것을 목표로 합니다.
CAD Skills의 차별점은 결과물을 코드처럼 소스 관리 하는 워크플로우에 있습니다. 에이전트가 직접 손대는 것은 사람이 읽을 수 있는 파이썬 기반 build123d 소스이고, STEP, STL, 3MF, DXF, GLB 같은 산출물은 명시적인 target 으로 재생성됩니다. CAD Explorer라는 로컬 뷰어로 결과 형상을 즉시 확인하고, @cad[...] 라는 안정적인 참조 핸들을 통해 후속 에이전트 편집에서 동일한 지오메트리를 정확히 지목할 수 있도록 설계됐습니다.
CAD Skills의 스킬 구성
CAD Skills는 다음과 같은 7개 스킬들의 묶음으로 구성되어 있습니다:
| 스킬 | 역할 |
|---|---|
| CAD | STEP, STL, 3MF, DXF, GLB, 토폴로지 데이터, 렌더 이미지, @cad[...] 지오메트리 참조를 생성합니다. |
| Render | CAD Explorer를 띄워 시각 검수 링크를 반환하고 스냅샷을 만듭니다. |
| step.parts | 나사, 너트, 와셔, 베어링, 스탠드오프, 전자 부품, 모터, 커넥터 등 기성 STEP 모델을 카탈로그에서 찾아 다운로드합니다. |
| URDF | 로봇 링크, 조인트, 한계, 메시 참조를 갖춘 URDF XML을 생성하고 검증합니다. |
| SRDF | MoveIt2 SRDF 시맨틱, 역기구학, 경로 계획, 선택적인 MoveIt2 서버 테스트를 다룹니다. |
| SDF | 시뮬레이터용 SDFormat XML과 월드 구조, 플러그인, 시뮬레이터별 메타데이터를 다룹니다. |
| SendCutSend | SendCutSend.com의 주문 가이드, 카탈로그, 재료 명세에 맞춘 DXF/STEP 업로드 사전 점검 보고서를 만듭니다. |
선택적인 harness/ 디렉터리는 코딩 에이전트가 큰 CAD 프로젝트를 다룰 때 지켜야 할 저장소 수준 지침 을 모아 둔 곳입니다. 소스 파일을 먼저 편집하고 파생 산출물은 명시적인 타겟으로 재생성, 넓은 저장소 스캔 회피, CAD 산출물을 LFS 중심으로 다루기 같은 규칙이 들어 있고, harness/AGENTS.md 와 harness/CLAUDE.md 를 다른 프로젝트 루트에 복사해 그대로 적용할 수 있습니다.
CAD Skills의 추천 워크플로우
CAD Skills 사용 시에는 다음 6단계를 거치는 것을 추천합니다:
1. Describe — 부품, 어셈블리, 픽스처, 로봇, 메커니즘을 자연어로 설명
2. Edit — 코딩 에이전트가 저장소의 CAD 소스 파일을 수정
3. Regenerate — STEP / STL / 3MF / DXF / GLB / URDF / SRDF / SDF 타겟 재생성
4. Inspect — CAD Explorer로 결과 모델을 검수
5. Reference — 후속 편집을 위한 @cad[...] 핸들 복사
6. Commit — 소스와 산출물을 함께 커밋
이 흐름의 핵심은 소스 우선 입니다. 에이전트의 편집 대상은 build123d 기반 파이썬 소스이고, 바이너리 산출물은 항상 명시된 타겟으로 다시 만들어지므로 깃 히스토리에서도 무엇이 어떤 의도로 바뀌었는지가 비교적 또렷이 남습니다.
CAD Skills의 벤치마크 세트
저장소는 자체 평가용 벤치마크 10개를 함께 두고 있으며, 각 벤치마크는 자연어 프롬프트와 기대 출력의 짝으로 구성됩니다. README "Benchmarks" 섹션이 정리하는 항목을 옮기면 다음과 같습니다.
| # | 타깃 |
|---|---|
| 1 | 네 개의 관통 구멍을 가진 직사각형 캘리브레이션 블록 |
| 2 | 볼트 구멍 패턴이 있는 원형 플랜지 |
| 3 | 거셋과 두 방향 구멍을 가진 L 브래킷 |
| 4 | 키웨이가 있는 단차 샤프트 |
| 5 | 보스가 있는 상부 개방형 전자 박스 |
| 6 | 경량화 컷아웃을 가진 항공기 스타일 클레비스 브래킷 |
| 7 | 냉각 핀을 가진 방사형 엔진 실린더 |
| 8 | 후방 굴절 블레이드를 가진 원심 임펠러 |
| 9 | 나선 핸드레일을 가진 나선 계단 |
| 10 | 단순화된 유성 기어 단 |
벤치마크 자산은 Git LFS로 보관되며 기본 클론에서는 제외됩니다. 로컬에서 확인하려면 다음 명령을 사용합니다.
git lfs pull --include="benchmarks/**"
CAD Skills 설치
가장 단순한 설치는 Skills CLI를 사용하는 방법입니다.
npx skills add earthtojake/text-to-cad
새 스킬이 보이지 않으면 에이전트를 재시작합니다. 직접 빌드해서 쓰고 싶다면 저장소를 클론한 뒤 파이썬 의존성과 뷰어 의존성을 따로 설치합니다.
git clone https://github.com/earthtojake/text-to-cad.git
cd text-to-cad
# 파이썬 CAD 의존성
python3.11 -m venv .venv
./.venv/bin/python -m pip install --upgrade pip
./.venv/bin/pip install -r skills/cad/requirements.txt
# 렌더 뷰어 의존성
npm --prefix skills/render/scripts/viewer install
# CAD Explorer 띄우기
npm --prefix skills/render/scripts/viewer run dev:ensure -- \
--workspace-root "$PWD" --root-dir .
CAD Explorer는 .step, .stp, .glb, .stl, .3mf, .dxf, .urdf, .srdf, .sdf 를 모두 지원하며, 브라우저 WebGL로 렌더링합니다. 리눅스에서 WebGL unavailable 같은 메시지가 뜨면 chrome://gpu 에서 하드웨어 가속이나 소프트웨어 WebGL을 켜고 시스템 그래픽과 Mesa 드라이버를 업데이트한 뒤 다시 열어 보라고 README는 안내합니다.
CAD Skills 라이선스
CAD Skills는 MIT 라이선스로 공개되어 있어 개인 및 상업적 목적으로 자유롭게 사용할 수 있는 permissive 라이선스입니다.
CAD Skills 데모
CAD Skills 프로젝트 홈페이지
CAD Skills 프로젝트 GitHub 저장소
이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다. 
파이토치 한국 사용자 모임
이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일
로 보내드립니다! (기본은 Weekly지만 Daily로 변경도 가능합니다.)
아래
쪽에 좋아요
를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ 