Installs into .claude/skills of the current project.
Are you the author of Figma Expert?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/aicodedecode-figma-expert)
---
name: figma-expert
description: Master Figma workflows with auto layout, components, variables, prototyping, and team collaboration.
category: creative-design
---
## Overview
Figma rewards systematic thinking: designers who master auto layout, components,
and variables
design 3x faster and hand off cleaner files. This skill covers the professional
Figma workflow —
from file organization and component architecture to variables, prototyping, and
developer handoff —
plus the collaboration habits that keep team files healthy.
## When to use
- Setting up a new Figma file or design system library
- Building responsive layouts with auto layout
- Creating and managing component variants
- Using variables for theming (light/dark mode, brands)
- Prototyping interactions and preparing dev handoff
## Core concepts
- - - **Auto layout is the foundation.** Frames that resize with content
(padding, gaps, direction,
wrapping) make designs responsive by default and components bulletproof. Learn
it before anything
else — it changes how you think about layout.
- - - **Components with variants.** One component, many states
(default/hover/disabled;
small/medium/large) via variant properties. Boolean properties for toggles
like icons.
Well-architected variants eliminate dozens of duplicate components.
- - - **Variables for theming.** Color, spacing, radius, and typography
variables enable instant theme
switching and multi-brand systems. Use modes for light/dark; collections for
semantic grouping
(e.g., "surface/primary" not "gray-100").
- - - **File hygiene.** Named pages (Cover, Components, Flows, Archive),
consistent frame naming, no
stray layers. A messy file slows everyone and signals sloppy thinking to
developers.
- - - **Prototype with intent.** Prototype the flows that need validation or
handoff clarity — not the
entire app. Smart animate for realistic transitions; keep interactions
purposeful.
- - - **Dev Mode done right.** Mark sections "ready for dev," document behaviors
in situ, link to
tickets. The handoff file should answer questions before developers ask them.
## Practical workflow
1. 1. 1. **Set up the file.** Pages: Cover (thumbnail + status), Foundations
(styles/variables),
Components (library), Designs (flows by feature), Archive. Set up color and
text styles or
variables first.
2. 2. 2. **Build with auto layout.** Every card, button, list, and page section
uses auto layout. Set
hug/fill/fixed deliberately. Test responsiveness by dragging frame edges — it
should behave, not
break.
3. 3. 3. **Create the component architecture.** Atoms (buttons, inputs, badges)
→ molecules (cards,
list items) → organisms (headers, modals). Variants for states and sizes;
keep the default
variant the most common use.
4. 4. 4. **Apply variables.** Convert hard-coded colors to semantic variables.
Set up light/dark modes
if needed. Typography: define a scale (not 47 text styles) and stick to it.
5. 5. 5. **Design the flows.** One flow per user journey, clearly labeled, with
annotations for edge
cases and behaviors. Use sections to group related screens.
6. 6. 6. **Prototype key interactions.** Connect the critical paths; add
micro-interactions where
motion communicates (loading, success, transitions). Keep it focused —
prototype to answer
questions.
7. 7. 7. **Prepare handoff.** Mark ready sections, add measurements/notes for
tricky behaviors, clean
up hidden layers, and walk through with developers. The file is done when a
developer can build
from it without pinging you.
## Common pitfalls
- - - **Detaching instances.** Detaching "just this once" creates divergence
that compounds. Fix the
component instead — that's what variants and properties are for.
- - - **Hard-coded values everywhere.** Colors and spacing typed manually in 200
places. One rebrand
later, you're doing find-and-replace for a week. Variables from day one.
- - - **Variant explosion.** 40 variants of a button because properties weren't
planned. Design the
property matrix first (size × state × style), then build.
- - - **No responsive behavior.** Fixed-size frames that break on different
screens. Auto layout +
constraints should handle the common breakpoints.
- - - **Prototype everything.** Spending days prototyping flows nobody
questioned. Prototype to learn
or to specify — otherwise it's expensive theater.
- - - **The junk-drawer file.** Unnamed layers ("Rectangle 47"), dead pages,
duplicate components. Ten
minutes of weekly cleanup saves hours of confusion.