Skip to main content
figma-core-workflow-a Extract design tokens, colors, typography, and spacing from Figma files via REST API.
Use when building a design-to-code pipeline, syncing design tokens,
or extracting styles from a Figma design system file.
Trigger with phrases like "figma design tokens", "extract figma styles",
"figma to CSS", "sync figma colors", "figma typography".
Zur Installation springen Skills Marktplatz Entdecken und erkunden Sie KI-Skills, die von der Community erstellt wurden.
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Prompt-Details anzeigen Ein direkter Befehl überspringt den Prüf-Prompt. Prüfen Sie die Quelle, bevor Sie ihn ausführen.
npx skills add https://github.com/jeremylongshore/claude-code-plugins-plus-skills --skill figma-core-workflow-aDer Befehl bleibt in einer Zeile. Scrollen Sie horizontal, um ihn vor dem Kopieren vollständig zu prüfen.
Sie bevorzugen eine lokale Kopie? Laden Sie die Dateien herunter, die SkillsMP derzeit vorliegen.
ZIP herunterladen Herunterladen... Mehr aus diesem Repository
Verwandte Berufe SOC
Basierend auf der SOC-Berufsklassifikation
name figma-core-workflow-a description Extract design tokens, colors, typography, and spacing from Figma files via REST API.
Use when building a design-to-code pipeline, syncing design tokens,
or extracting styles from a Figma design system file.
Trigger with phrases like "figma design tokens", "extract figma styles",
"figma to CSS", "sync figma colors", "figma typography".
allowed-tools Read, Write, Edit, Bash(npm:*), Bash(node:*), Grep version 1.6.0 license MIT author Jeremy Longshore <jeremy@intentsolutions.io> tags ["saas","figma"] compatibility Designed for Claude Code
Figma Core Workflow A -- Design Token Extraction
Overview
The primary workflow for Figma API integrations: extracting design tokens (colors, typography, spacing) from a Figma file and converting them to CSS custom properties, JSON tokens, or Tailwind config.
Prerequisites
Completed figma-install-auth setup
A Figma file with published styles or variables
FIGMA_PAT and FIGMA_FILE_KEY env vars set
Instructions
Step 1: Fetch Styles from a File
import { FigmaClient } from './figma-client' ;
const client = new FigmaClient (process.env .FIGMA_PAT !);
const fileKey = process.env .FIGMA_FILE_KEY !;
const file = await client.getFile (fileKey);
const colorStyles = Object .entries (file.styles )
.filter (([, s] ) => s.style_type === 'FILL' )
.map (([nodeId, s] ) => ({ nodeId, name : s.name }));
const textStyles = Object .entries (file.styles )
.filter (([, s] ) =>
style_type
'TEXT'
map
([nodeId, s] ) =>
name
name
console
log
`Found ${colorStyles.length} color styles, ${textStyles.length} text styles`
Step 2: Resolve Style Values from Nodes
const styleNodeIds = colorStyles.map (s =>nodeId );
const nodesResponse = await client.getFileNodes (fileKey, styleNodeIds);
interface DesignToken {
name : string ;
type : 'color' | 'typography' | 'spacing' ;
value : string ;
}
const tokens : DesignToken [] = [];
for (const [nodeId, nodeData] of Object .entries (nodesResponse.nodes )) {
const node = nodeData.document ;
const styleName = colorStyles.find (s =>nodeId === nodeId)?.name ;
if (node.fills ?.[0 ]?.type === 'SOLID' && node.fills [0 ].color ) {
const { r, g, b, a } = node.fills [0 ].color ;
const hex = '#' + [r, g, b].map (v =>Math .round (v * 255 ).toString (16 ).padStart (2 , '0' )
).join ('' );
tokens.push ({
name : styleName ?? node.name ,
type : 'color' ,
value : a !== undefined && a < 1
? `rgba(${Math .round(r*255 )} , ${Math .round(g*255 )} , ${Math .round(b*255 )} , ${a.toFixed(2 )} )`
: hex,
});
}
}
Step 3: Extract Typography Tokens
const textNodeIds = textStyles.map (s =>nodeId );
const textNodes = await client.getFileNodes (fileKey, textNodeIds);
for (const [nodeId, nodeData] of Object .entries (textNodes.nodes )) {
const node = nodeData.document ;
const styleName = textStyles.find (s =>nodeId === nodeId)?.name ;
if (node.style ) {
tokens.push ({
name : styleName ?? node.name ,
type : 'typography' ,
value : JSON .stringify ({
fontFamily : node.style .fontFamily ,
fontSize : `${node.style.fontSize} px` ,
fontWeight : node.style .fontWeight ,
lineHeight : node.style .lineHeightPx
? `${node.style.lineHeightPx} px`
: 'normal' ,
letterSpacing : node.style .letterSpacing
? `${node.style.letterSpacing} px`
: '0' ,
}),
});
}
}
Step 4: Generate CSS Custom Properties function tokensToCss (tokens : DesignToken []string {
const lines = [':root {' ];
for (const token of tokens) {
const varName = `--${token.name.toLowerCase().replace(/[\s/]+/g, '-' )} ` ;
if (token.type === 'color' ) {
lines.push (` ${varName} : ${token.value} ;` );
} else if (token.type === 'typography' ) {
const t = JSON .parse (token.value );
lines.push (` ${varName} -family: ${t.fontFamily} ;` );
lines.push (` ${varName} -size: ${t.fontSize} ;` );
lines.push (` ${varName} -weight: ${t.fontWeight} ;` );
}
}
lines.push ('}' );
return lines.join ('\n' );
}
import { writeFileSync } from 'fs' ;
writeFileSync ('src/styles/tokens.css' , tokensToCss (tokens));
console .log (`Generated ${tokens.length} tokens to src/styles/tokens.css` );
Step 5: Use Variables API (Enterprise)
const vars = await client.getLocalVariables (fileKey);
for (const [id, variable] of Object .entries (vars.meta .variables )) {
const collection = vars.meta .variableCollections [variable.variableCollectionId ];
console .log (`${collection.name} /${variable.name} : ${variable.resolvedType} ` );
for (const [modeId, value] of Object .entries (variable.valuesByMode )) {
const modeName = collection.modes .find (m =>modeId === modeId)?.name ;
console .log (` ${modeName} : ${JSON .stringify(value)} ` );
}
}
Output
Design tokens extracted from Figma styles or variables
CSS custom properties file generated
Color values converted from Figma's 0-1 float format to hex/rgba
Typography properties mapped to CSS-compatible values
Error Handling Error Cause Solution Empty styles map File has no published styles Publish styles in Figma first null node in responseNode was deleted Filter nulls before processing 403 on variables endpoint Not Enterprise plan Use styles endpoint instead Color looks wrong Forgot 0-1 to 0-255 conversion Multiply by 255 before hex
Examples Extract every fill color used by published styles and emit CSS custom properties:
curl -s -H "X-Figma-Token: ${FIGMA_PAT} " \
"https://api.figma.com/v1/files/${FIGMA_FILE_KEY} /styles" \
| jq -r '.meta.styles[] | select(.style_type == "FILL") | "\(.node_id)\t\(.name)"'
1:5 Color/Brand/Primary
1:6 Color/Brand/Secondary
1:9 Color/Neutral/100
Feed those node IDs to /v1/files/:key/nodes?ids=... and run the Step 4 generator to produce:
:root {
--color-brand-primary : #4f46e5 ;
--color-brand-secondary : #22d3ee ;
--color-neutral-100 : #f5f5f5 ;
}
Full token-extraction walkthrough: references/extract-typography-tokens.md and references/generate-css-custom-properties.md.
Resources
Next Steps For asset export, see figma-core-workflow-b.
