Agent skill · software engineering · jeremylongshore

lokalise-rate-limits

Implement Lokalise rate limiting, backoff, and request queuing patterns.

Why this skill is useful

Provides specific implementation patterns for handling rate limits and optimizing API requests for the Lokalise API that the AI wouldn't reliably generate on its own.

What it needs

Requires @lokalise/node-api installed locally. Requires lokalise account access. About 4k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.

What this skill does

Lokalise Rate Limits Overview Lokalise enforces a strict 6 requests per second rate limit across all API endpoints (https://api.lokalise.com/api2). Exceeding this triggers a 429 Too Many Requests response. This skill covers request queuing with 170ms minimum spacing, exponential backoff for 429 recovery, bulk operation throttling, and proactive quota monitoring via response headers. Prerequisites @lokalise/node-api SDK installed (npm install @lokalise/node-api) API token configured (read or read/write scope depending on operations) Node.js 18+ for native AbortController support in timeout handling Instructions 1. Understand the Rate Limit Headers Every Lokalise API response includes rate limit headers: Always read these headers. Never hardcode assumptions about the window — Lokalise may adjust limits per plan tier. 2. Implement a Request Queue with 170ms Spacing Space requests at minimum 170ms apart (1000ms / 6 = ~167ms, rounded up). Use p-queue for concurrency control: 3. Add Exponential Backoff for 429 Recovery When a 429 occurs, honor the Retry-After header first. If absent, use exponential backoff with jitter: 4. Throttle Bulk Operations For operations that process many items (listing all keys, bulk translations), paginate with built-in throttling: For bulk key creation, batch into groups of 500 (API limit per request) and queue each batch: 5. …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills jeremylongshore/lokalise-rate-limits

View the source on GitHub

Browse the @skills marketplace