---

name: figma-design-parser description: Parse Figma design files into structured screen hierarchies. Use when working with Figma API, extracting text/labels from design nodes, traversing node trees, detecting cover frames, or parsing screen IDs (AUTO_0001, PSET_0002, etc.).

Figma Design Parser

Figma 디자인 파일을 구조화된 스크린 계층으로 파싱하는 전문 스킬입니다.

Quick Reference

스크린 ID 규칙

• 형식: {PREFIX}_{4자리숫자}[_suffix]
• 예: AUTO_0001, PSET_0002_1, LINK_0003_ㅅ
• 접두사: AUTO, PSET, LINK, MENU 등

핵심 노드 타입

CopyFRAME → 스크린 컨테이너
TEXT → 텍스트 콘텐츠
GROUP → 그룹화된 요소
COMPONENT → 재사용 컴포넌트
INSTANCE → 컴포넌트 인스턴스

Contents

• reference.md - Figma API 노드 순회 및 최적화 가이드
• guide.md - 텍스트 추출 및 라벨-값 파싱 패턴
• scripts/extract_figma_data.py - 결정론적 Figma 데이터 추출
• scripts/parse_screen_id.py - 스크린 ID 파싱 유틸리티

When to Use

• Figma 파일에서 스크린 데이터 추출 시
• 노드 트리 재귀 순회 로직 작성 시
• Cover 프레임 감지 및 썸네일 데이터 추출 시
• 텍스트 노드에서 라벨-값 쌍 추출 시