Communitygithub.com

Flowy, AI-네이티브 다이어그램 스킬

플로우차트, 시스템 다이어그램, UI 와이어프레임/목업을 위한 Flowy HTML 파일을 생성, 읽기, 업데이트합니다. 사용자가 흐름을 다이어그램으로 그리거나, 아키텍처를 시각화하거나, UI를 스케치하거나, 기능을 시각적으로 계획하거나, 와이어프레임을 만들거나, 프로세스를 매핑하거나, HTML 다이어그램을 만들거나 'flowy'를 언급할 때 이 스킬을 사용하세요. 또한 사용자가 `docs/diagrams/` 디렉토리에 있는 기존 `.html` 다이어그램 파일을 참조하거나 다이어그램 업데이트/수정을 요청할 때도 사용하세요.

Flowy, AI-네이티브 다이어그램 스킬란 무엇인가요?

Flowy는 AI 에이전트(Claude Code, Cursor, Codex 등)를 위해 설계된 다이어그램 생성 스킬로, 자체 완결형 HTML 파일을 생성합니다. 각 파일은 CSS, JavaScript, 다이어그램 데이터를 포함하여 단일 HTML 파일로 제공되며, 별도의 의존성 없이 브라우저에서 바로 열어볼 수 있습니다. 이 스킬은 플로우차트, 시스템 아키텍처 다이어그램, UI 와이어프레임 및 목업을 지원하며, 사용자의 자연어 요청을 분석하여 노드와 엣지를 배치하고 표준 색상 팔레트를 적용합니다. 템플릿 기반으로 동작하여 `meta`, `nodes`, `edges`로 구성된 JSON 구조를 사용하며, 생성된 HTML 파일은 `docs/diagrams/` 디렉토리에 저장됩니다. 파일 이름은 케밥-케이스(kebab-case) 규칙을 따릅니다. 기존 다이어그램을 읽고 수정할 때는 HTML 파일에서 `DIAGRAM` 객체를 추출하여 변경하고, 최신 템플릿으로 다시 렌더링합니다. 이 스킬은 오프라인에서도 동작하며, npm이나 CDN 없이 순수 HTML5, CSS3, SVG, 바닐라 ES6+ 자바스크립트만 사용합니다.

지원 대상✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/vandezand-ctrl/workflow-automation-skills/tree/HEAD/skills/flowy

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

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

문서

Flowy, AI-네이티브 다이어그램 스킬은(는) 무엇을 하나요?

Flowy는 자체 완결형 HTML 파일을 생성하여 대화형 SVG 다이어그램을 렌더링합니다. 각 파일은 CSS, JavaScript, 다이어그램 데이터를 내장하며, 의존성이 전혀 없어 더블 클릭만으로 모든 브라우저에서 열 수 있습니다.

파일 위치

  • 다이어그램: docs/diagrams/*.html (예: docs/diagrams/upload-flow.html). 폴더는 첫 사용 시 생성하며, 없을 수도 있습니다. 프로젝트에 이미 다이어그램을 보관하는 다른 위치가 있다면 해당 프로젝트의 규칙을 따르세요.
  • HTML 템플릿: ${CLAUDE_SKILL_DIR}/references/html-template.html, 표준 렌더러이며, 이 스킬이 제공하는 유일한 참조 파일입니다. 이 경로는 플러그인, 개인 또는 프로젝트로 설치된 위치에 관계없이 이 스킬의 자체 폴더로 해석되므로 현재 프로젝트에 의존하지 않습니다.

스키마 파일, 예제 폴더, 비주얼 편집기는 의도적으로 없습니다. 이전 버전의 이 스킬은 flowy/schema.ts, flowy/examples/, flowy/editor.html 및 디스크의 Flowy 소스 저장소를 가리켰습니다. 이들은 모두 존재하지 않으며, 경로가 오래되어 따라가면 시간만 낭비했습니다. 위의 HTML 템플릿이 구조의 진실 공급원(source of truth)입니다. 다이어그램을 작성하기 전에 반드시 읽어보세요.

사전 점검

Flowy 다이어그램을 생성하거나 편집하기 전에:

  1. ${CLAUDE_SKILL_DIR}/references/html-template.html을 읽어 최신 렌더러 코드를 확인하세요.
  2. docs/diagrams/에 있는 기존 다이어그램을 나열하여 이름 충돌을 방지하세요.
  3. 기존 다이어그램을 업데이트하는 경우 먼저 읽고 DIAGRAM 객체를 추출하세요.

스키마

모든 다이어그램은 세 가지 필드를 가진 JavaScript 객체입니다:

{
  meta: { title, description, type, tags[], created, updated },
  nodes: [...],
  edges: [...]
}

meta

필드타입필수설명
titlestring예사람이 읽을 수 있는 제목
descriptionstring아니요다이어그램이 보여주는 내용
typestring예"flowchart" 또는 "ui-mockup"
tagsstring[]아니요조직화를 위한 태그
createdstring아니요ISO 날짜 (YYYY-MM-DD)
updatedstring아니요ISO 날짜, 생성/업데이트 시 오늘 날짜로 설정

nodes

필드타입필수설명
idstring예고유, snake_case (예: "step1_upload")
typestring예"box", "circle", "diamond", "note", "group"
labelstring예도형에 표시되는 주요 텍스트
sublabelstring아니요호버 툴팁에 표시되는 보조 텍스트
position{ x, y }예픽셀 단위의 왼쪽 상단 모서리
size{ width, height }예픽셀 단위의 크기
styleobject아니요아래 노드 스타일 필드 참조
groupstring아니요부모 그룹 노드의 id (시각적 그룹화 전용)

노드 스타일 필드: fill, stroke, strokeWidth, color (텍스트), fontSize, borderRadius, opacity

edges

필드타입필수설명
idstring예고유 (예: "e_upload_to_extract")
sourcestring예소스 노드 id
targetstring예타겟 노드 id
labelstring아니요화살표 위 텍스트 (예: "yes", "error")
sourceHandlestring아니요"top", "right", "bottom" (기본값), "left"
targetHandlestring아니요"top" (기본값), "right", "bottom", "left"
styleobject아니요아래 엣지 스타일 필드 참조

엣지 스타일 필드: stroke, strokeWidth, strokeDasharray, markerEnd

노드 렌더링 규칙

타입SVG 요소설명
box<rect>borderRadius의 rx/ry를 통한 둥근 모서리. 기본값: 8px
circle<ellipse>cx = x + width/2, cy = y + height/2, rx = width/2, ry = height/2
diamond<polygon>4개 점: 상단-중앙, 오른쪽-중앙, 하단-중앙, 왼쪽-중앙
note<path>오른쪽 상단 구석이 접힌 사각형. 접힘 크기: 12px
group<rect>점선 테두리 (stroke-dasharray: 6,3). 다른 모든 노드 뒤에 렌더링. 레이블은 왼쪽 상단. 낮은 불투명도

엣지 렌더링 규칙

  1. 소스 포인트 계산: 소스 노드의 지정된 핸들 측면 중앙 (기본값: 하단)
  2. 타겟 포인트 계산: 타겟 노드의 지정된 핸들 측면 중앙 (기본값: 상단)
  3. 핸들 방향으로 50px 오프셋된 제어점으로 3차 베지어 곡선(C 명령) 그리기
  4. SVG <marker> 정의를 사용하여 화살촉 추가
  5. strokeDasharray가 설정된 경우 점선으로 렌더링
  6. label이 있으면 베지어 곡선의 중점에 작은 흰색 배경 사각형과 함께 렌더링

레이아웃 규칙

흐름 방향

  • 플로우차트: 위에서 아래로 (기본값)
  • UI 목업: 그룹 컨테이너 내에서 위에서 아래로, 주석은 오른쪽

간격

  • 노드 중심 간 최소 70px 세로 간격
  • 평행 노드 간 최소 60px 가로 간격
  • 그룹 패딩: 그룹 경계 내부 40px

결정 다이아몬드

  • 왼쪽 분기 = 기본 / 예 경로
  • 오른쪽 분기 = 보조 / 아니오 / 오류 경로

오류/경고 노트

  • 메인 흐름의 오른쪽에 배치
  • 빨간색 점선 엣지로 연결 (strokeDasharray: "6,3", stroke: #991b1b)

표준 크기

타입너비높이
box20050
circle9040
diamond12060
note18044

색상 팔레트

용도채우기테두리텍스트
일반 액션#ffffff#2d6a4f#1f2937
주요 액션#d1fae5#065f46#065f46
결정#fef3c7#92400e#1f2937
오류#fee2e2#991b1b#991b1b
시작/종료#40916c#2d6a4f#ffffff
그룹#f5f5f2#e6e4df#374151
정보/보조#dbeafe#1e40af#1e40af
기본 엣지,#6b7280,

HTML 파일 구조

모든 Flowy HTML 파일은 다음 구조를 따릅니다. 완전한 작동 코드는 HTML 템플릿 참조 파일을 읽으세요.

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>{diagram title}</title>
  <style>
    /* 모든 CSS 인라인, 툴바, 캔버스, 툴팁, 선택 하이라이트 */
  </style>
</head>
<body>
  <div id="toolbar">
    <!-- [Fit] [-] 100% [+]   Title  badge   [Download JSON] -->
  </div>
  <div id="canvas-wrap">
    <svg id="canvas">
      <defs><!-- 화살촉 마커 --></defs>
      <g id="diagram-root"></g>
    </svg>
  </div>
  <div id="tooltip"></div>
  <script>
    const DIAGRAM = { meta: {...}, nodes: [...], edges: [...] };
    // 렌더링 + 상호작용 코드
  </script>
</body>
</html>

툴바

  • 상단에 고정, 높이 48px, 흰색 배경, 하단 테두리
  • 왼쪽: 화면에 맞춤 버튼, 축소, 확대 %, 확대
  • 중앙: 다이어그램 제목 (굵게) + 타입 배지 (회색 알약)
  • 오른쪽: JSON 다운로드 버튼 (파란색)

상호작용 (모두 바닐라 JS)

  1. 확대/축소: 마우스 휠로 SVG viewBox 크기 조절. 범위: 0.2배 ~ 5배. 커서 위치를 중심으로 확대/축소.
  2. 이동: 빈 캔버스를 클릭-드래그하여 viewBox 이동.
  3. 호버: 노드 위에 마우스를 올리면 커서 근처에 sublabel이 툴팁으로 표시됨.
  4. 클릭: 노드를 클릭하면 노드가 파란색 테두리로 강조되고 연결된 모든 엣지가 강조됨. 빈 공간을 클릭하면 선택 해제.
  5. 화면에 맞춤: 버튼이 모든 노드의 경계 상자를 계산하고 60px 패딩으로 viewBox를 설정.
  6. JSON 다운로드: DIAGRAM 객체를 포맷된 JSON으로 직렬화하고 파일 다운로드를 트리거.

새 다이어그램 만들기

사용자가 새 플로우차트 또는 UI 목업을 요청하면:

  1. 템플릿 읽기: HTML 템플릿 참조 파일을 읽어 최신 렌더러 코드를 확인
  2. 요청 분석: 노드(단계, 결정, 오류)와 엣지(연결) 식별
  3. 위치 지정: 레이아웃 규칙을 사용하여 위치 할당 (위-아래 그리드, 표준 간격)
  4. 색상 적용: 색상 팔레트를 사용하여 색상 적용 (시작/종료 = 초록, 결정 = 호박색, 오류 = 빨강 등)
  5. 완전한 HTML 파일 생성: 템플릿 구조를 복사하고 DIAGRAM 객체를 새 데이터로 교체
  6. 저장: docs/diagrams/{kebab-case-name}.html에 저장
  7. 사용자에게 알림: "브라우저에서 docs/diagrams/{name}.html을 열어 다이어그램을 확인하세요."라고 말하기

파일 이름 규칙

  • 위치: docs/diagrams/{name}.html
  • 형식: kebab-case.html (예: docs/diagrams/upload-flow.html, docs/diagrams/checkout-screen.html)
  • meta.updated를 오늘의 ISO 날짜로 설정

기존 다이어그램 업데이트

사용자가 다이어그램 수정을 요청하면:

  1. 읽기: 기존 HTML 파일 읽기
  2. 추출: <script> 블록에서 DIAGRAM 객체 추출
  3. 수정: 요청에 따라 노드/엣지 수정
  4. 업데이트: meta.updated를 오늘 날짜로 업데이트
  5. 재생성: 업데이트된 데이터로 완전한 HTML 파일 재생성 (최신 렌더러를 위해 템플릿 다시 읽기)
  6. 저장: 동일한 경로에 저장

다이어그램 읽기

다이어그램을 분석하거나 설명하라는 요청을 받으면:

  1. HTML 파일 읽기
  2. const DIAGRAM = { ... }; 블록 찾기
  3. 타입과 레이블별로 노드 나열
  4. 엣지를 추적하여 자연어로 흐름 설명
  5. 결정 지점과 해당 분기 강조

예제

"로그인 흐름에 대한 플로우차트를 만들어줘"

액션: docs/diagrams/login-flow.html을 다음으로 생성:

  • start (원, 초록) → enter_credentials (상자) → validate (다이아몬드, 호박색)
  • validate → 예/왼쪽 → dashboard (원, 초록)
  • validate → 아니오/오른쪽 → show_error (노트, 빨강) → 점선 화살표로 enter_credentials로 돌아감

"설정 목업에 다크 모드 토글을 추가해줘"

액션: docs/diagrams/settings-screen.html 읽기, DIAGRAM 추출, 테마 섹션 뒤에 레이블이 "Dark Mode"인 새 상자 노드 "section_dark_mode" 추가, meta.updated 업데이트, HTML 재생성.

"업로드 흐름의 3단계에 오류 처리를 추가해줘"

액션: HTML 읽기, 노드 배열에서 3단계 찾기, 오른쪽에 오류 노트 노드 추가, 3단계에서 오류 노트로 빨간 점선 엣지 추가, 재생성.

중요한 제약 사항

  • 의존성 제로: npm, CDN 링크, 외부 스크립트/스타일 없음
  • 오프라인 작동: 인터넷 접속 없이 렌더링 가능해야 함
  • 단일 파일: 각 다이어그램은 하나의 .html 파일
  • 브라우저 네이티브: 표준 HTML5, CSS3, SVG 및 바닐라 ES6+ JavaScript만 사용
  • LLM 친화적: DIAGRAM JSON은 압축되지 않은 깔끔한 형식이어야 함

자체 유지 관리

다이어그램을 만드는 과정에서 유용한 패턴, 새로운 레이아웃 트릭, 특정 목적에 잘 맞는 색상, 렌더링 개선 사항을 발견하면 이 스킬 파일을 업데이트하여 포함시키세요. 스킬을 정확하고 실행 가능하게 유지하세요.

관련 스킬