alivirgo/Major-AI-Skills / plugins/mas-design-knowledge/skills/figma
figma
VerifiedBuild Figma plugins, export selected frames, audit components, and map variables to design tokens using the Plugin and REST APIs.
Figma Design Systems & Plugin AI Skill Guide (Claude)
Overview & Engine Architecture
Figma models Document → Pages → Nodes with Components, Variables, and Styles. Automation: Plugin API (in-editor sandbox) and REST API (CI, exports, metadata). Claude acts as Principal Design Systems Engineer: token extraction, batch PNG/SVG export, component audits, REST backoff.
Rate limits: Per-user PAT limits depend on seat and file's plan (Rate Limits docs). Tier 1 GET /v1/files/:key — e.g. Dev/Full on Professional ~10/min; Starter files can be ~6/month even if you have Enterprise elsewhere. 429 → honor Retry-After, exponential backoff (~60s).
┌─────────────────────────────────────────────────────────────┐
│ Plugin: figma.* sandbox (mutate live file) │
│ REST: X-Figma-Token → files / images / variables │
│ CI: cache file JSON; batch node IDs; respect tier limits │
└─────────────────────────────────────────────────────────────┘
When to use / when not to
Use when: design token sync, automated export of frames, design lint (detached instances), REST-driven previews in CI.
Do not use when: Pixel-perfect production video (use Remotion); heavy mutation at scale without Plugin (REST is read/export oriented); secrets in client-side plugin bundle.
Operational Capabilities & Agent Directives
- Plugin vs REST: Mutations → Plugin; scheduled export/metadata → REST
GET /v1/files/:key,GET /v1/images/:key?ids=&format=png&scale=2. - Token security: PAT in env
FIGMA_TOKENonly; Plugin usesfigma.clientStoragefor non-secret prefs; declarenetworkAccessinmanifest.jsonfor REST from UI iframe if needed. - Batch export: Chunk node IDs (REST image endpoint has payload limits); on 400 reduce batch size (large files timeout).
- Variables → tokens: Use Variables REST where licensed; map
modeId→ platform theme; stable semantic names (color.bg.default), not raw node IDs in CSS. - Deterministic export: Fixed
scale,format,svg_outline/svg_include_idflags; same file version (versionfield from file API) for golden diffs. - Traversal:
node.findAllWithCriteria— avoid hard-coded1:2paths that break on reorder.
Plugin: export selected frames (PNG @2x)
async function exportSelectionPng2x() {
const frames = figma.currentPage.selection.filter(
(n): n is FrameNode => n.type === "FRAME"
);
if (!frames.length) {
figma.notify("Select frames.");
return;
}
for (const frame of frames) {
const bytes = await frame.exportAsync({
format: "PNG",
constraint: { type: "SCALE", value: 2 },
});
figma.ui.postMessage({ type: "PNG", name: frame.name, bytes });
}
}
REST: image export with backoff
curl -s -H "X-Figma-Token: $FIGMA_TOKEN" \
"https://api.figma.com/v1/images/${FILE_KEY}?ids=${NODE_IDS}&format=png&scale=2"
On 429, sleep Retry-After header or 60s; retry max 5.
Failure taxonomy
| Symptom | Cause | Fix |
|---|---|---|
| 403 | Token scope / file access | Regenerate PAT with file_content read |
| 429 | Plan/seat/file tier | Backoff; move file to paid plan |
| 500 on images | Too many/large nodes | Smaller id batches |
| Detached instances | Local overrides | Audit plugin; re-instance |
| Plugin network blocked | manifest | networkAccess.allowedDomains |
Agent Operational Directive
MANDATORY: Never commit PATs. Chunk REST exports. Pin file
versionfor deterministic asset CI. Prefer Variables for tokens over hard-coded fills.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |