Bidirectional Design Token Sync

Synchronize design tokens bidirectionally between Figma and code with drift detection.

9|2|Updated Jan 9, 2026
One-click install
npx skills add https://github.com/flight505/storybook-assistant --skill bidirectional-design-token-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Bidirectional Design Token Sync
Source: https://github.com/flight505/storybook-assistant/tree/main/skills/design-token-sync
Command: npx skills add https://github.com/flight505/storybook-assistant --skill bidirectional-design-token-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @figma/rest-api-client, style-dictionary, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Keeping design tokens synchronized between Figma and your codebase is error-prone and time-consuming when changes occur in either environment. This skill provides bidirectional sync with automatic drift detection and conflict resolution to maintain a single source of truth for your design system.

Core Features & Use Cases

  • Bidirectional sync: Changes in Figma propagate to code and updates in code propagate back to Figma with conflict resolution.
  • Drift detection & intelligent merging: Detect differences and apply safe, deterministic updates.
  • Tooling integration: Compatible with the Figma API and Style Dictionary to generate CSS, SCSS, and TS tokens ready for production.

Quick Start

Step-by-step guidance:

  • Configure your Figma file URL and access token; choose token location (Local Variables or Shared Variables).
  • Run the initial sync: npm run tokens:sync.
  • Review drift, apply changes, and commit updated tokens and generated assets.

Frequently Asked Questions about Bidirectional Design Token Sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep design tokens in sync between Figma and code?

Bidirectional design token sync automatically propagates changes between Figma and your codebase. It detects drift and applies conflict resolution to maintain a single source of truth for your design system.

How does drift detection work for design system tokens?

Drift detection identifies differences between Figma variables and code token files. The skill applies safe, deterministic updates to intelligently merge changes without overwriting unsynchronized edits.

Can I generate CSS and SCSS tokens from Figma variables using Style Dictionary?

Yes, this skill integrates with Style Dictionary to generate CSS, SCSS, and TS tokens from Figma variables. It outputs production-ready assets after synchronizing the design tokens.

What's the best way to resolve conflicts when updating design tokens in both Figma and code?

Bidirectional sync provides automatic conflict resolution by applying deterministic merge rules. It ensures safe updates when design tokens are edited simultaneously in Figma and code.

Do I need the Figma REST API to synchronize local and shared variables with code?

Yes, the skill uses the Figma REST API client to access Local Variables or Shared Variables. Configuring your Figma file URL and access token is required to run the synchronization.