기술 문서를 작성하여 Claude Code에게 아키텍처 다이어그램을 그리게 하면, 결과물인 SVG에서 종종 연결선이나 폰트 등의 문제가 발생합니다.

svg-diagram이라는 Agent Skill은 Agent가 그림을 그릴 때 지켜야 할 규칙들을 정의했습니다. 박스의 높이는 글자 크기에 맞춰 계산하고, 연결선의 꺾임은 곡선으로만 처리하며, 화살표는 목표 박스에서 11픽셀 거리를 유지하도록 했습니다.

여기에 추가적으로 종속성 없이 사용할 수 있는 검사기가 포함되어 있습니다. 이 검사기는 최종 SVG 파일을 읽어와서, 이스케이프(escape), 여백(whitespace), 폰트, 중첩(overlap), 색상 구성 등 총 12가지 항목을 점검하며, 오류가 발생하면