text-to-cad
무엇인가
text-to-cad는 로컬 프로젝트 파일을 입력으로 삼아 CAD 모델과 로봇 기술(robot-description) 산출물을 만들고, 검사하고, 소싱하고, 슬라이싱하고, 다음 단계로 넘기는 작업 흐름을 에이전트 규칙으로 고정하는 라이브러리다. 기하 모델링 자체보다 그 주변 절차 — 어떤 파일을 어떤 순서로 생성·검증하고 무엇을 산출물로 남기는가 — 를 규율 대상으로 삼는다.
어떻게 동작하나
각 스킬은 SKILL.md 형식의 규칙 파일로 배포되며, 스킬마다 별도의 requirements.txt를 두고 자신이 게시된 시점의 cadgen 릴리스 버전을 고정한다. 설치된 스킬은 지원 에이전트가 작업 시 자동으로 로드하는 방식으로 발동하고, 별도 슬래시 명령을 요구하지 않는다. 저장소 루트에는 Codex·Claude Code·Grok Build가 공통으로 읽는 플러그인 매니페스트(.claude-plugin/marketplace.json)가 있어 플러그인 경로로도 같은 스킬 집합이 붙는다.
무엇과 다른가
단일 CLAUDE.md나 AGENTS.md에 규칙을 몰아넣는 방식, 또는 매 작업마다 프롬프트를 직접 쓰는 방식과 구조가 다르다. 규칙이 CAD·URDF·SRDF/MoveIt2 같은 작업 영역별 스킬로 분리되어 필요한 것만 설치·갱신할 수 있고, 의존성이 스킬 단위 requirements.txt로 고정되어 재현 가능한 실행 환경을 전제로 한다. 업데이트도 lockfile에 이미 등록된 스킬만 갱신하는 방식이 아니라 패키지를 다시 받아 덮어쓰는 방식을 권장해, 새 릴리스에서 추가된 스킬까지 함께 반영된다.
어떻게 쓰나
설치는 Skills CLI 경로가 우선이다. `npx skills add earthtojake/text-to-cad`로 개별 스킬을 지원 에이전트에 직접 설치하고, 같은 명령을 다시 실행해 갱신한다. 플러그인 경로를 쓰면 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`, Grok Build는 `grok plugin install earthtojake/text-to-cad --trust` 후 `grok plugin enable cad`를 실행한다. 설치 후 스킬이 보이지 않으면 에이전트를 재시작한다.
전제와 한계
Codex 플러그인 경로는 0.142.0 이상에서만 저장소 루트 플러그인을 해석하며, 그 미만 버전에서는 오류 없이 건너뛰어 `codex plugin list`에 나타나지 않는다. `npx skills update`는 lockfile에 있는 스킬만 갱신하므로 새로 추가된 스킬을 놓치고, 업스트림에서 폐기된 스킬은 어느 명령도 자동으로 제거하지 않아 `npx skills remove`로 직접 지워야 한다. 저장소의 models/ 픽스처 코퍼스는 LFS 포인터로만 내려오며 스킬 사용에는 필요하지 않다.