Agent skill · writing content · jeremylongshore
anima-common-errors
Diagnose and fix common Anima SDK design-to-code errors.
Why this skill is useful
Provides specific troubleshooting steps and diagnostic scripts for common Anima SDK errors that the AI wouldn't generate on its own.
What it needs
Requires curl, jq installed locally. Requires anima, figma account access. About 4k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Anima Common Errors Overview Use this guide to diagnose design-to-code failures without widening design-file access or leaking tokens. Start from a reproducible file/node/settings tuple and use a least-privilege development credential for all verification. Prerequisites A sanitized error record with the design file identifier, node identifier, selected generation settings, timestamp, and request ID where available. Scoped Anima and Figma credentials held in a secret store; never paste a personal access token into a ticket, source file, or shared diagnostic log. A staging or disposable design fixture so fixes can be reproduced without mutating a production design file. Instructions 1. Classify the failure as authentication, file/node resolution, generator configuration, timeout/rate limit, or rendered-output quality. 2. Reproduce it with the smallest approved frame/component and the diagnostic commands, capturing only sanitized results. 3. Correct the matching design input, entitlement, or generation configuration and rerun only that fixture. 4. Validate the generated file location, lint/build result, and visual review before updating a broader component set. Error Reference Authentication Errors Error Root Cause Fix ------- ----------- ----- Invalid Anima token Token not provisioned or expired Request new token from Anima team Invalid Figma token PAT expired or revoked Generate new PAT: Figma > Settings > Access Tokens Unauthorized Token lacks file access Ensure Figma PAT has file read permission File & Node Errors Error Root Cause Fix ------- ----------- ----- File not found Wrong file key Extract from Figma URL: figma.com/file/{KEY}/... …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/anima-common-errors