이미지 모델이 흉내 낼 수 없는 도해를 그리는 skill

생성된 도해에는 아주 구체적인 실패 방식이 있어요. 한 번 써 본 사람은 다 알아요. 기어박스 단면을 그려 달라고 하면 단면처럼 보이는 무언가가 나와요. 다만 톱니는 서로 물리지 않고, 축은 베어링 하우징을 그대로 통과해요. 썸네일 크기에서는 맞아 보이지만, 그 주제를 아는 사람이 보는 순간 무너져요.
Anatomy는 10월 초부터 약 27,000 stars를 모은 skill 저장소이고, 이 문제를 반대쪽에서 풀어 보려고 해요. 그림을 생성하지 않아요. 작게 동작하는 모델을 먼저 만들고, 그 모델을 그려요.
무엇을 하는지
지시문은 일부러 밋밋해요. token bucket 레이트 리미터를 설명해 달라고 하면 네모 세 개짜리 순서도가 나오지 않아요. 그 개념의 작동 방식 자체가 물리적인 물건이 되도록 발명하고, 수십 개의 음영 처리된 부품으로 그 물건을 만들고, 제목과 힌트와 실시간 수치가 있는 카드에 담고, 포인터와 키보드로 움직이게 해요.
개념에서 기구로 옮기는 일이 창작 단계이고, 예시를 보면 얼마나 직역적인지 알 수 있어요. 아무것도 바뀌지 않았을 때 계산을 건너뛰는 캐시 키는 모든 핀이 정확한 높이에 있을 때만 돌아가는 핀 텀블러 자물쇠가 돼요. 하나의 GPU 컨텍스트가 여러 캔버스를 맡는 건 프린트 헤드 하나가 16개의 구멍을 차례로 도는 갠트리 플로터가 돼요. 둘 다 도해 위에 비유를 붙인 게 아니에요. 둘 다 기구이고, 거기서의 물리적 제약은 소프트웨어의 제약과 같아요.
숫자의 출처는 시뮬레이션
여기에 이걸 그리기 도구와 갈라놓는 설계 결정이 있어요.
도해에 표시되는 모든 숫자는 부품을 움직이는 그 작은 모델에서 나와요. 로켓 엔진 카드의 압력 값은 배기 플룸도 움직이는 시뮬레이션이 계산한 것이고, 누가 직접 입력한 라벨이 아니에요. 다이얼 인디케이터의 바늘은 캐리지가 어느 게이지 블록 아래로 들어갔는지를 가리켜요. 기하가 그렇게 정하기 때문이에요.

이 제약 하나로 생성 일러스트가 잘 빠지는 오류 종류가 통째로 사라져요. 그림은 바늘을 40에 두면서 캐리지를 25 블록 아래에 둘 수 있어요. 둘을 잇는 게 없으니까요. 시뮬레이션은 그러지 못해요. 모델이 틀리면 그림도 일관되게 틀려요. 엔지니어는 바로 알아봐요. 그럴듯한 헛소리보다 훨씬 나은 실패 방식이에요.
raptor-engine 예시는 여기서 더 나가요. 마우스를 올리면 엔진이 11개 어셈블리로 분리돼요. 저장소에는 정지 상태, 분리 상태, 그리고 그 사이 전환의 모든 프레임에서 어떤 배관도 고체 부품을 관통하지 않는다는 감사가 들어 있어요. 애니메이션 전체에 걸친 충돌 검사예요. 렌더링 파이프라인은 이런 말을 할 수 있고, 확산 모델은 시도조차 못 해요.
부품 목록
출력은 구조가 SVG이고, 연속적인 장이 필요한 곳에는 선택형 WebGL 셰이더를 써요. 로켓의 배기 플룸, 물결 수조 아래 종이에 비치는 코스틱스, 수면의 반사 같은 것들이에요. 베타인 3D 모드는 다이얼을 끄는 동안 매 프레임 약 90개 부품을 다시 투영하고 다시 셰이딩해요.
예시는 규모의 기준도 돼요. 다이얼 인디케이터가 약 300줄로 가장 작고, 형식을 이해하려면 이걸 먼저 읽는 게 좋아요. 물결 수조는 SVG 장치를 두 번의 WebGL 패스 위에 얹고 분산과 광학 모델로 구동하니 훨씬 큰 작업이에요.
저장소의 스크린샷은 skill 자체의 `scripts/capture.mjs`로 찍어요. 의도된 작업 방식이 보여요. 결과물은 아티팩트로 검토하는 것이고, 채팅창에서 감상하는 게 아니에요.
설치하기
모델이 아니라 skill이라서 설치는 복사예요.
npx skills add wheresryan22/anatomy -g
CLI가 어떤 에이전트에 설정할지 물어봐요. 지원 대상은 Claude Code, Antigravity, OpenCode, Codex, MiniMax Code이고, `-a claude-code`, `-a antigravity`, `-a opencode`, `-a codex`, `-a minimax-code`로 질문을 건너뛸 수 있어요. 전역 설치면 대상에 따라 `~/.claude/skills/anatomy`, `~/.gemini/antigravity/skills/anatomy`, `~/.config/opencode/skills/anatomy`, `~/.agents/skills/anatomy`, `~/.minimax/skills/anatomy`에 들어가요. `-g`를 빼면 프로젝트 하나의 `.claude/skills/anatomy`나 `.agents/skills/anatomy`에 설치돼요.
요구 사항은 Node 20.10 이상뿐이고 다른 건 없어요. API key도, `npm install`도, 빌드 단계도 없어요. Node 내장 모듈만 쓰기 때문이에요. CLI를 쓰고 싶지 않다면 저장소를 skills 디렉터리에 clone해도 똑같이 동작해요.
그다음 Claude Code에서:
/anatomy explain how a token bucket rate limiter works, interactive
Codex에서는 명령이 `$anatomy`예요. 나머지 세 에이전트는 `/anatomy`를 써요.
이미지 모델과의 관계
이미지 생성이 분기마다 좋아지는 걸 지켜본 사람이라면 먼저 이렇게 물을 거예요. 그냥 일러스트를 생성하면 안 되나.
두 도구가 답하는 질문이 다르기 때문이에요. 확산 모델은 "이 도해는 보통 어떻게 생겼나"에 답해요. Anatomy는 "이 기구는 이런 파라미터에서 실제로 무엇을 하나"에 답해요. 마케팅 페이지라면 전자로 충분하고 훨씬 싸요. 고객이 계약 전에 읽는 기술 해설이라면 후자만 검증을 견뎌요.
비용은 있어요. 작지 않아요. 생성 이미지는 몇 초와 API 호출 한 번이면 돼요. Anatomy는 빌드 루프를 돌려요. 기구를 발명하고, 부품을 모델링하고, 움직임을 연결하고, 수치를 시뮬레이션하고, 마지막으로 모든 관절을 확대해 하나씩 확인하는 자체 점검을 해요. 이 자체 점검이 파이프라인의 일부라고 저장소가 분명히 말해요. skill이 다듬기가 아니라 검증에 토큰을 쓰고 있다는 뜻이에요.
속도보다 정확성을 택하는 이 거래는 이번 달 에이전트 도구 전반에서 보이는 것이에요. 흥미로운 건 그게 일러스트에 적용된다는 점이에요. 대부분이 영원히 이미지 모델의 영역이라고 여겼던 분야예요.
제가 쓸 곳
세 가지이고, 확신이 큰 순서예요.
어려운 질문을 던질 사람에게 보내는 아키텍처 설명이에요. 시뮬레이션으로 만든 파이프라인 도해는 불가능한 데이터 흐름이 생기지 않아요. 흐름이 곧 부품이 하는 일이니까요.
물리적 직관이 핵심인 교육 자료예요. 물결 수조 예시가 있는 이유는 간섭을 눈으로 보는 게 더 쉽기 때문이에요. 두 진동자가 파를 만들고 그 무늬가 종이에 맺히는 걸 보면 이해가 빨라져요.
그리고 아무도 그리고 싶어 하지 않는 내부 문서예요. 이 skill의 진짜 가치는 변명을 없애 준다는 데 있을지도 몰라요. 기구를 한 문장으로 설명하면 관절까지 확인한 결과가 돌아와요.
특정 브랜드 스타일, 사진, 사람 얼굴이 필요한 곳에는 쓰지 마세요. 그리는 건 기계예요. 범위는 거기까지이고, 그 범위 안에서 지금 어떤 이미지 모델도 하지 않는 일을 하고 있어요.