개념 글 그림을 상자 대신 움직이는 기계로 받는 anatomy 스킬

동딩
2026.10.13·3분 읽기·

설치하고 개념과 숫자로 부른다

anatomy는 개념을 그 개념대로 움직이는 기계로 그려 주는 Claude Code 스킬입니다. 토큰 버킷은 API를 연달아 부르면 429 Too Many Requests가 오는 이유를 푸는 개념입니다. anatomy로 그리면 통 안의 동전이 토큰이 되고, 통이 비면 429 표지판이 올라옵니다. 그림을 둘 저장소 폴더에서 한 줄을 실행합니다.

github.com
GitHub - wheresryan22/anatomy: An agent skill for creating detailed, interactive isometric illustrations of real-world machines and complex systems. Generates polished SVGs with optional WebGL shaders
An agent skill for creating detailed, interactive isometric illustrations of real-world machines and complex systems. Generates polished SVGs with optional WebGL shaders and 3D effects. - wheresrya...
bash
npx skills add wheresryan22/anatomy -a claude-code
anatomy 설치 위치와 보안 평가 결과

설치 요약과 보안 평가 표가 뜨면 끝입니다. .claude/skills 폴더가 이번에 처음 생겼다면, 열려 있던 Claude Code 세션에서 /reload-skills를 한 번 칩니다.

/anatomy 뒤에는 그릴 모양 대신 설명할 개념과 실제 숫자, 둘 곳을 적습니다. '인터랙티브하게'를 빼면 움직이지 않는 그림이 나옵니다.

text
/anatomy 레이트 리미터 개념 글에 넣을 토큰 버킷 그림을 인터랙티브하게 HTML 한 파일로 만들어 줘. 버킷에는 토큰이 20개 들어가고 초당 5개씩 채워지며, 요청마다 1개를 쓰고 비어 있으면 429로 거절돼. 블로그 바탕은 흰색이야.

스킬 없이 만든 쪽은 '자동 요청'을 켜고, /anatomy 쪽은 판을 누르고 있으면 버킷이 비고 429가 납니다.

같은 토큰 버킷 요청을 스킬 없이와 /anatomy로 만든 결과

스킬 없이 만든 쪽은 버튼과 로그가 동작을 알려 줍니다. /anatomy 쪽은 동전이 빠지고 다시 차는 모양으로 동작을 보여 줍니다.

모든 프로젝트에서 쓰거나 실행 조건을 확인하려면

-g를 붙이면 저장소가 아니라 사용자 폴더에 설치되어 모든 프로젝트에서 부를 수 있습니다.

bash
npx skills add wheresryan22/anatomy -g -a claude-code

그림 도구는 Node 내장 모듈만 써서 npm install이 필요 없습니다. Node 20.10 이상과 Chrome만 있으면 됩니다. Chrome은 스킬이 자기 그림을 찍어 볼 때 씁니다.

자기 그림을 찍어 보며 고친다

anatomy는 첫 응답에서 그림 크기부터 정합니다. 메커니즘 하나짜리 작은 그림이라 묻지 않고 바로 그리기 시작합니다.

/anatomy가 그림 크기부터 정하는 첫 응답

anatomy는 끝내기 전에 자기 그림을 찍어 보고 허공에 뜬 선까지 고칩니다. 스킬 없이 1분이 안 걸리던 요청이 10분 안팎 걸립니다.

요청에 적은 숫자는 부품 하나씩으로 옮겨집니다.

스킬 없이/anatomy
토큰 20개컵 안의 파란 점통에 쌓인 동전
초당 5개 채움점이 서서히 진해짐계량 원판이 동전을 떨굼
요청 1번요청 보내기 버튼푸시로드가 맨 아래 동전을 밀어냄
비었을 때 429테두리가 붉게 깜빡임헛친 뒤 429 표지판이 올라옴
토큰 버킷의 부분마다 두 그림이 맡긴 모양
버킷 크기 같은 숫자를 바꿔 다시 만들려면

그림 속 숫자는 모두 14줄짜리 bucket.mjs 하나에서 나옵니다. 동전 기둥 높이와 판에 새긴 20 · +5/s, 오른쪽 아래 실시간 숫자가 이 파일을 함께 읽습니다. 원본 폴더는 스킬 폴더 안에 생기고, 결과 HTML의 경로는 마지막 응답에 적힙니다.

js
// .claude/skills/anatomy/examples/token-bucket/bucket.mjs
export const CAPACITY = 30;
export const REFILL = 5; // tokens per second
bash
cd .claude/skills/anatomy/examples/token-bucket && node build.mjs

30으로 바꿔 다시 빌드하면 동전이 30개로 늘고 실시간 숫자도 30.0 / 30이 됩니다. 카드 아래 설명 문장의 "최대 20개"와 "초당 5개씩"은 build.mjs에 글자로 들어 있어 함께 고칩니다. 다크 테마는 node build.mjs --dark로 만듭니다.

움직이는 개념이면 같은 꼴로 부른다

개념 글 첫머리에 오래 둘 그림 한 장이면 /anatomy를 부릅니다.

  • 문서 안에서 자주 고치고 diff로 리뷰할 흐름도는 Mermaid 같은 글자 다이어그램이 낫습니다.
  • 막대·축이 필요한 수치 비교는 차트 라이브러리에 맡깁니다.
  • 사람이나 지도처럼 메커니즘이 없는 대상에는 쓰지 않습니다.

부르는 꼴은 /anatomy explain <개념>, interactive 한 줄입니다. 공식 컬렉션은 그림마다 그 그림을 부른 한 줄을 함께 싣습니다.

text
/anatomy explain a message queue with producers and consumers, interactive
/anatomy explain how a mutex prevents a race condition, interactive
/anatomy explain debounce versus throttle, interactive
공식 컬렉션의 세 기계(anatomy-figures 0.1.0, MIT)

같은 개념도 부를 때마다 기계가 달라질 수 있습니다. 컬렉션의 토큰 버킷은 동전 통이 아니라 공기 벤치입니다.

엔진처럼 부품이 많은 기계를 부탁한다면

anatomy는 첫 응답에서 정한 크기에 따라 바로 그리거나 먼저 알립니다. 메커니즘 하나에 부품 40~80개인 Figure는 바로 만듭니다. 부품 80~150개인 Hero는 2~4시간이 걸린다고 알린 뒤 만듭니다. 탈것이나 공장 규모의 Epic은 사용자가 고를 때까지 시작하지 않습니다.

Comments

댓글

powered by giscus ↗