TL;DR

이 레포지토리는 에이전트가 자연어로 CAD와 로봇 기술 파일을 생성·편집하고 STEP, STL, 3MF, URDF, SDF 등으로 내보내는 모듈식 스킬 라이브러리이다. 각 스킬은 입력을 파싱한 뒤 기하학 생성 루틴이나 템플릿 작성기를 호출하여 표준 포맷으로 직렬화하고 Skills CLI 또는 provider 플러그인으로 에이전트 런타임에 즉시 연결된다. 브라우저 기반 CAD Viewer로 로컬 미리보기와 검증이 가능하고 SendCutSend, G-code, Bambu Labs 연동으로 제조 준비까지 이어지는 파이프라인을 구성한다. 설치는 npx skills install 명령 또는 Codex/Claude Code용 플러그인 설치로 시작할 수 있으며 대형 미디어는 Git LFS로 별도 관리된다.

주요 기능

• CAD 모델을 생성하고 편집하는 워크플로를 제공한다. 자연어 또는 이미지 입력을 파싱하여 BuildCAD 스타일의 기하학적 구성요소를 조립하며 결과를 STEP을 기본으로 내보낸다. 브라우저 기반 CAD Viewer를 통해 로컬에서 모델을 미리보기하고 형상 검증을 수행할 수 있다.
• 로봇 기술 파일을 자동으로 작성하고 보완하는 기능을 포함한다. URDF로 링크·조인트·관성·메시 참조를 생성하고 SRDF로 모션 플래닝 관련 그룹과 충돌 예외를 구성한다. SDF 출력은 시뮬레이션 환경과 센서 구성을 포함하여 시뮬레이터에 바로 투입할 수 있게 한다.
• 오프더쉘프 부품 검색과 파일 검사 파이프라인을 제공한다. step.parts 스킬은 표준 부품(볼트, 베어링, 모터 등)을 찾아 디자인에 삽입할 수 있게 하고 SendCutSend 스킬은 업로드 전 파일 검증을 자동화한다. G-code 스킬은 메쉬를 슬라이스하고 프린터 프로파일에 맞춘 안전검사를 수행한다.
• 다양한 출력 포맷과 도구 연동을 지원한다. 기본 출력으로 STEP을 사용하며 필요 시 STL, 3MF, GLB 등으로 변환하고 로컬 프린터 제어를 위해 Bambu Labs 연동을 제공한다. 플러그인 방식으로 Codex나 Claude Code 같은 에이전트에 스킬을 연결하여 즉시 사용 가능한 통합 경험을 만든다.

어떻게 동작하는가

레포지토리는 에이전트가 호출할 수 있는 개별 스킬 모듈들의 집합으로 구성되어 있다. 각 스킬은 입력(자연어/이미지)을 파싱하고 내부적으로 기하학 생성 루틴이나 템플릿 기반 작성기를 호출하여 CAD/로봇 파일을 생성한 뒤 지정된 출력 포맷으로 직렬화한다. Skills CLI를 통해 에이전트별 설치가 가능하며 Codex와 Claude Code용 플러그인 형태로도 배포되어 에이전트 런타임에서 직접 스킬을 호출할 수 있다.

해결 문제

에이전트가 CAD와 로봇 기술 파일을 생성·검토·내보내는 일련의 수동 작업을 자동화한다. 자연어로 요구사항을 입력하면 스킬이 기하학을 생성하고 표준 파일 포맷(STEP, STL, 3MF, URDF 등)으로 직렬화하여 후속 툴체인으로 전달한다. 그 결과 설계-검증-제작 파이프라인에서 파일 변환, 부품 소싱, 슬라이싱, 시뮬레이션 준비 같은 반복 작업을 줄인다.

지금 주목받는 이유

레포지토리는 에이전트 통합형 CAD·로봇 스킬을 모듈 형태로 제공하며 GitHub에서 9,578개의 스타를 보유하여 실무자와 취미 제작자 사이에서 널리 주목을 받았다.

차별점

• 에이전트 친화적 스킬 집합 형태로 설계되어 손쉬운 통합을 지원한다. 각 스킬은 독립 모듈로 패키징되어 Skills CLI 또는 provider-native 플러그인으로 에이전트에 바로 연결할 수 있다. 이로 인해 특정 에이전트 런타임에 맞춰 별도 변환 코드 없이도 워크플로를 확장할 수 있다.
• CAD 출력의 기본 포맷으로 STEP을 채택하여 상호운용성을 우선시한다. 복합 어셈블리와 메타정보를 보존하는 STEP을 기본으로 사용함으로써 downstream CAD 도구와의 데이터 호환성을 높인다. 추가적으로 STL·3MF·GLB 등의 경량 출력으로 3D 프린팅과 웹 뷰잉 흐름을 동시에 지원한다.
• 로봇 관련 산출물(URDF, SRDF, SDF)을 함께 제공하여 설계에서 시뮬레이션까지 연결한다. 링크·조인트·플래닝 그룹 등의 서술을 자동 생성하여 MoveIt2 같은 플래너와 바로 연동할 수 있도록 구성되어 있다. 설계 단계에서 시뮬레이션 준비와 모션 플래닝 설정을 병행할 수 있게 한다.

사용 사례

• 제품 설계 초기 단계에서 자연어 요구사항을 빠르게 프로토타이핑하는 용도로 사용된다. 사용자는 텍스트로 치수와 구속조건을 입력하면 스킬이 기초 기하를 생성하고 STEP으로 내보내어 CAD팀이 이어서 상세화할 수 있다. 이 과정은 반복적 설계 공간 탐색 시간을 단축하고 설계-검증 루프를 가속화한다.
• 로봇 설계와 시뮬레이션 준비를 자동화하는 워크플로에 적용된다. URDF와 SRDF를 자동 생성하여 로봇 모델을 시뮬레이터와 플래너에 곧바로 투입할 수 있으며 SDF 생성은 물리 기반 검증을 위한 시뮬 환경 구축을 간소화한다. 이로 인해 설계 변경 시 시뮬레이션 반영이 빨라진다.
• 3D 프린트 및 제작 파이프라인에서 파일 검사와 업로드를 자동화하는 용도로 활용된다. G-code 스킬과 SendCutSend 연동은 슬라이스와 업로드 전 검증을 실행하여 제조 실패 및 재작업 리스크를 낮춘다. 현업의 반복적 출력 준비 과정을 자동화하여 제작 사이클을 단축한다.

시작하기

빠른 시작은 Skills CLI로 진행하며 npx skills install earthtojake/text-to-cad 명령으로 에이전트에 스킬을 설치할 수 있다. Codex나 Claude Code 환경에서는 각 마켓플레이스 등록과 설치 명령(codex/claude 플러그인 명령)을 실행하면 에이전트 런타임에서 즉시 'cad' 스킬을 호출할 수 있다. 로컬 개발은 develop 브랜치에서 분기하여 symlink 워크플로를 사용하고 PR을 통해 기여하는 방식으로 진행된다.

요구사항

• Node.js 및 npx가 설치된 환경이 필요하다. Skills CLI를 통해 스킬 설치와 플러그인 관리를 수행하므로 Node 기반 런타임이 필수이다. 운영체제별 추가 종속성은 개별 스킬의 requirements.txt 또는 SKILL.md에 명시되어 있으며 이를 병행해서 설치해야 한다.
• Python 3.11 이상이 일부 스킬에서 요구된다. README의 배지와 각 skills/*/SKILL.md는 Python 의존성을 참조하고 있으며 특히 CAD 기하 생성이나 외부 툴 연동을 위해 Python 런타임이 필요할 수 있다. 로컬 개발 환경에서는 해당 Python 패키지들을 pip로 설치하여 스킬의 런타임 의존성을 충족해야 한다.