Agent skill · software engineering · jeremylongshore
anima-upgrade-migration
Analyze and execute @animaapp/anima-sdk upgrades with rollback evidence.
Why this skill is useful
Provides specific commands and workflows for upgrading and migrating the Anima SDK that the AI wouldn't reliably generate on its own.
What it needs
Requires npm installed locally. About 4k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Anima Upgrade & Migration Overview This workflow moves an Anima integration between SDK versions or from manual Figma exports to automation while preserving a reviewable, reversible design source of truth. It uses a pinned dependency and a staging canary so API or generated-code changes are detected before production output is replaced. Prerequisites A clean working tree, committed lockfile, current SDK version, and a reviewed changelog or release note for the proposed target version. A fixture registry containing synthetic or approved design nodes, expected output paths, and a baseline artifact digest for the current workflow. Separate staging credentials with read-only design access, an owner for generated-code review, and a rollback revision that can restore the prior SDK and generated output. CI gates for install, lint, type checking, tests, and secret scanning; do not test an upgrade against customer designs or live production writes. Migration Paths From To Complexity ------ ---- ----------- Figma plugin (manual) SDK automation Medium Older pinned SDK Explicit reviewed target Depends on release/type/generated-output diff Anima Playground SDK API Low Instructions Step 1: Upgrade SDK Step 2: Migrate from Manual Plugin to SDK Step 3: API Changes Checklist Error Handling Failure Required response --------- ------------------- Dependency resolution or lockfile changes are unexpected Stop the migration, inspect the dependency tree, and restore the approved lockfile before retrying. Authentication, file access, or API schema changes fail Keep the old revision active; verify credentials and supported request fields without widening access. Generated files move, disappear, or contain an unexpected diff Quarantine the output, compare against the baseline fixture, and require owner review before any merge. Lint, type, visual, or accessibility checks fail Do not promote the SDK; retain the sanitized test receipt and return the failure to the design/code owner. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/anima-upgrade-migration