Agent skill · software engineering · jeremylongshore
lokalise-upgrade-migration
Analyze, plan, and execute Lokalise SDK upgrades with breaking change
Why this skill is useful
Adds executable scripts for upgrading the Lokalise SDK with breaking change detection and automated code transformation.
What it needs
Requires node, npm installed locally. About 5k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Lokalise Upgrade Migration Current State !npm list @lokalise/node-api 2>/dev/null grep lokalise echo 'SDK not installed' !lokalise2 --version 2>/dev/null echo 'CLI not installed' !node --version 2>/dev/null echo 'Node.js not available' !cat package.json 2>/dev/null grep -E '"type" "module"' echo 'No package.json type field' Overview Upgrade the @lokalise/node-api SDK between major versions with full breaking change detection, automated code transformation, and verification. The most significant migration is v8 (CommonJS) to v9+ (ESM-only), which requires changes to imports, module configuration, and potentially your build pipeline. Prerequisites Existing project using @lokalise/node-api (any version 6.x through 9.x) Node.js 18+ for SDK v9 (Node.js 14+ for v8 and below) Git repository with clean working tree (for safe rollback) Test suite that exercises Lokalise API calls Instructions Step 1: Assess Current Version and Target Step 2: Review Breaking Changes by Version Version Node.js Module System Key Breaking Changes --------- --------- --------------- --------------------- 9.x 18+ ESM only require() removed, import only. Pagination returns typed cursors. ApiError export path changed. 8.x 14+ CJS + ESM Last version supporting require(). Constructor accepts apiKey (not token). 7.x 14+ CJS Cursor pagination introduced. list() methods return paginated objects. 6.x 12+ CJS TypeScript rewrite. Method signatures changed from callbacks to promises. Step 3: Migrate Imports (v8 CJS to v9 ESM) This is the most impactful change. Every require() call must become an import. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/lokalise-upgrade-migration--42664d