Agent skill · software engineering · jeremylongshore
figma-data-handling
Handle Figma API data correctly: comments, versions, user data, and
Why this skill is useful
Adds executable scripts for interacting with the Figma API, including comments and version history management, which are not commonly known.
What it needs
Requires node installed locally. Requires figma account access. About 4k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Figma Data Handling Overview Work with Figma's data APIs: comments, version history, and user information. Handle sensitive data correctly with redaction and privacy compliance. Prerequisites FIGMAPAT with appropriate scopes (filecomments:read/write, fileversions:read) Understanding of GDPR/CCPA basics Instructions Step 1: Comments API Step 2: Version History API Step 3: User Data and Privacy Step 4: Data Retention Step 5: Safe Logging Output Comments fetched and posted via REST API Version history retrieved with pagination PII redacted before logging and storage Data retention policies applied Error Handling Error Cause Solution ------- ------- ---------- 403 on comments Missing filecomments:read scope Regenerate PAT with scope Empty version history New file with no saved versions Create a named version in Figma first PII in logs Missing redaction Apply safeFigmaLog wrapper Stale image URLs URLs older than 30 days Re-export images; do not cache URLs long-term Examples Pull the latest comments as Markdown and post a reaction (Step 1 Comments API): Walk version history with pagination (Step 2): PII rules for what you may persist from these payloads (user handles, avatars, emails): references/user-data-and-privacy.md and references/safe-logging.md. Resources Figma Comments Endpoints Figma Version History GDPR Developer Guide Next Steps For enterprise access control, see figma-enterprise-rbac.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/figma-data-handling--77d487