# figma-roundtrip

The figma-roundtrip skill for Claude Code syncs video motion-graphics kits with Figma boards. It ports layout and styling changes directly into Remotion components and brand tokens.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 470 repo stars
- Author: appariciojunior
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/appariciojunior/video-editor-skills/tree/HEAD/skills/figma-roundtrip/SKILL.md
- Updated: 2026-10-23
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/figma-roundtrip

## What it does

This tool bridges the gap between design drafts in Figma and the project's codebase, letting creators manage UI tokens visually. The agent tracks layer attributes, spacing, and font properties, porting updates into the repository and the `brand.json` file.

It requires the Figma MCP setup to read board states and variables defined in a 'Motion' collection. Before running the sync, ensure `figma-use` is loaded and the file key is recorded in `CLAUDE.md`.

The agent verifies visual consistency by rendering preview stills against existing boards. It handles both directions: moving Figma changes to code or updating out-of-date boards when the underlying component structure evolves.

## Requirements
- Works with: Figma

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add appariciojunior/video-editor-skills --skill figma-roundtrip -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/figma-roundtrip/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/figma-roundtrip/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add appariciojunior/video-editor-skills --skill figma-roundtrip -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/figma-roundtrip/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add appariciojunior/video-editor-skills --skill figma-roundtrip -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/figma-roundtrip/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install appariciojunior/video-editor-skills skills/figma-roundtrip
```

2. **Manually: put the files in place**
- File: `.github/skills/figma-roundtrip/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add appariciojunior/video-editor-skills --skill figma-roundtrip -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/appariciojunior/video-editor-skills --path skills/figma-roundtrip
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/figma-roundtrip/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/appariciojunior/video-editor-skills/tree/HEAD/skills/figma-roundtrip/SKILL.md

## When to use it
- Synchronize design tokens with codebase
- Port styling updates from Figma to Remotion
- Maintain consistent motion-graphics kits
- Validate code components against design boards

## Example prompts
- Update components based on Figma board changes
- Apply token changes from Figma to `brand.json`
- Sync the latest motion kit with the current codebase

## Similar
- [figma](https://affpapa.org/en/nevibecode/skills/heygen-com-figma.md) — skill · 466500 installs
- [understand-figma](https://affpapa.org/en/nevibecode/skills/understand-figma.md) — skill · 2400 installs
- [figma-codegen](https://affpapa.org/en/nevibecode/skills/figma-codegen.md) — skill · 1700 installs
- [figma-designer](https://affpapa.org/en/nevibecode/skills/figma-designer.md) — skill · 819 installs
- [figma-integration](https://affpapa.org/en/nevibecode/skills/figma-integration.md) — skill · 762 installs
- [pp-figma](https://affpapa.org/en/nevibecode/skills/pp-figma.md) — skill · 751 installs

From the same set: [appariciojunior/video-editor-skills](https://affpapa.org/en/nevibecode/by/appariciojunior/video-editor-skills.md) — 12 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
