OpenParable
Skip to content
← Back to skills

Anima Common Errors

Testing & Quality
anima-common-errors

Anima Common Errors is an Agent Skill for testing & quality published in the jeremylongshore/claude-code-plugins-plus-skills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Diagnose and fix common Anima SDK design-to-code errors. Use when encountering Figma token errors, code generation failures, node not found issues, or output quality problems. Trigger: "anima error", "anima not working", "anima debug", "figma to code error".

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/jeremylongshore/claude-code-plugins-plus-skills/blob/HEAD/plugins/saas-packs/anima-pack/skills/anima-common-errors/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/anima-common-errors, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Anima Common Errors

Error Reference

Authentication Errors

ErrorRoot CauseFix
Invalid Anima tokenToken not provisioned or expiredRequest new token from Anima team
Invalid Figma tokenPAT expired or revokedGenerate new PAT: Figma > Settings > Access Tokens
UnauthorizedToken lacks file accessEnsure Figma PAT has file read permission

File & Node Errors

ErrorRoot CauseFix
File not foundWrong file keyExtract from Figma URL: figma.com/file/{KEY}/...
Node not foundInvalid node IDCopy node link from Figma: right-click > Copy link
No renderable contentSelected a page or groupSelect a frame, component, or component set
Empty files arrayNode is empty or hiddenUnhide layers; ensure node has visible content

Code Generation Errors

// Common generation error handler
async function safeGenerate(anima: Anima, params: any) {
  try {
    return await anima.generateCode(params);
  } catch (err: any) {
    if (err.message?.includes('rate limit')) {
      console.error('Rate limited — wait 60s before retrying');
    } else if (err.message?.includes('timeout')) {
      console.error('Generation timed out — simplify the Figma node');
    } else if (err.message?.includes('Invalid settings')) {
      console.error('Invalid settings combo — check framework/styling/uiLibrary compatibility');
    } else {
      console.error('Generation error:', err.message);
    }
    return null;
  }
}

Output Quality Issues

SymptomCauseFix
Messy layoutNo auto-layout in FigmaConvert frames to auto-layout
Wrong colorsHardcoded hex instead of Figma variablesUse Figma color variables/styles
Missing textText is inside masked groupsFlatten masks before generating
Extra wrappersDeeply nested groupsFlatten group hierarchy
Wrong component namesUnnamed Figma layersName layers descriptively

Valid Settings Combinations

FrameworkLanguageStylingUI Library
reacttypescript, javascripttailwind, css, styled-componentsnone, mui, antd, shadcn
vuetypescript, javascripttailwind, cssnone
htmljavascriptcss, tailwindnone

Diagnostic Script

# Verify Figma token
curl -s "https://api.figma.com/v1/me" \
  -H "X-Figma-Token: ${FIGMA_TOKEN}" | jq '.handle // .err'

# Verify file access
curl -s "https://api.figma.com/v1/files/${FIGMA_FILE_KEY}" \
  -H "X-Figma-Token: ${FIGMA_TOKEN}" | jq '.name // .err'

Output

  • Error classified and root cause identified
  • Valid settings matrix for reference
  • Diagnostic commands for token and file verification

Resources

Next Steps

For collecting debug data, see anima-debug-bundle.