Communitygithub.com

Code to Figma

실행 중인 웹 앱의 화면을 기본 Figma 레이어(오토 레이아웃, 컴포넌트, 인스턴스)로 재구성하고 브라우저 스크린샷과 비교합니다. 스크린샷 가져오기나 Code 레이어가 아닌, 진정한 편집 가능한 레이어를 생성합니다. 사용자가 '이 페이지를 Figma로', '코드를 Figma로', '이 화면을 Figma에 푸시', 'UI를 Figma에서 재구성' 등을 요청할 때 사용하세요.

Code to Figma란 무엇인가요?

이 스킬은 실행 중인 웹 프론트엔드 프로젝트의 실제 브라우저 렌더링 결과를 추출하여 Figma에서 완전히 편집 가능한 Auto Layout 및 컴포넌트 구조로 재구성합니다. 단순한 스크린샷 임포트나 Figma Code 레이어가 아닌, 실제 DOM 트리에서 추출한 Auto Layout 컨테이너, 컴포넌트/인스턴스, 벡터 아이콘 등으로 이루어진 원시 레이어를 생성합니다. Vue 3 및 React(18/19, Next.js App Router 서버 컴포넌트 포함)의 컴포넌트 경계를 인식하고, 다른 프레임워크의 경우 반복 노드 탐지를 사용합니다. 주요 워크플로우는 프로젝트 실행 -> al-capture.cjs로 DOM 캡처 -> Figma 재구성 -> al-diff.py로 브라우저 스크린샷과 비교 -> audit-screens.js로 감사 순서로 진행되며, 각 화면은 하나씩 전송되어 Figma 파일 메모리 한계를 초과하지 않도록 합니다. 알려진 한계로는 Canvas/WebGL 앱 지원 불가, 테이블 숫자 폰트 드리프트, SVG mask-image 변환 제한 등이 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/byby325/code-to-figma-ui-states/tree/HEAD/skills/code-to-figma

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

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

문서

Code to Figma은(는) 무엇을 하나요?

프로젝트를 실행하고, 브라우저에서 DOM을 레이아웃 트리로 추출한 후, 편집 가능한 Auto Layout 및 컴포넌트로 Figma에서 재구성합니다.

웹 프론트엔드용입니다. 컴포넌트 경계는 Vue 3 및 React(React 18/19 테스트 완료, Next.js App Router 서버 컴포넌트 포함, 16/17은 동일한 파이버 구조이나 테스트되지 않음)용 어댑터가 있습니다. 다른 프레임워크는 반복 노드 탐지만 제공됩니다. 네이티브 앱 및 Canvas/WebGL로 완전히 그려진 화면은 지원 범위를 벗어납니다. 대신 디자인 파일이나 와이어프레임을 사용하세요.

파일내용
web-capture.md전체 프로세스, 시작 전에 읽을 것
screen-structure.md출력이 충족해야 하는 구조 규칙
scale-guard.mdMCP 호출 예산 및 파일 메모리 임계값과 중단 조건, 시작 전에 읽을 것
troubleshooting.md함정 조회 표, 결과가 잘못되었을 때 확인
examples/네 가지 프로젝트 유형(내장 목업, Playwright 픽스처, Nuxt dev, 백엔드 API 가로채기)을 위한 캡처 구성 템플릿
evals/trials.json회귀 테스트 케이스 및 기준, 도구 변경 후 모두 재실행

단계

  1. 입력 확인: 프로젝트 및 실행 방법, 대상 화면, 각 화면의 뷰포트 및 높이 유형, 대상 Figma 파일, 바인딩할 디자인 시스템. 사용자가 주제와 범위를 결정합니다. 직접 선택하지 마십시오. Figma 링크를 받으면 create_session을 실행하고 하나의 읽기 전용 use_figma를 실행하여 계정 MCP가 파일을 읽고 쓸 수 있는지 확인하십시오(파일을 열 수 없는 경우 whoami로 어떤 계정인지 설명하고 누구와 파일을 공유할지 알려주십시오). 그런 다음 scale-guard.md의 "MCP 호출 예산"에 따라 이 작업에 필요한 호출 수를 추정하십시오. 예산이 충분하지 않으면 먼저 말하십시오.
  2. 프로젝트 시작, 구성 작성, 캡처: al-capture.cjs를 실행하고 web-capture.md를 따릅니다.
  3. 먼저 기기당 하나의 대표 화면을 빌드하고 브라우저 스크린샷과 비교한 후, 일치할 때만 일괄 처리합니다.
  4. 일괄 처리 후 모든 화면 비교: al-diff.py를 실행하고, 스크린샷을 찍고 Components 섹션도 확인합니다.
  5. 감사: audit-screens.js를 실행합니다.

완료 조건: 모든 화면이 재구성되었고, 각 화면의 루트 프레임 너비가 뷰포트와 같으며, 각 기기의 대표 화면에 참조 스크린샷 레이어가 있습니다. issues가 비어 있거나 모든 항목이 원인과 함께 보고되었습니다. Components 섹션이 스크린샷에서 확인되었습니다.

Figma 쓰기 관련 엄격 규칙

Figma 파일의 메모리는 정적 사용량이 낮을 때도 순간적으로 한계를 초과할 수 있으며, 폭발한 파일은 항상 복구할 수 있는 것은 아닙니다(scale-guard.md "사고"). 모든 프로젝트에서 다음을 따르십시오.

  1. 기존 파일에 쓰기 전에 사용자에게 버전 저장을 요청하십시오. 이전에 빌드한 화면을 삭제하거나 재구축하기 전에도 포함됩니다. 사용자가 저장했다고 응답할 때까지 시작하지 마십시오. 대상 페이지에 사용자가 직접 빌드한 내용 외에는 아무것도 없는 경우(새 파일, 빈 페이지) 이 단계를 건너뛸 수 있으며, 보고서에 그렇게 명시하십시오.
  2. 한 번에 하나의 화면만 전송: 이 화면의 이미지와 데이터 SVG를 업로드하고, 빌드하고, ALDATA- 및 ALIMG- 임시 프레임이 삭제되었는지 확인한 후 다음 화면으로 진행합니다. 전체 배치를 먼저 업로드하지 마십시오.
  3. 사용자가 빨간색 경고 또는 복구 모드를 보고하면 즉시 중단하십시오. 사용자가 파일이 정상이라고 확인할 때까지 읽기 전용 use_figma조차 실행하지 마십시오.
  4. 호출 한계에 도달하면 중단: 어떤 Figma 도구가 "Figma MCP 도구 호출 한계에 도달했습니다"를 반환하면 재시도하지 말고 다른 도구로 전환하여 우회하지 마십시오. 완료된 화면 목록과 캔버스에 남아 있는 임시 프레임의 노드 ID를 나열하십시오.

알려진 한계

  • 컴포넌트 경계는 Vue 3 및 React용 어댑터가 있습니다. 둘 다 개발 모드가 필요합니다(프로덕션 빌드에는 컴포넌트 이름이 없으며, stats.json이 경고합니다). Svelte, Angular 및 기타 프레임워크는 반복 노드 탐지만 제공됩니다. 지원하려면 al-extract.js의 ADAPTERS에 항목을 추가하십시오.
  • React 컴포넌트 명명 규칙: DOM 노드는 해당 컴포넌트의 유일한 루트 노드일 때만 경계로 간주되며, 이름은 가장 바깥쪽 컴포넌트에서 가져옵니다. 자식만 전달하는 컴포넌트(Provider, Tooltip, ErrorBoundary), styled-components/emotion 스타일 컴포넌트, 라우터 및 프레임워크 내부 컴포넌트는 계산되지 않습니다. Next.js 서버 컴포넌트 이름은 React 19 개발 빌드가 필요합니다(Next 15 이상). React 18에서는 클라이언트 컴포넌트만 캡처됩니다.
  • React: Vite + Radix + Tailwind 4 데모 프로젝트에는 Figma 재구축 기준선이 있습니다(네 화면, 브라우저와 0.02–0.12% 차이). Next.js App Router 프로젝트는 캡처 및 패킹만 확인되었습니다.
  • 자식이 없고 mask-image로 SVG를 사용하는 아이콘(예: frappe-ui, UnoCSS lucide-* 클래스)은 벡터로 변환되고 배경색으로 채색됩니다. 다른 mask-image 사용(그라데이션 페이드, 비트맵 마스크) 및 clip-path에는 대응하는 기능이 없습니다. 페이드된 가장자리와 각진 컷은 완전한 도형이 됩니다.
  • 색상: rgb()는 물론, Chrome이 반환할 수 있는 oklch(), color(srgb …), lab(), hsl() 형식을 지원합니다. 후자는 캔버스를 통해 sRGB로 변환되며, 각 채널이 1비트(8비트 반올림) 오차가 있을 수 있습니다.
  • Plugin API는 인스턴스 내부 프레임의 너비를 변경할 수 없습니다. 부모 프레임을 채우도록 늘어나는 유일한 자식은 Fill로 변경되고, 부모를 채우기 위해 늘어나는 자식은 패딩을 통해 조정되며, 데이터에서 Hug인 Auto Layout 프레임은 Hug로 변경됩니다. 다른 모든 경우 크기는 기본 컴포넌트를 따르며, log.boxes에 나열됩니다.
  • 중첩된 z-index가 있는 작은 요소는 가려질 수 있습니다. 레이어 트리는 단일 자식을 부모 밖으로 이동할 수 없습니다.
  • 시스템 폰트(ui-sans-serif)는 Inter로 대체됩니다. 문자 너비가 약간 다릅니다.
  • font-variant-numeric: tabular-nums(테이블 숫자)는 Figma에서 켤 수 없습니다. Plugin API의 openTypeFeatures는 읽기 전용입니다. 날짜, 시간 및 금액은 브라우저보다 좁게 나오며, 그 뒤의 텍스트가 5–8px 이동합니다. log.drift에 나열됩니다.
  • 회전 및 CSS 삼각형은 자식이 없는 요소(체크 표시, 탭 삼각형, 작은 사각형)에만 처리되며, 이들은 벡터로 변환됩니다. 자식이 있는 회전된 컨테이너는 경계 상자로 배치되며, 내용물은 회전되지 않습니다.

보고서

  • 구조: Auto Layout 컨테이너 비율, 컴포넌트/배리언트 개수; 절대 위치 영역(오버레이, 스크롤 중간 콘텐츠)
  • 비교 결과: 텍스트 드리프트, 가장 높은 차이 비율을 보인 화면, 재현할 수 없는 알려진 지점. 차이 비율을 맥락에서 읽으십시오. 그라데이션이나 비트맵 mask-image는 비율을 높이므로 원인을 설명하십시오. stats.json이 아이콘이 비어 있다고 경고하면 아이콘 소스를 먼저 확인하고 다시 캡처하십시오. 화면 전체에 색상이 거의 없으면 먼저 __alBuild가 반환한 stat이 색상을 감지했는지 확인하십시오(troubleshooting.md).
  • 참조 스크린샷은 대표 화면에만 들어갑니다. 나머지는 로컬 출력 폴더에 남습니다.
  • 라이브러리가 바인딩된 경우 figma-library-binding의 "Report" 섹션에 따라 이 부분을 작성하십시오. 라이브러리가 없으면 색상과 폰트 크기는 하드코딩된 값입니다.
  • 화면은 목업 데이터로 재현됩니다. 라이브 스크린샷으로 채워진 영역과 목업에서 변경된 복사본.
  • Figma에 제품 폰트가 없을 때 대체된 폰트가 무엇인지.
  • 규모: scale-guard.md 형식의 한 줄.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

figma-library-binding

Bind Figma screens to a design system library — tokens only on exact value matches, swap icons and components for library versions, and list unmatched values for designers instead of snapping to the nearest token. Use when the user asks to "bind tokens", "use library components" or "find unbound colors". 把 Figma 畫面綁到專案的 design system library:顏色、圓角、邊框、間距、字級完全相同才綁 token,圖示和元件換成 library 版本,沒有對應的值列給設計決定,不取最近值。Use when 使用者要「綁 library」「綁 token」「換成 design system 元件」「檢查沒綁 variable 的顏色」,或 code-to-figma、figma-state-board 的畫面要綁 design system。

figma-state-board

Inventory every UI state of a feature from its code and lay them out on one Figma canvas (a state board) — real screens for states the prototype already handles, plus a gap check of missing error, empty and loading states, split into spec-required and suggested. Use when the user asks for a "state board", "all states of this feature in Figma", "which error screens are missing", or to update an existing board. 從任何產品專案的程式碼盤點一個功能的所有狀態,在 Figma 產出或更新「情境稿」:原型(通常是 mock data 做的)已經有的狀態畫真實畫面,原型缺的狀態全列進「缺漏檢查」,再分「規格有寫」(規格要求、原型漏做)和「建議補」(規格和原型都沒提的錯誤、空狀態、載入等)。Use when 使用者要「做情境稿」「把所有狀態/狀況畫到 Figma」「state board」「檢查缺了哪些 error 畫面」,或要依新規則增修既有情境稿。只要狀態清單用 state-discovery,只要把畫面轉進 Figma 用 code-to-figma。

관련 스킬