Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

figma-to-code

/figma-to-code

Wdraża ramkę lub komponent z Figmy w kodzie, mapując wartości na tokeny projektu, z wizualnym sprawdzeniem zrzutem ekranu.

Repozytorium
figma-to-code ↗
Licencja
MIT
Ostatnia zmiana repozytorium
12.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
3
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 12.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Wdraża ramkę lub komponent z Figmy w kodzie, mapując wartości na tokeny projektu, z wizualnym sprawdzeniem zrzutem ekranu.

Wyzwalacze z opisu

implement this design피그마 구현디자인 그대로시안대로토큰 매핑
Oryginalny opis (EN)

Implements a Figma frame or component in code with exact design-token mapping, for any design system (Tailwind, CSS variables, styled-components, a custom DS). Builds or reads a project token map first, compares Figma node values to tokens in three passes before writing code, and finishes with a screenshot-based visual QA. Use when the user pastes a Figma URL or node-id, or says "implement this design", "피그마 구현", "디자인 그대로", "시안대로", "토큰 매핑".

Jak działa

  1. 0. 프로젝트 토큰 맵 (최초 1회)
  2. 1. 노드 읽기
  3. 2. 3회 대조 — 끝나기 전엔 코드를 쓰지 않는다
  4. 3. 구현 규칙
  5. 4. MCP ≠ 정본인 경우
  6. 5. 끝내는 조건
  7. 참고
Sekcje z nagłówków SKILL.md, w oryginale · 98 linii, 658 słów
Podgląd SKILL.md
---
name: figma-to-code
description: >-
  Implements a Figma frame or component in code with exact design-token mapping,
  for any design system (Tailwind, CSS variables, styled-components, a custom DS).
  Builds or reads a project token map first, compares Figma node values to tokens
  in three passes before writing code, and finishes with a screenshot-based visual QA.
  Use when the user pastes a Figma URL or node-id, or says "implement this design",
  "피그마 구현", "디자인 그대로", "시안대로", "토큰 매핑".
---

# Figma → 코드 (디자인 시스템 중립)

Figma MCP가 주는 참고 코드는 **범용 스니펫**이다. 그대로 쓰면 `text-[15px]`, `bg-[#F5F5F5]`,
`gap-8` 같은 임의 값이 남고 프로젝트 디자인 시스템(DS)을 우회한다. 이 스킬은 **노드 수치 → 프로젝트 토큰**
을 한 줄씩 대응시킨 뒤에만 코드를 쓰게 한다.

## 0. 프로젝트 토큰 맵 (최초 1회)

1. `.claude/figma-to-code.md` 가 있으면 읽는다. 이것이 이 프로젝트의 매핑 정본이다.
2. 없으면 코드베이스에서 찾아 **만든다** — 템플릿: `references/token-map-template.md`.
   - 타이포: Tailwind `@theme`/`@utility`, `tailwind.config.*` `fontSize`, CSS 변수, theme 객체
   - 색: 시맨틱 토큰(`--color-text-*`, `colors.text.*` 등). 원시 팔레트만 있으면 그 사실을 적는다
   - 간격 단위(4px? 8px?), 반경, 그림자 유틸
   - DS 컴포넌트 위치(Button, Modal 등), 아이콘 폴더와 아이콘 작성 방식
   - Figma 변수 이름 규칙 ↔ 코드 토큰 이름 규칙 (예: `spacing-200` = 20px)
3. 확신이 없는 칸은 비워 두고 사용자에게 묻는다. **추측으로 채우지 않는다.**

이후 모든 단계는 이 맵을 기준으로 한다.

## 1. 노드 읽기

MCP 연결·폴백은 `figma-mcp-setup` 스킬. URL `?node-id=12-345` → `nodeId` `12:345`.

| 순서 | 도구 | 얻는 것 |
|---|---|---|
| 1 | `get_design_context` | 레이아웃·텍스트·참고 코드·에셋 URL |
| 2 | `get_screenshot` | **시각 기준(베이스라인)** — 구현 후 QA에 그대로 쓴다 |
| 3 | `get_variable_defs` | 노드에 묶인 Figma Variables 이름·값 |
| 4 | `get_metadata` | 큰 프레임이면 자식 노드로 쪼개 다시 읽기 |

아이콘이 있는 화면이면 이 단계에서 **아이콘 인벤토리**(구간·개수·이름, `.svg` URL 유무)를 같이 만든다.

### 수치의 정본은 REST nodes JSON

`get_design_context` 참고 코드는 정본이 아니다. `FIGMA_TOKEN` 이 있으면 같은 노드의 스냅샷을 저장해 둔다.

```bash
node "${CLAUDE_PLUGIN_ROOT}/scripts/fetch-node-spec.mjs" <fileKey> <nodeId> specs/figma/<nodeId>.json
```

스크립트는 플러그인 폴더에 있고, 출력 경로와 `.env.local` 은 현재 디렉터리 기준이다. 프로젝트 루트에서 실행한다.
`${CLAUDE_PLUGIN_ROOT}` 가 비어 있으면(Cursor 등에 복사해서 설치) 스크립트를 복사한 경로로 바꾸거나 `fetch-node-spec.mjs` 를 Glob 으로 찾는다.

| 항목 | 정본 |
|---|---|
| 레이아웃·크기·간격·반경·텍스트 수치 | REST `GET /v1/files/:fileKey/nodes?ids=` 스냅샷 |
| 변수 이름 | `get_variable_defs` + 토큰 파일 grep |
| 시각 | `get_screenshot` |

토큰이 없으면 MCP 값을 임시 정본으로 쓰고, 보고에 `REST 미검증` 이라고 적는다.

## 2. 3회 대조 — 끝나기 전엔 코드를 쓰지 않는다

| 회차 | 할 일 | 산출 |
|---|---|---|
| **1회** | 노드의 타이포·색·간격·반경·그림자를 토큰 맵과 **한 줄씩** 대응 (`references/token-mapping.md`) | 짧은 매핑 메모 |
| **2회** | DS 컴포넌트로 대체 가능한지 확인(`design-reuse-first` 스킬, `search_design_system`). 아이콘 SVG 확보 경로 확정 | 쓸 컴포넌트·클래스 목록 |
| **3회** | 매핑 메모에서 임의 값(`[..px]`, Hex, 토큰에 없는 유틸)이 남았는지 스캔. 쓰려는 클래스·토큰을 **grep 해서 실제로 존재하는지** 확인 | 이때부터 구현 |

MCP 한도·오류로 노드를 못 읽으면 대조를 끝낼 수 없다. 사용자에게 알리고 스크린샷·Dev Mode 수치 중
무엇으로 대체할지 합의한다. 추측 구현 금지.

## 3. 구현 규칙

- 참고 코드는 **재작성**한다. 복붙하지 않는다.
- 쓰려는 토큰·유틸은 **grep으로 존재 확인** 후 사용. 없으면 가장 가까운 토큰 + 이유 메모, 차이가 크면 토큰 추가를 제안.
- DS 컴포넌트 내부는 요청 없이 고치지 않는다. 조합·래핑만.
- 아이콘은 SVG → 컴포넌트, 색은 `currentColor`. MCP의 `http://localhost:3845/assets/...` 는 세션 임시 URL이라
  코드에 남기지 않는다. 이미지는 프로젝트 에셋/CDN으로 옮긴다.
- Figma의 `HH:MM`, `yyyy.MM.dd`, `n원`, `Lorem` 같은 **자리표시 문구**를 사용자 노출 문자열로 고정하지 않는다.
  API 필드에 연결하거나 폴백 문구를 정한다.
- Figma 컴포넌트 variant 값(`content="2"`)과 리스트 행 순서가 다를 수 있다. export 파일 번호로 매핑하지 말고 variant를 정본으로.

## 4. MCP ≠ 정본인 경우

`get_design_context`는 편집기 트리다. 아래는 구현이 달라도 버그가 아니다. QA 보고에 **의도된 차이** 한 줄만 남긴다.

- 한 캔버스의 absolute 배치 ↔ 웹의 레이아웃·스크롤 컨테이너 (예: 루트 전체 그라데이션 → 상단 영역만)
- 합성된 히어로/배너 프레임 ↔ CMS 이미지 캐러셀
- 래퍼에 붙은 `rotate-*` ↔ 내부에 이미 transform이 있는 공유 SVG 아이콘

판단 순서: 스펙 문서 → 기존 코드·리뷰 합의 → 그다음 MCP 수치.

## 5. 끝내는 조건

1. 타입체크·린트 통과
2. **`figma-spec-qa`** — REST 스냅샷 ↔ MCP ↔ 코드 값 교차 대조, Open 0건
3. **`figma-visual-qa`** — 베이스라인 스크린샷과 시각 대조. 페이지 전체면 **`figma-page-qa`** 도
4. 최종 보고에 `비교한 nodeId` · `맞춘 항목` · `남은 차이(의도/미해결)` 포함

시각 QA 전에는 완료라고 말하지 않는다.

## 참고

- 토큰 매핑 상세와 흔한 오매핑: `references/token-mapping.md`
- 토큰 근거를 짧게 남기면 리뷰가 쉽다: "Figma 16/24/700 → `--text-b2-*` 와 일치 → `text-b2-bold`"
Pliki w paczce (3)
  • SKILL.md 6 KB
  • references/token-map-template.md 2 KB
  • references/token-mapping.md 6 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · Ahnseungc/figma-to-code100MIT
TerminalSkills/skills100Apache-2.0
majiayu000/spellbook100MIT

Migawka bazy z 13.11.2026 · wersja paczki c2f1dd9c7c97 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90figma-design-to-code
    Prowadzi implementację projektu z Figmy jako kodu: odczytuje węzeł przez get_design_context i dopasowuje wynik referencyjny do docelowego projektu, z ponownym użyciem istniejących komponentów.
  • 100figma-implement-design
    Zamienia projekty Figmy na kod produkcyjny aplikacji z wiernością 1:1 na podstawie adresów Figmy i specyfikacji komponentów.
  • 90design-to-code
    Zamienia projekt, makietę, ramkę Figma lub zrzut ekranu w implementację zgodną z oryginałem, mapując wartości na istniejące tokeny i komponenty oraz wskazując niejasności.
  • 100figma-lens
    Buduje ekran lub komponent zgodnie z eksportem Figmy, czyli specyfikacją, tokenami i ikonami, w Flutterze lub webie.
  • 90figma-to-page
    Wdraża stronę lub komponent frontendu z adresu Figma i sprawdza wynik w Playwright, dbając o wierność wizualną, treść i strukturę.
  • 100figma-implement-design
    Zamienia projekty Figmy na kod produkcyjny aplikacji z wiernością 1:1 na podstawie adresów URL, identyfikatorów węzłów i specyfikacji komponentów.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.