figma-variant-matrix

Define complete Figma variant matrices with properties, states, anatomy, and token mapping.

1|Updated May 22, 2026
One-click install
npx skills add https://github.com/spontus-reach/spontus --skill figma-variant-matrix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: figma-variant-matrix
Source: https://github.com/spontus-reach/spontus/tree/main/.agents/skills/figma-variant-matrix
Command: npx skills add https://github.com/spontus-reach/spontus --skill figma-variant-matrix

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents late discovery of missing component variants and states after a UI has already been used across multiple screens.

Core Features & Use Cases

  • Variant planning for Figma properties: Defines component variant properties (e.g., type, size, state, icon slot) and organizes the full combination space.
  • State deltas and layer guidance: Specifies what changes per state (hover, active, disabled, loading, error) and encourages layer-level changes rather than broad opacity tweaks.
  • Implementation-ready structure: Produces an anatomy breakdown and token mapping so the component can be built consistently in a design system.

Quick Start

Ask for a complete Figma variant matrix by providing the component name, its purpose, the platform, and whether it’s standalone or part of an existing design system.

Frequently Asked Questions about figma-variant-matrix

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

FAQPage Schema
How do I plan all Figma component variants before building the UI?

To plan Figma component variants before building, define a complete variant matrix by enumerating properties, state definitions, anatomy, and token mapping for your UI component. This prevents late discovery of missing component states across multiple screens.

What is a Figma variant matrix and when do I need one?

A Figma variant matrix defines the full combination space of component properties, state deltas, and token mappings. You need one when planning component variants for design system building blocks like Buttons, Cards, and Inputs to ensure implementation without missing combinations.

How do I map design tokens to component states in Figma?

To map design tokens to component states in Figma, specify what changes per state such as hover, active, disabled, loading, and error. The variant matrix outputs an anatomy breakdown and token mapping encouraging layer-level changes rather than broad opacity tweaks.

Can I use a variant matrix for UI components across multiple platforms?

Yes, you can generate a variant matrix for UI components across one or more platforms. Provide the component name, purpose, platform, and design-system context to output a comprehensive set of properties and visual deltas suitable for cross-platform implementation.

What information do I need to provide to generate a complete Figma variant matrix?

You need to provide component metadata including the component name, its purpose, the target platform, and whether it is standalone or part of an existing design system. This inputs outputs a comprehensive set of variant properties and visual deltas.

Why am I discovering missing component states after using my UI across multiple screens?

Missing component states are discovered late because variant properties and state definitions were not fully enumerated before implementation. Defining a complete Figma variant matrix with anatomy breakdowns and token mapping beforehand prevents these gaps across screens.