К основному содержанию
скилл CX Codex

figma-developer — скилл для Claude Code: Figma в код и установка

Скилл figma-developer для Claude Code получает из Figma цвета, шрифты и иконки через REST API и собирает CSS-переменные и React-компоненты. Автоматизирует перенос изменений макета в код.

MIT 114 установок ★ 29 обновлён 2026-08-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add oakoss/agent-skills --skill figma-developer -a claude-code
Открыть на GitHub

Что делает figma-developer

Скилл выгружает данные из Figma через REST API: токены цветов, типографики и отступов уходят в CSS-переменные и JSON, иконки превращаются в SVG-компоненты React, из узлов макета генерируются заготовки компонентов. Отдельно описана синхронизация в CI: GitHub Actions по расписанию вместе с peter-evans/create-pull-request открывает пул-реквест с обновлениями.

Внутри — таблица эндпоинтов (GET /v1/files/:key, /v1/files/:key/styles, /v1/files/:key/variables/local и другие), список библиотек (figma-api, @figma/rest-api-spec, style-dictionary, svgo, @svgr/core) и разбор частых ошибок. Готового эндпоинта для токенов у Figma нет, поэтому стили придётся разбирать из ответа GET /v1/files/:key самостоятельно. Цвета приходят в диапазоне 0–1: перед переводом в hex их умножают на 255.

Разовые правки макета проще перенести руками. Для доступа нужна аутентификация в Figma API — в скилле есть отдельный справочник по её настройке. Ссылки на изображения живут 14 дней, так что CI-задание, которое держит их в кэше дольше, упрётся в пустой ответ и иконки придётся запрашивать заново.

Какие задачи решает

  • выгрузить токены Figma в CSS-переменные и JSON
  • экспортировать набор иконок как SVG-компоненты React
  • сгенерировать заготовки компонентов из вариантов в макете
  • настроить синхронизацию макета с репозиторием через GitHub Actions
  • разобрать стили из ответа GET /v1/files/:key без выдуманных методов API

Примеры запросов агенту

  • Выгрузи цветовые и текстовые стили из моего файла Figma в CSS-переменные и JSON
  • Собери все иконки из фрейма Icons в SVG-компоненты React и прогони их через svgo
  • Настрой GitHub Actions, чтобы токены из Figma приезжали пул-реквестом по расписанию

Как установить figma-developer

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill figma-developer -a claude-code

2Вручную: положить файлы

~/.claude/skills/figma-developer/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/figma-developer/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о figma-developer

Как установить figma-developer в Claude Code?

Выполните npx skills add oakoss/agent-skills --skill figma-developer -a claude-code. Файл скилла появится по пути ~/.claude/skills/figma-developer/SKILL.md.

Что делает figma-developer?

Забирает стили, компоненты и иконки из файла Figma по REST API и переводит их в код: CSS-переменные, SVG-компоненты React, заготовки компонентов из вариантов.

Почему токены нельзя выгрузить одной командой?

В Figma нет эндпоинта, который отдаёт токены. Стили и переменные скилл собирает из ответа GET /v1/files/:key и /v1/files/:key/variables/local.

Исходный текст

SKILL.md · MIT
---
name: figma-developer
description: 'Extracts design data from Figma via the REST API and converts designs to React code. Use when syncing Figma tokens to CSS variables, exporting icons as SVG components, generating code from Figma designs, or automating design-to-code workflows. Use for design token extraction, icon export, component generation, and CI-based Figma sync.'
license: MIT
metadata:
  author: oakoss
  version: '1.1'
---

# Figma Developer

## Overview

Automates the Figma-to-code bridge using the Figma REST API. Extracts design tokens (colors, typography, spacing) as CSS variables and JSON, exports icons as SVG React components, generates React components from Figma node structures, and sets up CI pipelines for continuous design sync.

**When to use:** Syncing design tokens from Figma to code, exporting icon sets as React components, generating component scaffolding from Figma variants, setting up automated design sync in CI.

**When NOT to use:** Manual one-off design tweaks (just copy values), Figma plugin development (use the Plugin API instead), real-time collaborative editing (use Figma webhooks directly), or projects without a Figma design system.

## Quick Reference

| Pattern            | API / Approach                                          | Key Points                                           |
| ------------------ | ------------------------------------------------------- | ---------------------------------------------------- |
| Get file data      | `GET /v1/files/:key`                                    | Returns full document tree with styles and fills     |
| Get specific nodes | `GET /v1/files/:key/nodes?ids=...`                      | Fetch only the nodes you need to reduce payload      |
| Export images      | `GET /v1/images/:key?ids=...&format=svg`                | Renders nodes as SVG/PNG/PDF; URLs expire in 14 days |
| Get styles         | `GET /v1/files/:key/styles`                             | Lists all published color, text, and effect styles   |
| Get components     | `GET /v1/files/:key/components`                         | Lists all published components with metadata         |
| Get component sets | `GET /v1/files/:key/component_sets`                     | Returns variant groupings for components             |
| Get variables      | `GET /v1/files/:key/variables/local`                    | Extracts Figma Variables (colors, spacing, etc.)     |
| Publish variables  | `POST /v1/variables`                                    | Publishes local variables organization-wide          |
| Token extraction   | Parse styles from file response, transform to CSS/JSON  | No built-in "extract tokens" endpoint exists         |
| CI sync            | GitHub Actions cron + `peter-evans/create-pull-request` | Auto-sync PRs on Figma file changes                  |

## Figma File Organization

| Section    | Contents                                            |
| ---------- | --------------------------------------------------- |
| Colors     | All color styles with `/` hierarchy (`Primary/500`) |
| Typography | Text styles (`Heading/Large`, `Body/Regular`)       |
| Spacing    | Spacing guide values                                |
| Components | Variant groups (`Button/Primary`, `Card/Default`)   |
| Icons      | All icons in one exportable frame                   |

## Common Mistakes

| Mistake                                                   | Fix                                                              |
| --------------------------------------------------------- | ---------------------------------------------------------------- |
| Using fabricated API methods like `extractDesignTokens()` | Parse styles from `GET /v1/files/:key` response manually         |
| Hardcoding Figma values instead of using tokens           | Extract tokens to CSS variables, reference with `var()`          |
| Not normalizing Figma style names                         | Lowercase + replace special chars with hyphens                   |
| Forgetting Figma uses 0-1 RGB not 0-255                   | Multiply by 255 and round before hex conversion                  |
| No API response caching                                   | Cache with TTL to avoid rate limits                              |
| Manual icon exports                                       | Automate with `GET /v1/images/:key` + React component generation |
| No CI sync workflow                                       | GitHub Actions cron + `create-pull-request` action               |
| Using expired image URLs                                  | Image export URLs expire in 14 days; re-fetch before use         |

## Libraries

| Package                | Purpose                                  |
| ---------------------- | ---------------------------------------- |
| `figma-api`            | Community Figma REST API client (typed)  |
| `@figma/rest-api-spec` | Official TypeScript types for Figma API  |
| `style-dictionary`     | Transform design tokens across platforms |
| `svgo`                 | Optimize exported SVGs before use        |
| `@svgr/core`           | Convert SVG files to React components    |

## Delegation

- **Design systems**: see `design-system` skill
- **Asset optimization**: see `asset-manager` skill

## References

- [Setup and Authentication](references/setup.md)
- [Design Tokens](references/design-tokens.md)
- [Asset Export](references/asset-export.md)
- [Component Generation](references/component-generation.md)
- [CI Automation](references/ci-automation.md)
- [Troubleshooting](references/troubleshooting.md)

© oakoss · MIT · oakoss/agent-skills

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
Figma Developer daffy0208 Скилл Figma Developer для Claude Code переносит макеты Figma в React-компоненты и CSS-токены. Запускается при переносе дизайн-системы в кодовую базу. CX Codex +1 152установок understand-figma Egonex-AI Скилл understand-figma запрашивает макет через Figma REST API и строит интерактивный граф знаний дизайна с экранами, компонентами и токенами для локального дашборда. CX Codex +1 2 400установок figma acedatacloud Читает файлы Figma через REST API: дерево документа, отдельные ноды, рендер в PNG и комментарии. Запускается при переводе макета в код. CX Codex +1 175установок Figma MCP Server planetabhi Локальный MCP-сервер для вызова REST API Figma прямо из ИИ-клиентов. Позволяет читать макеты, забирать токены и работать со стилями. CX Codex +1 ★ 11звёзд репо figma-codegen awdr74100 Скилл figma-codegen генерирует код по макетам Figma с учётом стека проекта, переиспользуя готовые компоненты и дизайн-токены вместо вёрстки с нуля. CX Codex +1 1 700установок figma-skill podo Читает макеты Figma и превращает дизайн в код. Он подключается к запросам на извлечение данных из Figma и генерацию компонентов. CX Codex +1 200установок

Из того же набора106

Весь набор →
agent-patterns Скилл agent-patterns для Claude Code описывает паттерны мультиагентных систем и субагентов для организации задач в изолированных контекстах. CX Codex +1 115установок tanstack-cli Скилл tanstack-cli настраивает сборку библиотек через TanStack Config и Vite с генерацией типов и релизом через conventional commits. CX Codex +1 115установок better-auth Подгружает агенту справочник по better-auth: конфиг, плагины, стратегии сессий и типовые ошибки. Даёт справку при настройке входа, 2FA и организаций. CX Codex +1 114установок meta-skill-creator Скилл meta-skill-creator помогает создавать и проверять агентские скиллы по открытому стандарту Agent Skills. Он пригодится при подготовке SKILL.md, структуры папок и файлов для распространения. CX Codex +1 114установок tanstack-store Объясняет агенту устройство TanStack Store: стор, производные значения, батчи и эффекты. Описывает общее состояние нескольких компонентов. CX Codex +1 113установок hono Скилл по веб-фреймворку Hono для создания API и edge-функций на Cloudflare Workers, Bun, Deno и Node.js. CX Codex +1 112установок astro Скилл Claude Code объясняет агенту Astro: коллекции контента, островную гидратацию, view transitions и режимы рендеринга. Описывает статичные сайты с вкраплениями интерактива. CX Codex +1 111установок db-enforcer Скилл db-enforcer для Claude Code проверяет целостность PostgreSQL-схем и согласованность с Prisma. Включается при проектировании схем, подготовке миграций и настройке RLS. CX Codex +1 109установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой