Codex용 figma-use 스킬.
figma-use 스킬은 Codex에 Figma에 쓰는 방법을 알려 줍니다. 모든 use_figma 호출 전에 로드되며, use_figma는 파일 안에서 Plugin API JavaScript를 실행해 노드를 만들고, 변수를 설정하고, 컴포넌트를 만듭니다. Codex용 Figma 플러그인에 들어 있습니다.
2026년 11월 12일 업데이트 · 3분 분량
한눈에 보기
| 스킬 이름 | figma-use |
| 제공 | Figma 플러그인(Figma 제작) |
| 설치 | codex plugin add figma@openai-curated, 또는 Codex에서 /plugins |
| Codex가 쓰는 때 | 모든 use_figma 호출 전: 노드, 변수, 컴포넌트, 오토 레이아웃, 채우기를 만들거나 수정할 때 |
| 출처 | GitHub의 openai/plugins |
하는 일
Figma는 이 스킬을 반드시 먼저 거쳐야 하는 전제 조건이라고 부릅니다. 건너뛰면 디버깅하기 어려운 오류가 생기기 때문입니다. Plugin API용 규칙집으로, 짧은 색인과 전체 타입 정의 파일로 되어 있으며 Codex는 타입 파일을 한 번에 불러오지 않고 필요한 부분을 검색합니다.
적용하는 규칙은 다음과 같습니다.
- 출력: 데이터는
return으로 돌려보냅니다.console.log()는 반환되지 않고figma.notify()는 오류를 던집니다. 만들거나 바꾼 모든 노드의 ID를 반환합니다. - 작은 단계: 호출 한 번에 논리적 작업은 최대 10개까지 하고, 플레이스홀더를 두고 위에서 아래로 쌓으며, 단계마다
get_metadata와get_screenshot으로 확인합니다. - API 함정: 색상은 0에서 1 범위를 쓰고, 채우기(fills)는 읽기 전용 배열이라 복제해서 다시 할당해야 하며, 텍스트를 편집하기 전에 폰트를 로드해야 하고, 페이지는
await figma.setCurrentPageAsync(page)로만 전환합니다. - 에디터 종류: URL로 Design, FigJam, Slides 파일을 구분합니다. 파일마다 쓸 수 있는 노드 유형이 다르기 때문입니다.
또한 컴포넌트, 변수, 텍스트·효과 스타일, 디자인 시스템에 관한 참고 파일과, 전체 화면이나 컴포넌트 라이브러리를 만드는 짝 스킬도 Codex에 알려 줍니다.
언제 쓰나요
Codex가 Figma를 읽기만 하는 게 아니라 Figma 안에서 직접 바꾸길 원할 때 설치하세요. 토큰을 설정하거나, 변형이 있는 컴포넌트를 만들거나, 코드를 바탕으로 페이지를 배치할 때입니다.
써 보기
figma-use 스킬을 사용해 주세요. 이 Figma 파일에 우리 브랜드 색상용으로 라이트·다크 모드가 있는 색상 변수 컬렉션을 만들고, 각 변수의 스코프를 올바르게 지정한 뒤, Components 페이지의 버튼에 바인딩해 주세요.
Claude Code에서도 되나요?
네, Figma MCP 서버와 함께라면 됩니다. 이 스킬은 일반 참고 파일이 딸린 표준 SKILL.md라서 폴더를 ~/.claude/skills로 복사하면 됩니다. use_figma, get_metadata, get_screenshot 도구는 Figma MCP 서버에서 오므로 먼저 Claude Code에 서버를 연결하세요. 다른 Figma 스킬로 가는 링크는 그 스킬들도 복사해야 작동합니다.