원문: cathrynlavery/diagram-design · 커밋 f903933 · Stars 약 4.3만 · MIT · 갤러리 cathrynlavery.github.io/diagram-design

개요

BestSelf.co 운영자이자 littlemight.com 필자 Cathryn Lavery가 만든 Agent Skill이다. Claude에게 다이어그램을 부탁하면 사이트 톤과 안 맞는 “둥근 상자” 그림만 나온다는 불만에서 출발했고, “No shadows. No Mermaid slop.”을 내건다. 결과물은 빌드 단계·JS·외부 이미지 없이 브라우저에서 바로 열리는 단일 HTML + 인라인 SVG다.

무엇을 만드나

  • 42종 레이아웃: 아키텍처, 플로차트, 시퀀스, 상태 머신, ER, 타임라인, 스윔레인, 사분면, 루프/플라이휠, 트리, 레이어 스택, 벤, 피라미드, 막대·선·산점도, 간트, Sankey, 피시본, Wardley 맵, 칸반, 사용자 여정, 배포, 의존성 그래프, UML 클래스, DB 스키마, 워터폴, 아키텍처 델타(Before·Changes·After) 등.
  • 각 타입마다 minimal light / minimal dark / full-editorial 세 변형.
  • 의미 패턴(semantic patterns): 큐·정책 추적·신뢰 경계 같은 “동작”을 레이아웃과 분리해, 타입 수를 늘리지 않고 가장 가까운 레이아웃에 얹는다. v2.3부터 선택적 접근성 모션.
  • draw.io·Mermaid·Excalidraw 소스를 원하는 형식·크기·밀도로 다시 그려 준다.
  • 디자인 원칙: “가장 품질 높은 수는 대개 삭제”, 강조색은 독자가 먼저 볼 1~2개에만, 목표 밀도 4/10.

브랜드 온보딩

onboard diagram-design to https://yoursite.com이라고 하면 홈페이지를 읽어 배경·본문색·보조색·CTA색·폰트를 paper/ink/muted/accent 같은 의미 토큰으로 매핑하고, diff를 보여 준 뒤 references/style-guide.md에 쓴다. 쓰기 전에 WCAG AA 대비를 검사해 실패하는 색은 조정안을 낸다. 새 프로젝트에서 스타일 가이드가 기본값이면 기본 스킨으로 조용히 내보내지 않고 먼저 묻는 “first-run gate”가 있다. SVG에는 role="img", <title>/<desc> 접근성 이름이 기본으로 들어간다.

설치

호스트방법
Claude Code/plugin marketplace add cathrynlavery/diagram-design → /plugin install diagram-design@diagram-design (서드파티 마켓플레이스는 자동 업데이트를 한 번 켜야 함)
Codex / GitHub Copilot / Factory Droid각 CLI의 plugin marketplace add
Pi, Kiro, OpenCodePi는 pi install, Kiro는 저장소 하위 경로 URL 가져오기, OpenCode는 skills/diagram-design/ 복사·심링크

위키 맥락

텍스트로 다이어그램을 그리는 흐름은 diagrams-as-code에 정리돼 있다. diagram-design은 Mermaid 같은 DSL 대신 에이전트가 직접 편집 품질의 SVG를 쓰게 하는 쪽이다. 아키텍처 다이어그램 전용 스킬 archify(2026-09-12-tt-a1i-archify)와 비교해 볼 만하고, 디자인 토큰을 파일로 고정한다는 발상은 2026-05-02-google-design-md-vs-anthropic-claude-design과 닮았다.

한계

README만 정리했고 직접 생성해 보지는 않았다.