Lokalise Skill Pack

Claude Code skill pack for Lokalise translation management — 24 skills covering the full localization lifecycle from SDK setup through production operations.

Installation

/plugin install lokalise-pack@claude-code-plugins-plus

What This Pack Does

Provides production-grade guidance for @lokalise/node-api SDK (ESM v9+), lokalise2 CLI, and the Lokalise REST API v2. Every skill contains real SDK code, real API endpoints, real error codes, and real webhook event names.

Skills

Getting Started (S01-S04)

| Skill | What It Does | |-------|-------------| | lokalise-install-auth | Install SDK/CLI, generate API tokens, verify connection | | lokalise-hello-world | Create project, add keys, set translations, export — end to end | | lokalise-local-dev-loop | Push/pull scripts, file watcher, mock translations, framework integration | | lokalise-sdk-patterns | Client singleton, cursor pagination, typed errors, batch ops, retry/rate-limit |

Core Workflows (S05-S08)

| Skill | What It Does | |-------|-------------| | lokalise-core-workflow-a | Upload source files, create/update keys, tag and bulk operations | | lokalise-core-workflow-b | Download translations, manage review status, contributors, file formats | | lokalise-common-errors | Diagnose 401/400/404/429/413/500 with curl commands and SDK error wrapper | | lokalise-debug-bundle | Collect env info, API connectivity, project stats, redacted logs into tar.gz |

Reliability (S09-S12)

| Skill | What It Does | |-------|-------------| | lokalise-rate-limits | Request queue (170ms spacing), exponential backoff, quota monitoring | | lokalise-security-basics | Token scoping, content sanitization, webhook secret verification, CI secrets | | lokalise-prod-checklist | 9-point pre-deploy checklist: coverage, keys, format, security, OTA, RBAC | | lokalise-upgrade-migration | SDK v8 CJS to v9 ESM migration, pagination changes, breaking change detection |

Pro (P13-P18)

| Skill | What It Does | |-------|-------------| | lokalise-ci-integration | GitHub Actions upload/download, PR translation checks, branch-based workflows | | lokalise-deploy-integration | Vercel/Netlify/Cloud Run deploy, OTA for iOS/Android, environment-specific bundles | | lokalise-webhooks-events | Create webhooks, handle 10+ event types, secret verification, idempotency | | lokalise-performance-tuning | Cursor pagination, local caching, batch ops, PQueue throttling, benchmarks | | lokalise-cost-tuning | Seat optimization, TM leverage, MT triage, dead key cleanup, spend monitoring | | lokalise-reference-architecture | Architecture diagram, project structure, OTA vs build-time, TypeScript types |

Flagship (F19-F24)

| Skill | What It Does | |-------|-------------| | lokalise-multi-env-setup | Dev/staging/prod isolation, secret management, promotion workflow | | lokalise-observability | API metrics, translation progress gauges, webhook monitoring, Prometheus alerts | | lokalise-incident-runbook | Quick diagnostics, 4 triage paths, fallback translations, communication templates | | lokalise-data-handling | Key metadata, snapshots, branches, export formats, encoding, plural forms | | lokalise-enterprise-rbac | Role hierarchy, language scoping, contributor groups, SSO, permission audit | | lokalise-migration-deep-dive | Migrate from Crowdin/Phrase/POEditor: export, transform, upload, validate |

Key Facts

| Fact | Value | |------|-------| | SDK | @lokalise/node-api v9+ (ESM) | | CLI | lokalise2 (Go binary) | | API Base | https://api.lokalise.com/api2 | | Rate Limit | 6 requests/second per token | | Max Keys Per Request | 500 | | File Upload | Async — returns process ID, poll until finished | | File Download | Returns S3 bundle URL (ZIP), valid ~30 minutes | | Webhook Timeout | 8 seconds — respond 200 immediately, process async | | Auth Header | X-Api-Token | | Webhook Auth | X-Secret header (random string, verify on every request) |

Usage

Skills activate automatically when you discuss Lokalise topics:

• "Help me set up Lokalise" activates lokalise-install-auth
• "Debug this Lokalise error" activates lokalise-common-errors
• "Set up CI for translations" activates lokalise-ci-integration
• "Handle Lokalise webhooks" activates lokalise-webhooks-events
• "Optimize Lokalise costs" activates lokalise-cost-tuning

License

MIT