Community이미지github.com

diagram-studio

다이어그램(아키텍처 다이어그램, 순서도, 파이프라인, 시스템 개요, 에이전트 루프)을 선명하고 편집 가능한 PNG 및 SVG로 재구성, 미화 및 생성합니다. 핵심 사용 사례는 기존 다이어그램 이미지(흐릿함, 저해상도, AI 생성, 복잡함 또는 워터마크 포함)의 고충실도 재그리기로, 정확한 텍스트, 레이아웃, 색상 및 스타일(손글씨 또는 깔끔/플랫)을 유지하면서 선명하게 만듭니다.

diagram-studio란 무엇인가요?

Diagram Studio는 개발자와 AI 에이전트 사용자를 위한 전문 다이어그램 도구로, 기존 다이어그램 이미지를 고충실도로 벡터 재구성하여 선명한 PNG와 SVG를 생성합니다. 흐릿하거나 저해상도, AI 생성, 복잡하거나 워터마크가 있는 이미지의 텍스트, 레이아웃, 색상, 스타일(손글씨 또는 깔끔/플랫)을 완벽하게 보존하면서 선명하게 만듭니다. Codex, Claude Code 등 다양한 AI 에이전트 플랫폼에서 작동하며, Node 18+만 있으면 추가 설치 없이 바로 사용할 수 있습니다. JSON 스펙을 기반으로 다이어그램을 정의하고 렌더링하며, 손글씨 스타일(rough.js 기반)부터 깔끔한 벡터 스타일까지 완전히 커스터마이징 가능합니다. 중국어를 완전히 지원하며, 기존 이미지의 색상을 추출하거나 글꼴을 매칭하는 등의 보조 도구도 함께 제공됩니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/stlmx/diagram-studio/tree/HEAD

Installed? Explore more 이미지 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Diagram Studio

JSON 스펙으로 깔끔한 다이어그램을 생성합니다. 모양은 완전히 설정 가능합니다:

  • 손글씨: rough.js의 흔들림과 손글씨 폰트.
  • 깔끔한 벡터: 흔들림 없음, 산세리프 또는 세리프 폰트, 부드러운 그림자.
  • 그 외 모든 중간 스타일.

모든 텍스트는 외곽선으로 변환되므로 SVG와 PNG가 모든 곳에서 동일하게 보입니다. 린터가 겹침, 텍스트 넘침, 경계선 위의 레이블, 상자를 통과하는 화살표를 잡아냅니다.

모든 것이 번들로 제공됩니다: Node 18+만 필요하며 npm install이나 네트워크가 필요하지 않습니다. SKILL_DIR은 이 스킬 폴더의 절대 경로(이 파일이 포함된 폴더)를 의미합니다.

node SKILL_DIR/scripts/render.mjs diagram.json --out out/     # → out/diagram.png (2x), .svg, .report.json, .tiles/

0. Codex, Claude Code 또는 다른 에이전트에서 실행하기

  • SKILL_DIR:
    • Codex에서는 스킬의 짧은 경로를 스킬 루트 테이블로 확장합니다(예: r0/diagram-studio/SKILL.md → ~/.codex/skills/diagram-studio).
    • Claude Code에서는 보통 ~/.claude/skills/diagram-studio입니다.
    • 항상 스크립트를 해당 절대 경로로 호출하세요.
  • 이미지 보기는 필수입니다: 원본, 그리드, 타일 및 비교 결과를 확인해야 합니다.
    • Codex: PNG 경로를 사용하여 view_image 도구를 사용하세요. render.mjs가 name.preview.png (≤ 1400 px)를 생성하므로 직접 크기를 조정할 필요가 없습니다. 세부 사항은 name.tiles/*.png를 사용하세요.
    • Claude Code: Read 도구를 사용하세요.
    • 린트 출력만으로 렌더링을 판단하지 마세요.
  • 샌드박스 친화적:
    • node만 필요합니다. 네트워크 호출이나 설치가 없습니다.
    • 출력은 --out 디렉토리로 이동합니다. 작업 공간 내에 유지하세요(예: ./diagram-out).
    • WebP/HEIC 변환은 시스템 임시 디렉토리를 사용합니다.
  • 사용자가 경로 대신 이미지를 붙여넣은 경우: 첨부 파일 경로를 볼 수 있으면 사용하세요. 그렇지 않으면 파일 경로를 물어보세요. 도구가 실제 파일을 필요로 하기 때문입니다.
  • 마무리: PNG, SVG 및 JSON의 절대 경로를 나열하여 사용자가 열 수 있도록 하세요.

1. 작업 선택

사용자 요청작업다음 읽기
"이 이미지를 더 선명하게 / 고해상도로 / 깔끔하게", "redraw / rebuild / 复刻 / 高清重建 this"A. 이미지에서 재구성. 충실도 우선: 다른 지시가 없으면 원본 스타일 유지references/rebuild-from-image.md (필수)
"Beautify / tidy / 美化 this diagram"A + 다듬기. A와 동일한 후 계층, 간격 및 정렬 개선references/rebuild-from-image.md
설명, 코드 또는 노트에서 새 다이어그램 생성B. 새 다이어그램references/spec.md
다른 스타일 적용 ("손글씨로", "플랫 코퍼레이트", "청사진", "논문용")C. 스타일 변경references/style-guide.md

주어진 이미지에 대해 기본적으로 스타일을 일치시킵니다: 손글씨는 손글씨로, 플랫은 플랫으로 유지하고 색상과 폰트 카테고리도 그대로 유지합니다. 사용자가 요청할 때만 모양을 변경합니다. 프리셋은 시작점일 뿐 한계가 아닙니다. styleOverrides, 사용자 정의 팔레트 및 사용자 정의 폰트 파일("fonts")로 거의 모든 모양을 재현할 수 있습니다. 요청이 진정으로 모호한 경우(예: 참조 스타일 없이 "beautify")에만 충실도 수준에 대해 물어보세요. 그렇지 않으면 충실 + 더 선명하게를 기본값으로 사용하세요.

templates/에서 가장 가까운 템플릿부터 시작하여 작업 폴더에 복사하고 복사본을 편집하세요. 미리보기는 assets/gallery/에 있습니다. 템플릿은 패턴이지 콘텐츠가 아닙니다: 모든 텍스트를 바꾸고 줄 바꿈과 화살표를 소스와 정확히 동일하게 유지하세요. --expect는 누락된 부분과 변경된 문구를 잡아냅니다.

템플릿보여주는 내용
dense-rebuild.json밀집된 아키텍처 이미지 재구성: 명시적 좌표, 카드, 패널, 병합된 커넥터, 인라인 레이블
pipeline-rag.json왼쪽에서 오른쪽 파이프라인: connect, rightOf, 자동 맞춤 패널이 있는 행
layered-architecture-zh.json중국어 계층형 아키텍처: 쌓인 below 행, 팬인 화살표, 실린더
flowchart-decision.json순서도: 알약, 다이아몬드, 예/아니오 분기, 루프백 화살표
agent-loop.json사이클: 곡선 화살표, 배지, 타원 허브
auto-layout.json좌표 없음: ELK 자동 레이아웃 및 그룹

2. 루프 (모든 작업)

  1. 먼저 목록을 작성하세요. 모든 텍스트 문자열을 그대로 나열하고(texts.txt에 한 줄에 하나씩 저장), 모든 노드, 모든 화살표(from → to, 레이블) 및 모든 그룹을 나열하세요. 어떤 것도 새로 만들거나 버리지 마세요.

  2. 템플릿에서 시작하여 name.json을 작성하세요.

  3. 렌더링: node SKILL_DIR/scripts/render.mjs name.json --out OUT --expect texts.txt

  4. 모든 ERROR를 수정하세요. 각 오류에는 구체적인 → 수정 사항이 함께 제공됩니다. 의도하지 않은 WARN은 수정하고, 의도된 WARN은 해당 요소 또는 화살표에 "ignore": ["code"]를 사용하여 무음 처리하세요.

  5. OUT/name.png 및 OUT/name.tiles/*.png를 확인하고 원본과 비교하세요(scripts/compare.mjs 사용). prompts/visual-review.md의 체크리스트를 실행하세요. 린터는 의미, 균형 또는 충실도를 판단할 수 없습니다.

  6. 오류가 0개가 되고 내용이 잘 읽힐 때까지 35단계를 반복하세요(보통 24회).

  7. 전달:

    • name.png: 2x; 인쇄용으로는 --scale 3을 사용하세요.
    • name.svg: 벡터.
    • name.json: 추후 편집을 위해 보관.

    유지한 항목과 개선한 항목을 한 줄로 추가하세요.

3. 60초 스펙

{
  "canvas": { "width": 1600 },
  "style": "marker",
  "title": "Checkout Service",
  "subtitle": "{blue:clients} · {purple:services} · {green:data}",
  "elements": [
    { "id": "web", "title": "Web app", "icon": "app-window", "x": 120, "y": 220 },
    { "id": "api", "title": "API", "color": "purple", "emphasis": true, "rightOf": "web", "gap": 160,
      "lines": ["`POST /checkout`", { "text": "validates cart", "muted": true }] },
    { "id": "db", "type": "cylinder", "title": "Orders DB", "color": "green", "below": "api", "gap": 120 },
    { "id": "core", "type": "panel", "title": "Backend", "color": "purple", "contains": ["api", "db"] },
    { "id": "n1", "type": "note", "text": "Idempotent by **order id**", "rightOf": "core", "gap": 40 }
  ],
  "arrows": [
    { "from": "web", "to": "api", "label": "HTTPS" },
    { "from": "api", "to": "db", "label": "INSERT", "color": "green" }
  ]
}
  • 요소 유형: box (기본값), pill, ellipse, circle, diamond, cylinder, note, card, panel, text, icon, badge, image, path (사용자 정의 SVG 모양) 및 레이아웃 도우미 row, column, group.

  • 각 요소 위치 지정은 다음 중 하나를 사용합니다:

    • 왼쪽 위 모서리의 경우 x/y, 또는 중심의 경우 cx/cy.
    • below / above / rightOf / leftOf + gap.
    • contains는 자식 주위에 패널을 자동으로 맞춥니다.

    크기는 자동입니다. 원본과 정확히 일치시키려면 w/h를 설정하세요.

  • 텍스트: title은 굵게 표시되며 \n은 줄을 바꿉니다. lines는 본문 줄입니다. 텍스트 내 마크업:

    • **bold**
    • `code` (코드 폰트 사용)
    • {green:span} 및 {muted:span}
    • -> (화살표 글리프로 그려짐)

    중국어와 영어가 자유롭게 혼합됩니다. 요소별로 size, textSize, font, textColor 및 align을 설정할 수 있습니다.

  • 색상은 계열(blue purple green orange red teal yellow pink gray navy), 음영(blue.tint), #hex 또는 일반 CSS 이름(예: white)을 color, fill, stroke 및 textColor를 통해 설정합니다.

  • 화살표는 from을 to에 연결합니다:

    • 측면에 고정하고 "id.right" 또는 "id.right+20"으로 슬라이드합니다.
    • 레이블: label, labelPos (above, below, left, right 또는 inline)로 배치하고 labelAt으로 조정합니다.
    • 모양: dash, color, width 및 head (end, start, both 또는 none).
    • 경로: via 포인트, points (정확한 폴리라인) 또는 "route": "curve".

모든 키는 references/spec.md에 있습니다.

4. 모양: 스타일, 팔레트, 폰트, 효과

  • 스타일 프리셋:

    • 손글씨: marker (기본값), neat, excalidraw, sketchy, whiteboard, pencil, blueprint, chalk.
    • 깔끔함: clean, paper.

    styleOverrides를 통해 모든 프리셋 필드를 재정의할 수 있습니다:

    • roughness (0 = 완벽하게 직선) 및 bowing
    • fillStyle (solid, hachure, cross-hatch, dots 또는 none)
    • strokeScale, cornerRadius
    • shadow (none, soft 또는 hard)
    • font, cjkFont, codeFont, background
  • 팔레트: marker, pastel, excalidraw, mono, academic, colorblind, modern, blueprint, chalkboard, midnight. 원본의 색상을 정확히 재현하려면 node SKILL_DIR/scripts/palette.mjs original.png을 실행하고 결과를 붙여넣으세요.

  • 폰트:

    • 손글씨: shantell, kalam, caveat, patrick, architects.
    • 산세리프: inter. 세리프: serif. 모노: mono.
    • CJK: kai (손글씨), kuaile (장난기 있는), sans-sc (깔끔함).
    • 사용자 .ttf/.otf/.woff: "fonts": {"brand": {"regular": "Brand.ttf", "bold": "Brand-Bold.ttf"}}, 그 다음 "font": "brand".
  • 카탈로그: assets/gallery/styles.png, palettes.png 및 fonts.png. scripts/catalog.mjs로 다시 생성하세요.

  • 아이콘: 1,500개 이상의 Lucide 아이콘. node SKILL_DIR/scripts/icons.mjs search 数据库 robot queue로 검색하고 icons.mjs sheet a,b,c로 미리보기.

  • 원본 이미지 도구:

    • grid.mjs: 원본에 좌표 오버레이. 빨간색 축 레이블을 읽고, 픽셀 위치는 읽지 마세요.
    • fontmatch.mjs: 원본의 확대된 부분 옆에 모든 폰트로 샘플 텍스트를 표시합니다.
    • palette.mjs: 원본의 색상을 추출합니다.
    • crop.mjs: 로고, 사진 또는 스크린샷을 잘라서 image 요소로 포함시킵니다.
    • compare.mjs: 나란히 비교 검토합니다. 두 이미지를 동일한 영역으로 확대하려면 --crop x,y,w,h를 추가하세요.
  • 어두운 테마 또는 대체 버전: 동일한 스펙을 유지하고 palette (midnight, blueprint 또는 chalkboard) 또는 style만 변경한 다음 다른 --name으로 렌더링하세요.

  • 슬라이드용 (PPT, Keynote): "canvas": {"aspect": "16:9"}는 이미지를 슬라이드 비율로 패딩합니다. "background": "transparent"는 알파 채널이 있는 PNG를 제공합니다. SVG도 직접 붙여넣을 수 있습니다.

5. 명확성 규칙 (항상 적용)

  1. 단어를 정확히 유지하세요: 레이블, 코드 식별자 및 중국어 용어. 요청하지 않는 한 텍스트를 만들거나, 번역하거나, 삭제하지 마세요.
  2. 계층 구조를 보이게 만드세요:
    • 상자당 굵은 제목.
    • 식별자는 본문 또는 code 텍스트로.
    • 설명은 muted 텍스트로.
    • 섹션 제목은 해당 섹션의 색상으로.
  3. 색상은 의미가 있습니다: 영역 또는 역할당 하나의 계열, 일관되게 사용됨. 화살표 레이블은 화살표의 색상을 상속합니다.
  4. 숨 쉴 공간:
    • 레이블이 있는 화살표로 연결된 도형 사이 ≥ 60px, 그 외에는 ≥ 24px.
    • contains로 패널 맞춤.
    • 경계선 위에 레이블 없음.
  5. 축소 시 읽기 가능:
    • 텍스트 ≥ 18px (기본값: 노드 30, 본문 25, 레이블 24).
    • 캔버스 너비 1400–2200px, 종횡비 1:2에서 3:1 사이. 린터가 그렇지 않으면 경고합니다.
    • 6개 이상의 노드로 구성된 긴 체인: 2-3줄로 구부리거나 ELK "direction": "DOWN"을 사용하여 매우 긴 단일 행을 피하세요.
  6. 교차점이 적고 우회로가 없습니다. via를 추가하기 전에 정렬하고 재정렬하세요.
  7. 재구축 작업에서는 재설계하지 말고 다듬으세요: 정렬, 간격 및 계층 구조를 개선하지만 토폴로지, 읽기 순서 및 스타일 정체성은 유지하세요.

6. 완료 조건

  • render.mjs가 0개의 오류를 보고합니다. 남아 있는 경고는 의도된 것이며 ignore로 무음 처리됩니다.
  • 모든 목록 문자열이 존재하고 정확히 철자되었습니다(--expect texts.txt 통과).
  • PNG와 타일을 보았으며, 재구축의 경우 원본과 나란히 비교했습니다: 동일한 구조, 동일한 스타일 정체성, 더 선명함.
  • PNG, SVG 및 JSON을 짧은 "유지 / 개선" 노트와 함께 전달했습니다.

7. 문제 해결

  • node: command not found: Node 18+를 설치하세요. 다른 것은 필요하지 않습니다.
  • WebP, HEIC, BMP 또는 TIFF 입력은 sips, magick, dwebp, ffmpeg 또는 Python PIL을 사용할 수 있을 때 자동으로 변환됩니다. 그렇지 않으면 사용자에게 PNG 또는 JPEG를 요청하세요.
  • 문자가 ?로 렌더링됨: 번들 폰트는 라틴 문자, GB2312 중국어 및 공통 기호를 다룹니다. 문구를 바꾸거나 해당 문자가 있는 폰트를 등록하세요.
  • 모든 린트 코드 및 수정 사항은 references/troubleshooting.md를 참조하세요.

관련 스킬