Agent skill · software engineering · jeremylongshore
lokalise-hello-world
Create a minimal working Lokalise example.
Why this skill is useful
Provides specific commands and patterns for integrating with the Lokalise API that the AI wouldn't reliably generate on its own.
What it needs
Requires @lokalise/node-api, lokalise2, node 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 Hello World Overview End-to-end walkthrough: list projects, create a test project, add keys, set translations across languages, and retrieve them. Covers both the Node SDK (@lokalise/node-api) and the CLI (lokalise2). Prerequisites Lokalise API token exported as LOKALISEAPITOKEN Node.js 18+ with @lokalise/node-api installed (npm i @lokalise/node-api) Lokalise CLI v2 installed (brew install lokalise2 or binary releases) Instructions 1. List all projects using the SDK and CLI. 1. Create a test project with three languages. 1. Add translation keys with their English (base language) translations in a single call. 1. Set translations for French and German by retrieving key IDs and updating each translation. 1. Retrieve and display all translations grouped by key. 1. Verify via CLI by listing keys and exporting translations. Output A new Lokalise project with 3 keys and translations in 3 languages Console output showing all key/translation pairs Exported JSON files in ./locales/ (if CLI step run) Error Handling Error Cause Solution ------- ------- ---------- 401 Unauthorized Invalid or expired API token Verify LOKALISEAPITOKEN is set and valid 400 Bad Request Missing required fields (e.g., keyname) Check payload matches API schema 404 Not Found Project ID does not exist Run project list to get correct ID 429 Too Many Requests Exceeded 6 req/sec rate limit Add 170ms delay between calls or batch operations Cannot find module SDK not installed Run npm i @lokalise/node-api Examples Minimal One-File Script CLI-Only Quick Test Resources Lokalise API Reference Projects API Keys API Translations API Node SDK Docs Next Steps Proceed to lokalise-local-dev-loop for development workflow setup, or lokalise-core-workflow-a for file upload and key management.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/lokalise-hello-world--bb68f9