figma-roundtrip — Claude Code skill: what it does, how to install
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.
no license ★ 470 updated 2026-10-23
npx skills add appariciojunior/video-editor-skills --skill figma-roundtrip -a claude-codeWhat figma-roundtrip 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.
What it helps with
- 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 for the agent
- Update components based on Figma board changes
- Apply token changes from Figma to
brand.json - Sync the latest motion kit with the current codebase
How to install figma-roundtrip
1Skills CLI (Vercel)
npx skills add appariciojunior/video-editor-skills --skill figma-roundtrip -a claude-code2Manually: put the files in place
~/.claude/skills/figma-roundtrip/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/figma-roundtrip/
1Skills CLI (Vercel)
npx skills add appariciojunior/video-editor-skills --skill figma-roundtrip -a codex2Manually: put the files in place
.agents/skills/figma-roundtrip/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add appariciojunior/video-editor-skills --skill figma-roundtrip -a cursor2Manually: put the files in place
.cursor/skills/figma-roundtrip/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install appariciojunior/video-editor-skills skills/figma-roundtrip2Manually: put the files in place
.github/skills/figma-roundtrip/SKILL.md1Skills CLI (Vercel)
npx skills add appariciojunior/video-editor-skills --skill figma-roundtrip -a gemini-cli2Platform CLI
gemini skills install https://github.com/appariciojunior/video-editor-skills --path skills/figma-roundtripManually: put the files in place
.devin/skills/figma-roundtrip/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about figma-roundtrip
How to install figma-roundtrip in Claude Code?
Run npx skills add appariciojunior/video-editor-skills --skill figma-roundtrip -a claude-code in your terminal.
What does figma-roundtrip do?
It keeps Figma design boards and code-based motion kits in sync by automatically porting design tweaks into component tokens and structures.
What is required for figma-roundtrip to work?
You need the Figma MCP, the figma-use skill loaded, a 'Motion' variable collection in Figma, and the file key documented in CLAUDE.md.