Communitygithub.com

figma-library-binding

Figma 화면을 디자인 시스템 라이브러리에 바인딩합니다. 토큰은 정확히 일치하는 값에만 적용되고, 아이콘과 컴포넌트는 라이브러리 버전으로 교체되며, 일치하지 않는 값은 디자이너가 결정할 수 있도록 나열됩니다. 사용자가 '토큰 바인딩', '라이브러리 컴포넌트 사용' 또는 '바인딩되지 않은 색상 찾기'를 요청할 때 사용합니다.

figma-library-binding란 무엇인가요?

이 스킬은 Figma 화면을 프로젝트의 디자인 시스템 라이브러리에 바인딩하여 일관성을 유지합니다. 로컬 레이어가 아닌 디자인 시스템의 토큰, 아이콘, 컴포넌트를 사용하도록 강제합니다. `Color`, `Radius`, `Stroke`, `Spacing`, `Type Size` 값은 정확히 일치하는 경우에만 토큰을 적용하며, 가장 가까운 값으로 스냅하지 않습니다. 아이콘과 컴포넌트는 라이브러리에서 동일한 이름과 모양이 확인된 경우에만 교체합니다. `search_design_system`과 `al-capture.cjs`/`al-pack.py` 기반의 자동화된 워크플로우를 제공하여 preset을 사용해 반복적인 바인딩을 수행하고, 새로운 preset이 없을 경우 수동 과정을 거쳐 저장합니다. 바인딩 결과는 `unboundColors`, `localIcons`, `localComponents`를 포함한 상세 보고서로 제공됩니다. Claude Code, Cursor, Codex와 같은 AI 에이전트 플랫폼에서 사용자 요청(예: '토큰 바인딩', '라이브러리 컴포넌트 사용', '바인딩되지 않은 색상 찾기')을 처리할 때 유용합니다.

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

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

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

문서

디자인 시스템 라이브러리에 바인딩하기

제품 화면은 로컬 레이어가 아닌 프로젝트의 디자인 시스템을 사용해야 합니다.

프리셋 선택

각 디자인 시스템에는 presets/에 하나의 프리셋이 있습니다. 사용자에게 프로젝트가 어떤 프리셋을 사용하는지 묻거나, 프로젝트의 종속성을 확인하세요(예: 프로젝트가 디자인 토큰 패키지에 의존하는 경우 일치하는 프리셋 사용). 형식은 presets/README.md를 참조하세요. 프리셋이 없으면 아래 "자동 바인딩 작동 방식"에 따라 한 번 조회한 다음, 결과를 새 프리셋으로 저장하세요. 프로젝트에 라이브러리가 없으면 "없음"을 작성하고 보고서에 명시하세요.

시작하기 전에 get_libraries를 사용하여 모든 라이브러리가 libraries_added_to_file에 있는지 확인하세요. 누락된 라이브러리가 있으면 사용자에게 Figma의 Assets › Libraries에서 추가하도록 요청하고, 추가될 때까지 진행하지 마세요.

바인딩 규칙

화면을 변경하는 것보다 무언가를 바인딩하지 않은 상태로 두는 것이 좋습니다. 도구는 아래만 수행하며, 그 외의 모든 것은 로컬로 유지되고 보고됩니다.

유형규칙하지 말아야 할 것
색상불투명도를 포함하여 정확히 일치하는 경우에만 바인딩합니다. 반투명 색상은 해당 투명도를 가진 토큰이 필요합니다. Figma에서 바인딩 시 불투명도를 1로 재설정하기 때문입니다가장 가까운 색상으로 스냅하지 마세요
반경, 선 두께, 간격, 글자 크기값이 정확히 동일한 경우에만 바인딩합니다3px를 2px 또는 4px로 변경하지 마세요
별칭 토큰다른 토큰을 가리키는 토큰(기본 토큰 위의 시맨틱 토큰)은 체인 끝의 값을 기준으로 계산됩니다. 값에 둘 다 있는 경우, 자체 값을 가진 토큰이 우선합니다. 별칭은 다른 값이 없는 값에만 사용됩니다값이 같은 두 시맨틱 토큰 중에서 추측하여 선택하지 말고 보고하세요
텍스트 스타일글꼴, 크기, 줄 높이가 모두 동일한 경우에만 바인딩합니다글꼴이 다른 경우 크기만 바인딩하세요
아이콘라이브러리에 동일한 이름의 컴포넌트가 있는 경우에만 교체합니다. 동일한 용도로 확인된 매핑에 대해서만 이전 이름을 허용합니다의미는 비슷하지만 모양이 다른 아이콘을 사용하지 마세요
컴포넌트라이브러리 컴포넌트가 제품의 것과 모양이 동일한 경우에만 교체합니다. 제품의 크기는 유지합니다모양이 다르면 로컬 컴포넌트를 유지하고 제품 화면을 변경하지 마세요

가장 가까운 값으로 스냅하지 않는 이유: 일치하는 값이 반드시 일치하는 의미를 의미하는 것은 아니며, 상태 보드가 코드와 불일치하게 만듭니다. 일치하는 토큰이 없는 값은 디자인 시스템의 간격입니다. 도구가 임의로 선택하게 하는 대신 디자인 팀이 결정할 수 있도록 나열하세요.

자동 바인딩 작동 방식

프리셋이 있는 경우, al-capture.cjs 설정에서 preset을 설정하고 네 번째 인수로 프리셋 이름을 al-pack.py에 전달하세요. 화면이 빌드될 때 자동으로 바인딩됩니다. 프리셋이 없는 경우에만 아래 프로세스를 따르고 결과를 presets/<name>.json으로 저장하세요: libs는 바인딩 설정이고, extract는 추출 중 사용되는 스프라이트 매핑입니다.

  1. 레이아웃 트리를 추출한 후, JSON에서 모든 lib(아이콘 이름)을 나열합니다.
  2. 각 이름에 대해 search_design_system으로 아이콘 시스템을 검색합니다: system:cross는 icon / system / cross에 매핑됩니다. 정확한 이름 일치만 허용합니다.
  3. search_design_system을 사용하여 컴포넌트 세트를 찾고, 인스턴스를 몇 개 배치하고, 스크린샷을 찍고, 제품의 모양과 비교하여 buttons.rules를 결정합니다.
  4. opts.libs를 구성합니다. 먼저 3-4개의 카드를 빌드하고 log.drift와 스크린샷을 확인합니다. 제대로 보이는 경우에만 일괄 처리합니다.
const libs = {
  tokens: ['My DS - Foundation'],        // 이 라이브러리에서 변수 읽기
  icons: { 'system:cross': '<componentKey>' },
  buttons: {
    set: '<componentSetKey>',
    rules: { FFE13A: { Type: 'primary', Size: 'medium', Compact: 'false', Status: 'default' } }, // 키는 버튼 배경색입니다
  },
  words: { value: 'Price' },             // 팀 용어와 일치하도록 텍스트 속성 이름 변경
};

al-capture.cjs 출력에는 이번에 사용되었지만 프리셋에 아직 매핑되지 않은 아이콘을 나열하는 unmappedIcons가 포함됩니다. search_design_system으로 조회하고 정확한 이름 일치를 프리셋에 추가하세요. 다음 번에 자동으로 바인딩되므로 프리셋이 사용됨에 따라 더 완전해집니다.

__alBuild가 반환하는 stat에는 바인딩 결과가 포함됩니다: boundColors, boundLayout, libIcons, dsButtons, unboundColors, localIcons.

기존 화면 바인딩

al-bind.js는 단독으로 사용할 수 있습니다. 토큰만 바인딩하고 아이콘이나 컴포넌트는 교체하지 않습니다. 전체 스크립트를 use_figma에 붙여넣거나(또는 eval로 로드)한 다음 호출하세요:

return await __alBind(['<frame id>'], { tokens: ['<library name>'] });

boundColors, boundLayout, unboundColors(토큰이 없는 색상)를 반환합니다. skippedText는 글꼴을 로드할 수 없어 크기가 바인딩되지 않은 텍스트의 개수를 나타냅니다.

화면이 __alBuild로 빌드될 때, 토큰 테이블은 _registry에 캐시되므로 이후 화면에서 모든 변수를 다시 가져오지 않습니다. 프리셋이 다른 토큰 라이브러리를 나열하면 재구축됩니다. 라이브러리가 새 토큰이나 변경된 토큰을 게시한 후에는 다음 __alBuild 호출에 refreshTokens: true를 전달하세요.

컴포넌트

  • Auto Layout으로 가운데 정렬: 패딩이나 텍스트 상자 너비가 아닌 Auto Layout을 사용하여 텍스트가 변경되어도 위치가 이동하지 않도록 합니다.
  • 컨테이너는 컴포넌트가 아님: 이미 컴포넌트를 포함하는 반복 구조는 단순한 컨테이너입니다.
  • 상태는 변형(variant)으로 처리: 선택 및 비활성화 상태는 인스턴스 색상을 재정의하는 것이 아니라 속성을 통해 전환 가능해야 합니다.
  • 작은 컴포넌트를 속성으로 분할: Type 및 State라는 두 개의 변형 속성; 텍스트를 컴포넌트 속성으로 만듭니다.
  • 메인 컴포넌트는 완전해야 함: 뷰포트에 의해 잘리는 요소를 컴포넌트로 만들지 마세요.

보고서

항상 다음을 나열하세요:

  • 바인딩 비율: 색상, 레이아웃 값
  • 라이브러리 버전으로 교체된 아이콘 및 컴포넌트 수
  • 디자인 팀이 결정할 수 있도록 토큰이 없는 색상(상위 몇 개)
  • 로컬로 유지된 아이콘 및 컴포넌트와 그 이유

Individual skills in this repo

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

code-to-figma

Rebuild screens from a running web app as native, editable Figma layers (Auto Layout, components, instances) and diff them against browser screenshots — not a screenshot import or a Code layer. Use when the user asks to "turn this page into Figma", "code to Figma", "push this screen to Figma" or "rebuild the UI in Figma". 把 Web 專案實際跑出來的畫面重建成 Figma 原生圖層:造狀態、抽 DOM 版面樹,建 Auto Layout 和 component/instance,再跟瀏覽器截圖比對。單一畫面或一批畫面都能用,不需要做情境稿。Use when 使用者要「code to figma」「把這頁轉成 Figma」「從程式重建畫面」「push 畫面到 Figma」,或 figma-state-board 走路線 B。產出是可編輯圖層,不是 Code layer 或截圖。

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。

관련 스킬