Agent skill · data analytics · jeremylongshore
lokalise-debug-bundle
Collect Lokalise debug evidence for support tickets and troubleshooting.
Why this skill is useful
Adds a comprehensive script for collecting diagnostic information specific to Lokalise integration issues, which the AI wouldn't reliably generate on its own.
What it needs
Requires curl, jq 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 Debug Bundle Current State !node --version 2>/dev/null echo 'N/A' !python3 --version 2>/dev/null echo 'N/A' !uname -a Overview Collect all diagnostic information needed to troubleshoot Lokalise integration issues or file a support ticket — environment versions, SDK/CLI status, API connectivity, project listings with key counts, upload process status, and redacted logs, bundled into a timestamped .tar.gz archive. Prerequisites LOKALISEAPITOKEN environment variable set (or token available to provide) curl and jq available on PATH Optional: @lokalise/node-api SDK installed in current project Optional: lokalise2 CLI installed Instructions Step 1: Create the Bundle Directory Step 2: Collect Environment Information Step 3: Test API Connectivity Step 4: List Projects and Key Counts Step 5: Check File Upload Process Status Step 6: Collect and Redact Application Logs Step 7: Create the tar.gz Bundle Output lokalise-debug-YYYYMMDD-HHMMSS.tar.gz archive containing: environment.txt — Node.js, SDK, CLI versions, token status api-connectivity.txt — DNS, HTTPS latency, rate limit headers projects.json — Project list with key/language counts and progress processes.json — Recent file upload process statuses per project logs-redacted.txt — Relevant logs with tokens and emails scrubbed Error Handling Issue Cause Solution ------- ------- ---------- 401 Unauthorized Token invalid or expired Regenerate token in Lokalise > User Profile > API Tokens 403 Forbidden Token lacks read scope Use a read-write token or admin token 429 Too Many Requests Rate limit exceeded during project scan Script includes sleep 0.17 between calls; reduce --limit if still hitting Empty projects.json Token has no project access Verify the token owner is a contributor on at least one project nslookup fails DNS resolution blocked Try dig api.lokalise.com or check /etc/resolv.conf tar permission denied Bundle dir in read-only location Run from a writable directory like ~/tmp Examples Quick One-Liner API Heal …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/lokalise-debug-bundle--e01b84