stack-diagram — 문장 한 줄로 공식 로고가 들어간 아키텍처 다이어그램을 그리는 에이전트 스킬
아키텍처 다이어그램은 설계 리뷰와 문서화에서 매번 손으로 그리는 작업입니다. 전용 편집기에서 상자를 배치하는 방식은, 이미 에이전트에게 스택을 설명한 대화를 다시 그림으로 옮기는 중복을 만듭니다.
caru-ini의 stack-diagram은 그 설명 문장 자체를 입력으로 삼는 에이전트 스킬입니다. 저장소는 2026년 11월 1일에 만들어졌고, 862스타를 모았습니다. 구현 언어는 TypeScript입니다.
스킬 하나가 설치 한 줄로 여러 에이전트를 함께 지원하는 구조는, 스킬이 특정 하네스에 묶이지 않는 배포 단위가 됐다는 신호입니다.
입력 문장 한 줄의 형태
README가 드는 예시는 스택을 그대로 문장으로 적은 형태입니다. 프론트엔드와 API, 배포처와 데이터베이스, 인증과 결제까지 한 문장에 담깁니다.
Next.js and a Hono API on Vercel. Postgres on Neon, auth with Clerk, payments with Stripe. GitHub Actions deploys.
이 문장이 아래 그림으로 바뀝니다. Next.js와 Hono는 Vercel 안에 놓이고, Neon과 Clerk, Stripe가 공식 로고와 함께 연결됩니다.
결과물 파일의 구성
결과물은 폰트와 로고를 안에 품은 HTML 파일 하나입니다. 네트워크 없이 어디서든 렌더링되고, PNG와 React 컴포넌트도 같은 파일에서 뽑을 수 있습니다.
모든 다이어그램은 라이트와 다크 두 테마로 함께 렌더링됩니다. 문서를 밝은 화면으로 읽는 독자와 다크 모드로 읽는 독자에게 파일을 따로 만들 필요가 없다는 뜻입니다.
설치 방법과 지원 에이전트
설치는 한 줄로 끝납니다.
npx skills add caru-ini/stack-diagram
- Claude Code에서 동작합니다.
- Codex에서 동작합니다.
- Cursor와 agentskills.io 규격을 지원하는 다른 에이전트에서 동작합니다.
- Claude 앱에서는 Releases의
stack-diagram.zip을 스킬로 올려서 씁니다.
릴리스도 빠르게 이어졌습니다. v0.1.0이 11월 1일에 나왔고, v0.3.0이 11월 2일에 공개됐습니다.
갤러리 게시와 동의 절차
그린 그림은 공개 갤러리인 stacks.caru.moe에 올릴 수 있습니다. 에이전트는 게시 전에 공개 범위를 보여 주고, 사용자가 두 번 동의한 뒤에만 올립니다.
프롬프트 자체는 보내지 않는다는 점도 README가 분명히 적고 있습니다. 갤러리에 올라간 그림의 삭제는 GitHub 로그인을 연결했을 때만 가능하다고 설명합니다.
확인되지 않은 지점
- 로고가 없는 서비스나 사내 시스템을 그릴 때의 처리 방식은 README에 적혀 있지 않아 미확인입니다.
- 복잡한 스택에서 연결 관계를 얼마나 정확히 잡는지는 독립 검증이 없습니다.
- 갤러리에 올라간 그림의 삭제 조건은 GitHub 로그인 연결 여부에 달려 있습니다.
실무 판단
설계 문서를 쓰는 자리에서 다이어그램까지 같은 흐름으로 뽑을 수 있다는 점이 이 스킬의 실용적인 지점입니다. 이미 에이전트와 나눈 스택 설명을 편집기에서 다시 그릴 필요가 없어지기 때문입니다.
도입을 검토한다면 본인 스택 한 문장으로 먼저 그려 보시기 바랍니다. 공식 로고가 없는 사내 시스템이 섞인 그림에서 무엇이 빠지는지까지 확인하면, 문서화 작업에 붙일 수 있는 범위가 바로 드러납니다.