Agent skill · software engineering · jeremylongshore
lokalise-sdk-patterns
Apply production-ready Lokalise SDK patterns for TypeScript and Node.js.
Why this skill is useful
Provides specific TypeScript and Node.js patterns for integrating with the Lokalise SDK that are not widely known.
What it needs
Requires @lokalise/node-api installed locally. About 6k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Lokalise SDK Patterns Overview Production-grade patterns for @lokalise/node-api: client singleton, cursor pagination, typed error handling, batch operations, upload monitoring, and retry with rate limiting. Prerequisites @lokalise/node-api v12+ installed TypeScript 5+ with strict mode Instructions 1. Create a client singleton to centralize configuration and support branch-based project IDs. 1. Build a cursor-based pagination helper that works with any paginated endpoint. Usage: 1. Wrap API calls with structured error handling that classifies retryable errors. 1. Batch key operations that chunk requests to respect the 500-key-per-request limit. 1. Upload files with async process monitoring and progress callbacks. Usage: 1. Add a retry decorator with exponential backoff and a rate limiter for sequential calls. Usage: Output Singleton client with compression and branch support Async generator for memory-efficient cursor pagination Type-safe error wrapper with isRetryable classification Batch create/delete respecting 500-key API limit File upload with process polling and progress callbacks Retry with exponential backoff + rate limiter at 6 req/sec Error Handling Pattern When to Use Behavior --------- ------------ ---------- apiCall() Every SDK call Converts to typed LokaliseError with isRetryable withRetry() Rate limits or transient failures Exponential backoff, retries 429 and 5xx only rateLimited() Sequential bulk calls Enforces 170ms minimum spacing paginate() Fetching all keys/translations Built-in 170ms delay between pages batchCreateKeys() Creating > 500 keys 500-key chunks with 500ms spacing uploadWithProgress() File uploads Polls process status with 2-minute timeout Examples Combining All Patterns Resources Node SDK Documentation Pagination Guide API Rate Limits API Error Codes Branching Next Steps Apply these patterns in lokalise-core-workflow-a and lokalise-core-workflow-b for real-world usage.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/lokalise-sdk-patterns--7ae3fe