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

figma-implement-design · tech-leads-club — скилл для Claude Code

Скилл figma-implement-design переносит компоненты и фреймы из Figma в код проекта с точным визуальным совпадением через Figma MCP.

Apache-2.0 ★ 7 191 обновлён 2026-10-24

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

Что делает figma-implement-design

Скилл задаёт строгую последовательность действий для переноса макетов в код. Сначала агент извлекает ключ файла и идентификатор узла из переданной ссылки или берёт выделенный слой прямо в приложении Figma Desktop. Затем через вызовы get_design_context и get_screenshot он забирает свойства разметки, отступы, параметры типографики и эталонный снимок экрана.

Изображения и векторную графику инструмент скачивает напрямую из локального эндпоинта MCP-сервера. Правила запрещают подключать внешние пакеты иконок или использовать временные заглушки. Полученную разметку агент адаптирует под кодовую базу репозитория: заменяет базовые классы на токены дизайн-системы проекта и переиспользует уже созданные кнопки или поля ввода.

Для работы требуется настроенное подключение к серверу Figma MCP по адресу https://mcp.figma.com/mcp либо локальный figma-desktop. Без авторизации по OAuth и последующего перезапуска агента команды извлечения дизайна завершатся ошибкой.

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

  • перенести узел или фрейм из Figma в код компонентов
  • выгрузить векторные ресурсы и изображения через локальный эндпоинт MCP
  • адаптировать разметку Figma под дизайн-систему и токены проекта
  • сверить готовую вёрстку с эталонным скриншотом макета

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

  • Сверстай компонент кнопки по ссылке на макет в Figma с параметром node-id=42-15.
  • Реализуй карточку профиля из выбранного слоя в Figma Desktop.
  • Перенеси форму входа из Figma в проект, используя компоненты нашей дизайн-системы.

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

1Через Skills CLI (Vercel)

npx skills add tech-leads-club/agent-skills --skill figma-implement-design -a claude-code

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

~/.claude/skills/figma-implement-design/SKILL.md

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

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

Вопросы о figma-implement-design

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

Выполните команду npx skills add tech-leads-club/agent-skills --skill figma-implement-design -a claude-code. Также можно вручную сохранить файл навыка по пути ~/.claude/skills/figma-implement-design/SKILL.md.

Что делает скилл figma-implement-design?

Он запрашивает параметры узла через Figma MCP, выгружает ассеты со скриншотом и пишет код интерфейса по правилам вашего проекта.

Что нужно подготовить перед запуском скилла?

Требуется подключённый сервер Figma MCP по адресу https://mcp.figma.com/mcp с авторизацией по OAuth либо запущенный figma-desktop с открытым файлом.

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

SKILL.md · Apache-2.0
---
name: figma-implement-design
description: Translate Figma nodes into production-ready code with 1:1 visual fidelity using the Figma MCP workflow (design context, screenshots, assets, and project-convention translation). Use when the user provides Figma URLs or node IDs and asks to implement designs or components that must match Figma specs. Requires a working Figma MCP server connection. Do NOT use for general Figma data fetching, variable exploration, or MCP troubleshooting (use figma instead).
metadata:
  author: github.com/openai/skills
  version: '1.0.0'
---

# Implement Design

## Overview

This skill provides a structured workflow for translating Figma designs into production-ready code with pixel-perfect accuracy. It ensures consistent integration with the Figma MCP server, proper use of design tokens, and 1:1 visual parity with designs.

## Prerequisites

- Figma MCP server must be connected and accessible
- User must provide a Figma URL in the format: `https://figma.com/design/:fileKey/:fileName?node-id=1-2`
  - `:fileKey` is the file key
  - `1-2` is the node ID (the specific component or frame to implement)
- **OR** when using `figma-desktop` MCP: User can select a node directly in the Figma desktop app (no URL required)
- Project should have an established design system or component library (preferred)

## Required Workflow

**Follow these steps in order. Do not skip steps.**

### Step 0: Set up Figma MCP (if not already configured)

If any MCP call fails because Figma MCP is not connected, pause and set it up:

1. Add the Figma MCP server to your agent's MCP configuration:
   - URL: `https://mcp.figma.com/mcp`
2. Enable remote MCP client if required by your agent.
3. Log in with OAuth following your agent's authentication flow.

After successful login, the user will have to restart their agent. You should finish your answer and tell them so when they try again they can continue with Step 1.

### Step 1: Get Node ID

#### Option A: Parse from Figma URL

When the user provides a Figma URL, extract the file key and node ID to pass as arguments to MCP tools.

**URL format:** `https://figma.com/design/:fileKey/:fileName?node-id=1-2`

**Extract:**

- **File key:** `:fileKey` (the segment after `/design/`)
- **Node ID:** `1-2` (the value of the `node-id` query parameter)

**Note:** When using the local desktop MCP (`figma-desktop`), `fileKey` is not passed as a parameter to tool calls. The server automatically uses the currently open file, so only `nodeId` is needed.

**Example:**

- URL: `https://figma.com/design/kL9xQn2VwM8pYrTb4ZcHjF/DesignSystem?node-id=42-15`
- File key: `kL9xQn2VwM8pYrTb4ZcHjF`
- Node ID: `42-15`

#### Option B: Use Current Selection from Figma Desktop App (figma-desktop MCP only)

When using the `figma-desktop` MCP and the user has NOT provided a URL, the tools automatically use the currently selected node from the open Figma file in the desktop app.

**Note:** Selection-based prompting only works with the `figma-desktop` MCP server. The remote server requires a link to a frame or layer to extract context. The user must have the Figma desktop app open with a node selected.

### Step 2: Fetch Design Context

Run `get_design_context` with the extracted file key and node ID.

```
get_design_context(fileKey=":fileKey", nodeId="1-2")
```

This provides the structured data including:

- Layout properties (Auto Layout, constraints, sizing)
- Typography specifications
- Color values and design tokens
- Component structure and variants
- Spacing and padding values

**If the response is too large or truncated:**

1. Run `get_metadata(fileKey=":fileKey", nodeId="1-2")` to get the high-level node map
2. Identify the specific child nodes needed from the metadata
3. Fetch individual child nodes with `get_design_context(fileKey=":fileKey", nodeId=":childNodeId")`

### Step 3: Capture Visual Reference

Run `get_screenshot` with the same file key and node ID for a visual reference.

```
get_screenshot(fileKey=":fileKey", nodeId="1-2")
```

This screenshot serves as the source of truth for visual validation. Keep it accessible throughout implementation.

### Step 4: Download Required Assets

Download any assets (images, icons, SVGs) returned by the Figma MCP server.

**IMPORTANT:** Follow these asset rules:

- If the Figma MCP server returns a `localhost` source for an image or SVG, use that source directly
- DO NOT import or add new icon packages - all assets should come from the Figma payload
- DO NOT use or create placeholders if a `localhost` source is provided
- Assets are served through the Figma MCP server's built-in assets endpoint

### Step 5: Translate to Project Conventions

Translate the Figma output into this project's framework, styles, and conventions.

**Key principles:**

- Treat the Figma MCP output (typically React + Tailwind) as a representation of design and behavior, not as final code style
- Replace Tailwind utility classes with the project's preferred utilities or design system tokens
- Reuse existing components (buttons, inputs, typography, icon wrappers) instead of duplicating functionality
- Use the project's color system, typography scale, and spacing tokens consistently
- Respect existing routing, state management, and data-fetch patterns

### Step 6: Achieve 1:1 Visual Parity

Strive for pixel-perfect visual parity with the Figma design.

**Guidelines:**

- Prioritize Figma fidelity to match designs exactly
- Avoid hardcoded values - use design tokens from Figma where available
- When conflicts arise between design system tokens and Figma specs, prefer design system tokens but adjust spacing or sizes minimally to match visuals
- Follow WCAG requirements for accessibility
- Add component documentation as needed

### Step 7: Validate Against Figma

Before marking complete, validate the final UI against the Figma screenshot.

**Validation checklist:**

- [ ] Layout matches (spacing, alignment, sizing)
- [ ] Typography matches (font, size, weight, line height)
- [ ] Colors match exactly
- [ ] Interactive states work as designed (hover, active, disabled)
- [ ] Responsive behavior follows Figma constraints
- [ ] Assets render correctly
- [ ] Accessibility standards met

## Implementation Rules

### Component Organization

- Place UI components in the project's designated design system directory
- Follow the project's component naming conventions
- Avoid inline styles unless truly necessary for dynamic values

### Design System Integration

- ALWAYS use components from the project's design system when possible
- Map Figma design tokens to project design tokens
- When a matching component exists, extend it rather than creating a new one
- Document any new components added to the design system

### Code Quality

- Avoid hardcoded values - extract to constants or design tokens
- Keep components composable and reusable
- Add TypeScript types for component props
- Include JSDoc comments for exported components

## Examples

### Example 1: Implementing a Button Component

User says: "Implement this Figma button component: https://figma.com/design/kL9xQn2VwM8pYrTb4ZcHjF/DesignSystem?node-id=42-15"

**Actions:**

1. Parse URL to extract fileKey=`kL9xQn2VwM8pYrTb4ZcHjF` and nodeId=`42-15`
2. Run `get_design_context(fileKey="kL9xQn2VwM8pYrTb4ZcHjF", nodeId="42-15")`
3. Run `get_screenshot(fileKey="kL9xQn2VwM8pYrTb4ZcHjF", nodeId="42-15")` for visual reference
4. Download any button icons from the assets endpoint
5. Check if project has existing button component
6. If yes, extend it with new variant; if no, create new component using project conventions
7. Map Figma colors to project design tokens (e.g., `primary-500`, `primary-hover`)
8. Validate against screenshot for padding, border radius, typography

**Result:** Button component matching Figma design, integrated with project design system.

### Example 2: Building a Dashboard Layout

User says: "Build this dashboard: https://figma.com/design/pR8mNv5KqXzGwY2JtCfL4D/Dashboard?node-id=10-5"

**Actions:**

1. Parse URL to extract fileKey=`pR8mNv5KqXzGwY2JtCfL4D` and nodeId=`10-5`
2. Run `get_metadata(fileKey="pR8mNv5KqXzGwY2JtCfL4D", nodeId="10-5")` to understand the page structure
3. Identify main sections from metadata (header, sidebar, content area, cards) and their child node IDs
4. Run `get_design_context(fileKey="pR8mNv5KqXzGwY2JtCfL4D", nodeId=":childNodeId")` for each major section
5. Run `get_screenshot(fileKey="pR8mNv5KqXzGwY2JtCfL4D", nodeId="10-5")` for the full page
6. Download all assets (logos, icons, charts)
7. Build layout using project's layout primitives
8. Implement each section using existing components where possible
9. Validate responsive behavior against Figma constraints

**Result:** Complete dashboard matching Figma design with responsive layout.

## Best Practices

### Always Start with Context

Never implement based on assumptions. Always fetch `get_design_context` and `get_screenshot` first.

### Incremental Validation

Validate frequently during implementation, not just at the end. This catches issues early.

### Document Deviations

If you must deviate from the Figma design (e.g., for accessibility or technical constraints), document why in code comments.

### Reuse Over Recreation

Always check for existing components before creating new ones. Consistency across the codebase is more important than exact Figma replication.

### Design System First

When in doubt, prefer the project's design system patterns over literal Figma translation.

## Common Issues and Solutions

### Issue: Figma output is truncated

**Cause:** The design is too complex or has too many nested layers to return in a single response.
**Solution:** Use `get_metadata` to get the node structure, then fetch specific nodes individually with `get_design_context`.

### Issue: Design doesn't match after implementation

**Cause:** Visual discrepancies between the implemented code and the original Figma design.
**Solution:** Compare side-by-side with the screenshot from Step 3. Check spacing, colors, and typography values in the design context data.

### Issue: Assets not loading

**Cause:** The Figma MCP server's assets endpoint is not accessible or the URLs are being modified.
**Solution:** Verify the Figma MCP server's assets endpoint is accessible. The server serves assets at `localhost` URLs. Use these directly without modification.

### Issue: Design token values differ from Figma

**Cause:** The project's design system tokens have different values than those specified in the Figma design.
**Solution:** When project tokens differ from Figma values, prefer project tokens for consistency but adjust spacing/sizing to maintain visual fidelity.

## Understanding Design Implementation

The Figma implementation workflow establishes a reliable process for translating designs to code:

**For designers:** Confidence that implementations will match their designs with pixel-perfect accuracy.
**For developers:** A structured approach that eliminates guesswork and reduces back-and-forth revisions.
**For teams:** Consistent, high-quality implementations that maintain design system integrity.

By following this workflow, you ensure that every Figma design is implemented with the same level of care and attention to detail.

## Additional Resources

- [Figma MCP Server Documentation](https://developers.figma.com/docs/figma-mcp-server/)
- [Figma MCP Server Tools and Prompts](https://developers.figma.com/docs/figma-mcp-server/tools-and-prompts/)
- [Figma Variables and Design Tokens](https://help.figma.com/hc/en-us/articles/15339657135383-Guide-to-variables-in-Figma)

© github.com/openai/skills · Apache-2.0 · tech-leads-club/agent-skills

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

Все скиллы по теме «Дизайн» →

Сначала — figma-implement-design от других авторов.

figma-implement-design nexu-io Скилл figma-implement-design помогает перенести дизайн из Figma в код с визуальным соответствием макету. Он пригодится, когда нужно передать фрейм Figma фронтенд-агенту. CX Codex +1 3 000установок figma-designer elayadesign Скилл figma-designer для Claude Code задаёт правила проектирования интерфейсов в Figma через Figma MCP. Включается при создании экранов, компонентов, дизайн-систем или по ссылке на макет. CX Codex +1 2 900установок implement-from-figma официальный Figma Команда implement-from-figma переносит фреймы и компоненты из макетов Figma прямо в код проекта. Она скачивает графику и сверяет вёрстку с дизайном. CX Codex GP ChatGPT +1 ★ 8 052звёзд репо figma-create-design-system-rules официальный openai Скилл figma-create-design-system-rules для Claude Code, Codex, Cursor и других агентов генерирует правила дизайн-системы под конкретный проект. CX Codex +1 3 200установок om-figma-design-with-ds open-mercato Скилл om-figma-design-with-ds для Claude Code связывает макет нового экрана или аудит Figma с дизайн-системой репозитория. Описывает экран через существующие токены и компоненты. CX Codex +1 984установок figma-build awdr74100 Скилл figma-build для Claude Code собирает макет в подключённом Figma-файле из кода или описания, переиспользуя компоненты, переменные и стили. Переносит в Figma экраны и UI-компоненты. CX Codex +1 1 600установок figma-ui-skills design-skills Скилл figma-ui-skills задаёт агенту дизайн-систему интерфейсов Figma: светлую тему, шрифт Inter и сетку 4px. Исключает произвольные отступы и тяжёлые анимации макета. CX Codex +1 374установок

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

Весь набор →
security-best-practices Скилл security-best-practices проводит ревью кода на соответствие практикам безопасности для Python, JavaScript/TypeScript и Go и предлагает правки. CX Codex +1 390установок gh-address-comments Скилл gh-address-comments находит открытый PR текущей ветки, собирает комментарии ревью и правит код по тем, что вы выберете. CX Codex +1 ★ 7 191звёзд репо cloudflare-deploy Скилл cloudflare-deploy для Claude Code, который берёт на себя деплой приложений и инфраструктуры на Cloudflare через Workers, Pages и связанные сервисы. Активируется, когда нужно опубликовать, захостить или настроить проект на платформе. CX Codex +1 ★ 7 191звёзд репо web-design-guidelines Скилл web-design-guidelines проверяет интерфейсный код на соответствие Web Interface Guidelines. Помогает найти ошибки доступности, проблемные формы и сбои гидратации. CX Codex +1 ★ 7 191звёзд репо tlc-spec-driven Скилл tlc-spec-driven для Claude Code организует разработку фич через спецификацию, дизайн, задачи и исполнение. Работа идёт пошагово, с атомарными коммитами и проверкой требований тестами. CX Codex +1 1 300установок subagent-creator Скилл subagent-creator для Claude Code помогает описать субагента: файл с frontmatter, промпт, шаги и формат отчёта. Описывает субагента для задачи с отдельным контекстом. CX Codex +1 956установок technical-design-doc-creator Скилл technical-design-doc-creator помогает составить технический дизайн-документ (TDD, RFC, спеку) перед разработкой через интерактивные вопросы. Пригодится при согласовании архитектуры и миграций в команде. CX Codex +1 655установок domain-analysis Скилл domain-analysis разбирает кодовую базу на поддомены Core, Supporting и Generic и подсказывает, где провести границы сервисов. Пригодится перед распилом монолита. CX Codex +1 381установок

Ещё в каталоге

gbro-collage-broll akillness Скилл gbro-collage-broll для Claude Code превращает короткую реплику или абстрактную мысль в видео с бумажным коллажем и полутоновым эффектом. Сначала он предлагает метафору и готовит кадр, а после подтверждения генерирует ролик. CX Codex +1 100установок ux-ui-mastery podo Скилл-роутер по UX/UI: проверяет, установлен ли пакет Sumi, и при первом обращении доставляет его 45 тематических скиллов, от эвристик Нильсена до motion-дизайна. CX Codex +1 210установок customize официальный Anthropic Скилл customize для Claude Code меняет профиль практики по коммерческим договорам. Запускается, когда нужно поправить отдельную настройку без повторного стартового интервью. CX Codex +1 ★ 10 060звёзд репо frontend-enhancer travisjneuman Скилл frontend-enhancer для Claude Code доводит визуал веб-приложения: палитру, сетки, анимации и состояния компонентов. Помогает доработать интерфейс, который всё ещё выглядит как дефолтный шаблон. CX Codex +1 145установок

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

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