SkillArchitecture Diagrammer
컴포넌트와 연결을 담은 일반 텍스트 명세에서 검증된 SVG 아키텍처 다이어그램을 만듭니다. 알 수 없는 간선은 버리고, 중복 ID는 거부하며, 고립 요소와 순환을 지적하는 보고서가 함께 나옵니다.
지원: Claude Code, Codex, Cursor, Muse · 버전 1.0.0 · 필요 사항: 아키텍처 명세(spec.txt: [components]는 id: 레이블 | 유형, [connections]는 a -> b: 레이블).
미리보기
샘플 출력
이 Skill이 생성하는 것의 예시입니다. 설명을 위한 샘플 콘텐츠입니다.
Architecture Diagrammer report — sample Diagram report: Shop API Components: 5 | Edges drawn: 5 | Columns: 4 Components: Web App (client, column 0); API Server (service, column 1); Redis Cache (cache, column 2); Job Worker (service, column 2); Postgres (database, column 3). Edges: Web App -> API Server: HTTPS; API Server -> Redis Cache: GET; API Server -> Postgres: SQL; API Server -> Job Worker: Enqueue; Job Worker -> Postgres: SQL. Errors: none. Warnings: none. Messy draft check: 5 components, 3 edges drawn, 2 errors (duplicate api id; edge to unknown ghost dropped), 4 warnings (unknown type, 2 orphans, cycle api -> db -> api).
제공 내용
- 검증된 SVG 다이어그램: 의존 관계 열 배치, 레이블 화살표, 순환은 하단 우회
- 다이어그램 보고서: 컴포넌트·간선 표와 모든 오류·경고
- 그리기 전 검증: 알 수 없는 간선 버리기와 중복 ID 거부
- 다이어그램과 함께 관리할 수 있는 명세 형식
이 Skill 소개
일반 텍스트 명세([components]에 ID·레이블·유형, [connections]에 레이블이 있는 화살표)를 읽어 의존 관계 열로 배치한 SVG 다이어그램과 diagram-report.md를 출력합니다. 보고서에는 컴포넌트 표·간선 표·요소별 열·모든 오류와 경고가 포함됩니다. 알 수 없는 컴포넌트를 가리키는 연결은 그려지지 않고 버려지며, 중복 ID는 첫 정의가 남고, 고립 요소와 순환은 숨기지 않고 보고됩니다. 로컬 전용, 표준 라이브러리만 사용합니다. 다이어그램에는 명세에 적힌 것만 나타나며, 완성을 위해 추측하지 않습니다.
사용해 보기
이 명세로 Shop API 아키텍처 다이어그램을 그려주세요.이런 분께 적합
- README·문서·PR 리뷰용으로 시스템 기록하기
- 공유 전에 손으로 쓴 아키텍처 초안 검증하기
- 다이어그램을 정직하게 유지하기: 적힌 것만 그리기
적합하지 않은 경우
- 코드베이스에서 다이어그램 역생성하기 — 명세는 직접 작성합니다
- 빠진 컴포넌트·스토어·연결을 추측으로 채우기
- 아키텍처 자체의 정확성 증명하기 — 보고서가 깨끗해도 명세와 일치한다는 뜻일 뿐입니다
설치 방법
- 설치 프롬프트를 에이전트에 복사하세요:
Read https://skillu.dev/install/agent.md, then install the Architecture Diagrammer skill (architecture-diagrammer). - 또는 출시 후 이 페이지에서 Skill 패키지를 다운로드해, 그 폴더를 에이전트의 skills 디렉터리에 넣습니다.
- 슬래시 명령으로 호출하세요. 예:
/architecture-diagrammer. 그리고 원하는 것을 평범한 말로 설명하세요.
자주 묻는 질문
명세에 오류가 있으면요?
유효한 부분으로는 다이어그램이 그려지고, 보고서에 모든 오류와 경고가 나옵니다. 알 수 없는 간선은 버려지고, 중복 ID는 첫 정의가 남으며, 고립 요소와 순환이 지적됩니다. 명세를 고쳐 다시 실행하세요.
적지 않은 것이 그려지나요?
아니요. 다이어그램에는 명세의 요소와 연결만 나타납니다. 빠진 캐시나 폴백 경로는 명세의 빈틈이며, Skill이 임의로 채우지 않습니다.