figma-api_skill

This skill helps you interact with the Figma REST API by guiding requests, authentication, and resource usage for files, components, and webhooks.

4

GitHub Stars

1

Bundled Files

2 months ago

Catalog Refreshed

4 months ago

First Indexed

Readme & install

Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.

Installation

Preview and clipboard use veilstrat where the catalogue uses aiagentskills.

npx veilstrat add skill yuyz0112/public-api-skills --skill figma-api

SKILL.md2.8 KB

Overview

This skill provides a complete OpenAPI specification for the Figma REST API so you can programmatically access files, components, comments, webhooks, analytics, and organization features. It organizes endpoints, operations, and JSON schemas for on-demand loading and integration. Use it to build integrations, automation, or tooling that interact with Figma content and teams.

How this skill works

The specification is split into resource, operation, and schema files that map directly to Figma API endpoints under https://api.figma.com. Authentication supports Personal Access Tokens, OAuth2, and Org OAuth2. To use an operation, locate the resource index, open the operation file for input/output details, and consult referenced schema files for parameter and response structures.

When to use it

Automate exporting or processing Figma file JSON and images.
Build integrations that sync components, styles, or variables with other systems.
Create bots that post or react to comments and thread updates.
Subscribe to or manage webhooks for team events and file changes.
Retrieve analytics for published libraries or audit organization activity.

Best practices

Use scoped OAuth or short-lived tokens for production integrations and refresh flows where supported.
Rate-limit requests and implement exponential backoff; large files and image exports can be heavy.
Prefer retrieving needed nodes or images rather than whole file dumps to reduce payload size.
Validate requests and responses against provided schemas to avoid mismatched fields.
Secure webhook endpoints and verify signatures to prevent unauthorized events.

Example use cases

Generate automated design documentation by fetching file JSON and rendering a catalog of components and styles.
Export images for a design system website by calling image endpoints for specific nodes at required scales.
Sync published components and styles into a design system registry or CMS using component and styles endpoints.
Monitor team activity and set up notifications by creating and consuming webhooks for file updates and comments.
Collect library usage analytics to prioritize maintenance and updates for high-impact components.

FAQ

Use OAuth2 for user-scoped integrations or Personal Access Tokens for simple server-to-server scripts; Org OAuth2 is appropriate for organization-level access where available.

Where do I find the schema for a specific operation response?

Open the operation file in the operations directory, which references schema files located under the schemas directory; use the referenced schema name to find exact fields and types.

Can I create and manage webhooks via the API?

Yes — the Webhooks resource supports creating, listing, and managing team webhooks; always validate webhook signatures and handle retry semantics.