Community이미지github.com

SVG 손그림 스타일 플로우차트 제작자

사용자의 설명을 바탕으로 손으로 그린 듯한 스타일의 SVG 플로우차트와 다이어그램을 만듭니다. 화면 비율(16:9, 4:3, 1:1, A4 또는 사용자 정의 W:H 비율)을 지원합니다.

SVG 손그림 스타일 플로우차트 제작자란 무엇인가요?

이 스킬은 사용자가 자연어로 설명한 업무 프로세스, 시스템 아키텍처, 순서도 등을 고유한 '손그림' 스타일의 SVG 파일로 변환합니다. 일반적인 딱딱한 기업용 다이어그램과 달리, 흔들리는 테두리, 해칭 채우기, 손글씨 폰트를 특징으로 하여 화이트보드에 색색의 마커로 스케치한 듯한 따뜻하고 친근한 시각적 결과물을 제공합니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있습니다. 이 스킬의 핵심은 크게 여섯 단계로 구성됩니다: 1) 사용자 설명을 분석하여 개별 모듈/단계/행위자로 분해, 2) 지정된 화면 비율에 따라 캔버스 방향 설정(기본값 16:9), 3) 레이아웃 계획(가로형에는 좌→우 흐름, 세로형에는 상→하 흐름), 4) feTurbulence 및 feDisplacementMap SVG 필터를 사용하여 손그림 효과를 적용하여 SVG 생성, 5) 모든 연결에 화살표가 있고 필터 오염으로 인해 화살표가 사라지지 않았는지 자체 검증, 6) 사용자에게 파일 경로를 제공하고 피드백 기반으로 반복 개선합니다. 손그림 미학을 보장하기 위해 특정 Google Fonts(Ma Shan Zheng, ZCOOL KuaiLe)와 Comic Sans MS(영문)를 엄격히 사용합니다. 가장 중요한 주의사항은 화살표 및 연결선에 절대 SVG 필터를 적용하지 말라는 것입니다. 이로 인해 얇은 선이 보이지 않게 될 수 있습니다. 또한 각 다이어그램의 방대한 비율과 복잡성을 고려하여 출력된 SVG를 rsvg-convert를 사용하여 PNG로 변환한 후 시각적으로 검사하여 레이아웃, 텍스트 및 화살표 문제를 찾아내고 수정합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/retrocognition023/my-agent-skills/tree/HEAD/skills/svg-creator

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

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

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

문서

SVG 손그림 스타일 플로우차트 제작자은(는) 무엇을 하나요?

당신은 프로세스, 시스템 또는 워크플로우에 대한 말하기/쓰기 설명을 아름다운 손그림 스타일 SVG 플로우차트로 바꿉니다. 출력물은 누군가가 색색의 마커로 화이트보드에 스케치한 것처럼 보여야 합니다 — 딱딱한 기업용 다이어그램이 아닙니다.

화면 비율

모든 SVG는 정의된 화면 비율을 가져야 합니다. 사용자가 명시적으로 지정할 수 있으며, 기본값은 16:9 (프레젠테이션 친화적)입니다. 화면 비율은 <svg> 요소의 viewBox 및 width/height 속성을 결정합니다.

사전 설정

이름비율일반적인 viewBox최적 용도
16:916:90 0 1600 900슬라이드, 프레젠테이션, 와이드스크린 디스플레이
4:34:30 0 1200 900전통적인 슬라이드, 문서화
1:11:10 0 1000 1000소셜 미디어, 정사각형 썸네일
A4~1:1.4140 0 1000 1414인쇄 가능한 문서, 세로 포스터
A4-가로~1.414:10 0 1414 1000인쇄 가능한 가로 문서

사용자 정의 비율

사용자는 W:H 형식(예: 3:2, 21:9)으로 모든 비율을 지정할 수 있습니다. 긴 쪽이 ~1400-1600px이 되고 짧은 쪽은 비율을 따르도록 스케일링하여 viewBox를 계산합니다.

화면 비율이 레이아웃에 미치는 영향

  • 넓은 형식 (16:9, 21:9): 왼쪽에서 오른쪽 흐름을 선호합니다. 더 많은 가로 공간으로 한 줄에 4-6개의 요소를 편안하게 배치할 수 있습니다. 수직으로 쌓으면 공간이 낭비됩니다.
  • 긴 형식 (A4, 9:16): 위에서 아래로 흐름을 선호합니다. 수직 공간을 최대한 활용하고, 가로 요소는 한 줄에 2-3개로 제한합니다.
  • 정사각형 (1:1): 균형 잡힘 — 방사형 레이아웃과 2×2/3×3 그리드 모두에 적합합니다. 강한 방향 흐름이 없는 개념 지도에 좋습니다.
  • 4:3: 좋은 중간 지점입니다. 두 방향 모두 작동하지만 가로 방향을 약간 선호합니다.

2단계에서 레이아웃을 계획할 때 항상 먼저 화면 비율을 확인하고 사용 가능한 공간을 자연스럽게 활용하는 레이아웃 방향을 선택하십시오. 왼쪽에서 오른쪽 흐름을 긴 캔버스에 강제로 넣거나 위에서 아래로 흐름을 와이드스크린 캔버스에 강제로 넣지 마십시오.

기본 동작

사용자가 비율을 지정하지 않으면 16:9를 사용하십시오. 대부분의 다이어그램에 잘 작동하며 프레젠테이션에서 즉시 사용할 수 있습니다. 콘텐츠가 분명히 다른 비율을 필요로 하는 경우 (예: 매우 긴 계층 구조), 변경을 제안하되 자동으로 재정의하지는 마십시오.

전체 워크플로우

  1. 이해 및 분해 — 사용자의 설명을 개별 모듈/단계/행위자로 분석합니다
  2. 화면 비율 결정 — 사용자가 지정한 비율을 사용하거나 기본값 16:9를 사용합니다
  3. 레이아웃 계획 — 시각적 구조를 결정하고 화면 비율에 맞게 조정합니다
  4. SVG 생성 — 손그림 스타일과 올바른 viewBox로 깨끗한 SVG를 작성합니다
  5. 화살표 확인 — 노드 간의 모든 연결에 보이는 화살표가 있는지 자체 점검합니다
  6. 출력 및 반복 — 사용자에게 파일 경로를 제공하고 피드백에 따라 개선합니다

1단계: 이해 및 분해

사용자가 프로세스를 설명하면 다음을 추출합니다:

  • 행위자/역할 — 참여자는 누구입니까? (예: "PM", "시스템", "사용자")
  • 단계/단계 그룹 — 주요 그룹화는 무엇입니까? (예: "입력 단계", "처리 단계")
  • 단계들 — 각 단계 내의 개별 작업은 무엇입니까?
  • 연결 — 흐름은 어떻게 됩니까? 순차적입니까? 분기합니까? 피드백 루프입니까?

설명이 모호한 경우, 그리기 전에 명확한 질문을 하십시오.

2단계: 레이아웃 계획

프로세스 구조와 일치하는 레이아웃을 선택하십시오:

  • 위에서 아래로: 간단한 순차적 흐름
  • 왼쪽에서 오른쪽 섹션: 서로 핸드오프하는 뚜렷한 단계가 있을 때
  • 그룹화된 상자: 행위자가 다른 단계 세트를 소유할 때
  • 피드백 루프: 외부를 감싸는 점선 화살표 사용

SVG 좌표를 작성하기 전에 대략적인 경계 상자를 정신적으로 스케치하십시오:

  • 각 섹션에 충분한 공간을 제공합니다(일반적으로 주요 그룹당 400×500px)
  • 화살표를 위해 요소 사이에 40-60px 간격을 남깁니다
  • 30-50px 여백으로 모든 것을 수용하는 캔버스 크기를 계획합니다

3단계: SVG 생성 — 핵심 기술

3.1 손그림 효과: feTurbulence + feDisplacementMap 조합

이것이 스케치 같은 느낌의 핵심입니다. Perlin 노이즈를 사용하여 픽셀을 변위시켜 직선과 날카로운 모서리를 손으로 그린 것처럼 보이게 만듭니다.

<defs>
  <!-- 도형(상자, 타원, 큰 컨테이너)용 — 적당한 흔들림 -->
  <filter id="sketchy" x="-3%" y="-3%" width="106%" height="106%">
    <feTurbulence type="turbulence" baseFrequency="0.03" numOctaves="4" seed="2" result="turbulence"/>
    <feDisplacementMap in="SourceGraphic" in2="turbulence" scale="2.5"
                       xChannelSelector="R" yChannelSelector="G"/>
  </filter>
</defs>

중요: 화살표/연결선에는 어떤 필터도 적용하지 마십시오. feDisplacementMap 필터는 낮은 스케일에서도 대부분의 SVG 렌더러에서 얇은 선을 보이지 않거나 조각나게 만듭니다. 화살표는 필터 속성 없이 그려야 합니다. 화살표의 손그림 느낌은 stroke-width="3" 또는 더 두꺼운 것을 사용함으로써 얻을 수 있으며, 이는 필터링된 도형 옆에서 이미 충분히 유기적으로 보입니다.

3.2 해칭 채우기 패턴

대각선 패턴은 손으로 그린 크로스해칭을 시뮬레이션합니다:

<pattern id="hatch-blue" width="8" height="8" patternUnits="userSpaceOnUse"
         patternTransform="rotate(-45)">
  <line x1="0" y1="0" x2="0" y2="8" stroke="#a0c4f0" stroke-width="1.5" opacity="0.5"/>
</pattern>

가독성을 위해 해치 패턴을 반투명 단색 채우기와 레이어로 결합합니다:

<!-- 해칭 레이어 -->
<rect ... fill="url(#hatch-blue)" stroke="#3b82d0" stroke-width="3.5" filter="url(#sketchy)"/>
<!-- 가독성 오버레이 -->
<rect ... fill="#dbeafe" opacity="0.25"/>

다이어그램에 사용된 색상 테마당 하나의 해치 패턴을 만듭니다.

3.3 손글씨 폰트 — 정확히 이것들을 사용하고 대체하지 마십시오

폰트는 모든 다이어그램에서 일관되어야 합니다. 이 정확한 <style> 블록을 사용하십시오 — Caveat, Patrick Hand 또는 다른 폰트를 사용하지 마십시오. 이것은 엄격한 요구 사항입니다.

중국어 텍스트가 포함된 다이어그램:

<style>
  @import url('https://fonts.googleapis.com/css2?family=Ma+Shan+Zheng&amp;family=ZCOOL+KuaiLe&amp;display=swap');
  /* 중국어 텍스트 — Ma Shan Zheng 붓글씨 스타일 폰트 */
  text {
    font-family: 'Ma Shan Zheng', 'ZCOOL KuaiLe', 'STKaiti', 'KaiTi', cursive;
  }
  /* 영어 레이블 (코드 이름, /task-add, Backlog, YAML 같은 기술 용어) */
  .label-en {
    font-family: 'Comic Sans MS', 'Segoe Print', 'Bradley Hand', cursive, sans-serif;
  }
</style>

전적으로 영어로 된 다이어그램:

<style>
  @import url('https://fonts.googleapis.com/css2?family=Ma+Shan+Zheng&amp;display=swap');
  text {
    font-family: 'Comic Sans MS', 'Segoe Print', 'Bradley Hand', cursive, sans-serif;
  }
</style>

중국어 다이어그램의 영어 텍스트 요소에 class="label-en"을 적용하십시오. Caveat, Patrick Hand, Indie Flower 또는 다른 손글씨 폰트를 절대 사용하지 마십시오 — 중국어는 Ma Shan Zheng, 영어는 Comic Sans MS를 고수하십시오.

3.4 화살표 마커

각 섹션의 테마와 일치하는 색상 화살표 마커를 정의합니다:

<marker id="arrow-blue" viewBox="0 0 12 12" refX="10" refY="6"
        markerWidth="10" markerHeight="10" orient="auto-start-reverse">
  <path d="M 2 3 L 10 6 L 2 9 Z" fill="#3b82d0"/>
</marker>

연결선에 marker-end="url(#arrow-blue)"를 사용하십시오. 점선 연결(간접적/선택적 흐름 표시)의 경우 stroke-dasharray="14 10"를 추가하십시오.

3.5 도형 어휘

개념SVG 도형예
행위자/역할<ellipse>PM, 사용자, 시스템
프로세스 단계<rect rx="6">/task-add, 빌드 단계
컨테이너/단계<rect rx="20"> 크고 해칭 포함"1. 요구사항 입력" 섹션
데이터/출력<path> 평행사변형Backlog, 보고서
결정<path> 다이아몬드예/아니오 분기
외부 경계stroke-dasharray가 있는 <rect>시스템 경계, 피드백 루프

3.6 색상 테마

각 주요 섹션/행위자는 고유한 색상을 가져야 합니다. 좋은 팔레트:

  • 파란색: stroke="#3b82d0", fill="#dbeafe", text="#1e40af", hatch="#a0c4f0"
  • 주황색/노란색: stroke="#d4920a", fill="#fef3c7", text="#92400e", hatch="#f0d080"
  • 녹색: stroke="#2d8a4e", fill="#d1fae5", text="#065f46", hatch="#5a9e6f"
  • 보라색: stroke="#7c3aed", fill="#ede9fe", text="#5b21b6", hatch="#b4a0e8"
  • 회색 (점선 연결자용): stroke="#777"

3.7 연결 요소 — 화살표에 필터 금지

이것이 가장 중요한 섹션입니다. 끊어지거나 사라지는 화살표는 전체 다이어그램을 망칩니다.

규칙:

  1. 모든 화살표 <line> 또는 <path> 연결자는 stroke-width="3" 이상이어야 합니다
  2. 모든 화살표는 marker-end="url(#arrow-xxx)" 속성이 있어야 합니다
  3. 어떤 화살표에도 filter="url(#sketchy)" 또는 filter="url(#sketchy-line)"을 추가하지 마십시오 — 필터는 얇은 선을 보이지 않게 만듭니다
  4. 화살표 끝이 명확히 보이도록 도형 가장자리와 화살표 시작/끝 지점 사이에 5-10px 간격을 둡니다
  5. L자형 화살표는 대상의 중심 축에서 끝나야 합니다 — 대상 도형이 x=600에 중앙에 있다면 화살표의 마지막 세그먼트는 x=600에서 끝나야 하며, 오프셋에서 끝나서는 안 됩니다. 대상 중심 좌표는 타원의 경우 cx/cy, 직사각형의 경우 x + width/2, y에서 계산합니다
  6. 화살표 레이블은 화살표 선과 겹쳐서는 안 됩니다 — 레이블을 화살표 경로 위 또는 아래 15-20px에 배치하고, 수평 화살표와 같은 y좌표 또는 수직 화살표와 같은 x좌표에 절대 배치하지 마십시오
<!-- 실선 화살표 (직접 흐름) — 필터 속성 없음 -->
<line x1="260" y1="390" x2="260" y2="425"
      stroke="#3b82d0" stroke-width="3"
      marker-end="url(#arrow-blue)"/>

<!-- 점선 화살표 (간접/선택적 흐름) — 필터 속성 없음 -->
<line x1="460" y1="440" x2="590" y2="440"
      stroke="#777" stroke-width="3" stroke-dasharray="14 10"
      marker-end="url(#arrow-gray)"/>

<!-- L자형 또는 곡선 경로 — 필터 속성 없음 -->
<path d="M 40 700 L 40 50 L 100 50" fill="none"
      stroke="#2d8a4e" stroke-width="4" stroke-dasharray="16 10"
      marker-end="url(#arrow-green)"/>

4단계: 화살표 확인 (자체 점검)

SVG를 작성한 후 파일을 저장하기 전에 모든 연결을 확인해야 합니다. 이 단계는 가장 일반적이고 가장 치명적인 결함인 누락된 화살표를 잡아냅니다.

절차:

  1. 모든 연결 나열: 1단계의 분해로 돌아가서 존재해야 하는 모든 화살표를 열거합니다. 체크리스트로 작성하십시오:

    연결 체크리스트:
    - [ ] 노드 A → 노드 B (주문)
    - [ ] 노드 B → 노드 C (주문 처리)
    - [ ] 노드 C → 노드 D (결제 성공)
    ...
    
  2. 각 연결에 대해 SVG에서 확인합니다: 소스 노드의 하단/오른쪽 가장자리에서 대상 노드의 상단/왼쪽 가장자리로 가는 좌표를 가진 <line> 또는 <path> 요소가 있고, marker-end 속성이 있는지 확인합니다.

  3. 필터 오염 확인: filter=를 포함하는 <line 또는 연결자 <path를 SVG에서 검색합니다. 발견되면 해당 요소에서 필터 속성을 제거하십시오.

  4. 좌표 정합성 확인: 각 화살표에 대해 다음을 확인합니다:

    • 시작점(x1,y1)이 소스 도형의 하단/오른쪽 가장자리 근처에 있습니다
    • 끝점(x2,y2)이 대상 도형의 상단/왼쪽 가장자리 근처에 있습니다
    • L자형 경로의 경우, 마지막 세그먼트는 대상 도형의 중심 x 또는 y에서 끝나야 합니다
    • 시작점과 끝점이 다릅니다(길이가 0인 선이 아님)
  5. 레이블 배치 확인: 각 화살표 레이블 텍스트 요소에 대해 다음을 확인합니다:

    • 수평 화살표의 경우 레이블 y가 화살표의 y좌표보다 최소 15px 위 또는 아래에 있습니다
    • 수직 화살표의 경우 레이블 x가 화살표의 x좌표보다 최소 15px 왼쪽 또는 오른쪽에 있습니다
    • 레이블이 어떤 도형 상자와도 겹치지 않습니다

연결이 누락된 경우 저장하기 전에 추가하십시오.

5단계: 출력 및 반복

  1. 쓰기 전에 기존 파일 확인: 저장하기 전에 대상 파일이 이미 존재하는지 확인하십시오. 존재하는 경우 덮어쓰기를 피하기 위해 버전 접미사를 추가하십시오:

    • 첫 번째 파일: flowchart.svg
    • flowchart.svg가 존재하는 경우: flowchart-v1.svg로 저장
    • flowchart-v1.svg도 존재하는 경우: flowchart-v2.svg로 저장
    • 사용되지 않는 파일 이름을 찾을 때까지 계속 증가시킴
    • 쓰기 전에 ls 또는 test -f를 사용하여 존재 여부 확인
  2. 결정된 파일 경로에 SVG 작성

  3. SVG를 PNG로 변환하고 시각적으로 자체 점검: 아직 사용자를 위해 파일을 열지 마십시오. 대신 먼저 변환하고 결과를 검사하십시오:

    rsvg-convert input.svg -o output.png
    

    그런 다음 Read 도구를 사용하여 생성된 PNG 이미지를 봅니다. 다음을 주의 깊게 검사하십시오:

    • 레이아웃 문제: 요소가 겹칩니까? 텍스트가 컨테이너에서 잘리거나 넘칩니까? 큰 빈 간격이나 비좁은 영역이 있습니까?
    • 화살표 문제: 모든 화살표가 보입니까? 어떤 화살표가 잘못된 방향을 가리키거나, 도형을 가로지르거나, 끊어져 보입니까?
    • 텍스트 가독성: 텍스트를 읽을 수 있고 다른 요소와 겹치지 않습니까?
    • 전체적인 균형: 다이어그램이 캔버스 내에서 비율이 잘 맞아 보입니까?

    문제가 발견되면 SVG로 돌아가서 수정하고, 다시 변환하고, 다시 검사하십시오. 다이어그램이 시각적 검사를 통과할 때까지 반복하십시오.

  4. 다이어그램이 검사를 통과하면 사용자에게 SVG 및 PNG 파일이 준비되었음을 알리고 파일 경로를 제공하십시오. open을 사용하지 마십시오 — 사용자가 원격 서버에 있을 수 있습니다.

  5. 피드백에 대비하십시오 — 일반적인 요청 사항:

    • "이 상자가 너무 작아요" → 크기를 늘리고 위치를 재조정합니다
    • "화살표가 끊어졌어요" → 화살표에서 필터를 제거하고, stroke-width를 늘립니다
    • "폰트가 손글씨 같지 않아요" → Google Fonts 임포트를 확인하고, 정확한 font-family 문자열을 확인합니다
    • "색상이 너무 연하거나/진해요" → 불투명도와 선 색상을 조정합니다
    • 레이아웃 재배열 → 좌표를 다시 계산합니다

일반적인 함정

  • 화살표 사라짐: #1 문제. 절대 <line> 또는 화살표 <path>에 filter를 적용하지 마십시오. 변위 필터는 얇은 요소를 보이지 않게 만듭니다. 도형(<rect>, <ellipse>, 컨테이너 <path>)만 필터를 가져야 합니다.
  • 폰트 불일치: 중국어에는 항상 Ma Shan Zheng, 영어에는 Comic Sans MS를 사용하십시오. Caveat, Patrick Hand, Indie Flower 등으로 대체하지 마십시오.
  • 텍스트가 손글씨처럼 보이지 않음: Google Fonts @import는 인터넷 연결이 필요합니다...

관련 스킬