New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Locize Sync

by Opentrons in Opentrons/opentrons

Locize i18n synchronization workflow for pushing and downloading translations in the Opentrons monorepo.

Apache-2.0Auto-check: notesFrontend & Design

Install Locize Sync

skills CLI
$ npx skills add Opentrons/opentrons --skill locize-sync -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Opentrons/opentrons locize-sync --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Opentrons/opentrons.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.cursor/skills/locize-sync .claude/skills/locize-sync && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
locize-sync
GitHub stars
523
Token cost
~728 tokens
SKILL.md length
259 words
Files
1
Skills in repo
17
Repo updated
First seen
Licence
Apache-2.0

At a glance

Locize i18n synchronization workflow for pushing and downloading translations in the Opentrons monorepo.

  • Works in 3 steps: Sync Script (scripts/locize_sync.py) —… → Localization Files → Authentication — LOCIZE_API_KEY and…
  • Working with locizesync.py
  • SKILL.md covers Overview, Architecture, Commands and Lint and Format the Script, plus 2 more sections
  • Calls uv, uvx and make; needs LOCIZE_API_KEY

What it does

Locize Sync is an agent skill from Opentrons/opentrons. Locize i18n synchronization workflow for pushing and downloading translations in the Opentrons monorepo. Use when working with locizesync.py, localization files in app/src/assets/localization/ or components/src/assets/localization/, or syncing translations.

Its SKILL.md is about 730 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Frontend & Design, covering Internationalization, Translation and Monorepo tooling. The repository describes itself as: Software for writing protocols and running them on the Opentrons Flex and Opentrons OT-2. The licence is Apache-2.0.

When your agent uses it

  • Working with locizesync.py
  • Localization files in app/src/assets/localization/
  • Components/src/assets/localization/
  • Syncing translations

Example prompts

  • “/locize-sync”

Requirements

  • Python 3
  • A credential in LOCIZE_API_KEY

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Sync Script (scripts/locize_sync.py) — Python script executed via uv run, two actions
  2. Localization Files
  3. Authentication — LOCIZE_API_KEY and LOCIZE_PROJECT_ID env vars (local .env or GitHub Actions secrets)

What it can do on your machine

Read from SKILL.md and the folder at commit adb4970. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • uv
    • uvx
    • make

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com
    • locize.app

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • LOCIZE_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Locize Sync loads about 728 tokens when it runs. Until then it costs about 68 tokens; SKILL.md has 259 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~68
When it runs · the whole SKILL.md, loaded when a task matches
~728

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:28
    and `LOCIZE_PROJECT_ID` env vars (local `.env` or GitHub Actions secrets)

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Opentrons/opentrons at commit adb4970, republished under its Apache-2.0 licence (© Opentrons). 259 words, ~728 tokens.

Download SKILL.mdSave it as .claude/skills/locize-sync/SKILL.md (or your agent's skills folder).
name
locize-sync
description
Locize i18n synchronization workflow for pushing and downloading translations in the Opentrons monorepo. Use when working with locize_sync.py, localization files in app/src/assets/localization/ or components/src/assets/localization/, or syncing translations.

Locize Synchronization Instructions

Overview

The Locize synchronization system manages internationalization (i18n) for the Opentrons monorepo. A unified Python script syncs localization files between the codebase and Locize cloud service.

Dry-Run Mode: All commands support --dry-run to preview actions without making changes.

Architecture

Core Components

  1. Sync Script (scripts/locize_sync.py) — Python script executed via uv run, two actions:

    • push-local: Upload local English and Chinese translations to Locize
    • download-remote: Download English and Chinese translations from Locize

  2. Localization Files

    • Primary: app/src/assets/localization/ — main application translations
    • Secondary: components/src/assets/localization/ — shared component translations
    • English (en) is the source of truth; Chinese (zh) is downloaded from Locize. Chinese (zh) files may be invisible to agents because of the repo's ignore rules.
    • The script consolidates files from components/ into app/ before syncing, then unconsolidates back

  3. Authentication — LOCIZE_API_KEY and LOCIZE_PROJECT_ID env vars (local .env or GitHub Actions secrets)

Commands

Push Local Translations (Source of Truth)
bash
uv run scripts/locize_sync.py push-local

Pushes English translations from repo to Locize. The script consolidates components/ JSON into app/, runs locize-cli sync, then unconsolidates and formats with make format-js.

When to use: After updating local English/Chinese strings, before handing to translators, to resolve drift.

Download Remote Translations (Overwrite Local)
bash
uv run scripts/locize_sync.py download-remote

Downloads English and Chinese translations from Locize, overwriting local files. Consolidates, downloads, unconsolidates, and formats.

When to use: After translators finish work, prior to release, to align with remote content.

Dry-Run Mode
bash
uv run scripts/locize_sync.py push-local --dry-run
uv run scripts/locize_sync.py download-remote --dry-run

Performs consolidation/unconsolidation to validate workspace, displays exact commands, but makes no remote changes.

Lint and Format the Script

bash
uvx ruff check --fix scripts/locize_sync.py && uvx ruff format scripts/locize_sync.py

CI/CD Integration

Store credentials in repository secrets: LOCIZE_API_KEY, LOCIZE_PROJECT_ID.

References

© Opentrons, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .cursor/skills/locize-sync of Opentrons/opentrons.

Open the folder on GitHubat commit adb4970

Compare with similar skills

Locize Sync next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Locize Sync compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Locize Sync this skillOpentrons/opentrons523—~728Automated safety check: NotesApache-2.0
Readme I18nY80/bmm3442 repos~1.9kAutomated safety check: PassMIT
I18n Lang FilesMes-Open/OpenMes153—~1.1kAutomated safety check: PassAGPL-3.0
Docs I18n TranslateComfy-Org/docs299—~3.2kAutomated safety check: NotesGPL-3.0
Chatbox i18n Translatorchatboxai/chatbox42k—~508Automated safety check: PassGPL-3.0
Internationalization Workflow with i18niOfficeAI/AionUi33k1 repos~1.9kAutomated safety check: PassApache-2.0

Similar skills

  • Readme I18n

    Y80/bmm

    A skill your agent uses when the user wants to translate a repository README, make a repo multilingual, localize docs, add a language switcher, internationalize the README, or update localized…

    344 GitHub starsUsed in 2 repos~1.9k tokens
    Frontend & DesignAuto-check passed

  • I18n Lang Files

    Mes-Open/OpenMes

    Editing or merging backend/lang/en.json and pl.json. An agent skill from Mes-Open/OpenMes.

    153 GitHub stars~1.1k tokensUpdated today
    Frontend & DesignAuto-check passed

  • Docs I18n Translate

    Comfy-Org/docs

    Translate ComfyUI Mintlify docs from English MDX to ja/zh/ko using translate-i18n.ts.

    299 GitHub stars~3.2k tokensUpdated today
    Frontend & DesignAuto-check: notes

  • Chatbox i18n Translator

    chatboxai/chatbox

    Translates new or changed i18n keys from a Chatbox Pro diff, staged changes or a commit range, writing the locale JSON files directly with a built-in glossary.

    42k GitHub stars~508 tokensUpdated 15 days ago
    Frontend & DesignAuto-check passed

  • Internationalization Workflow with i18n

    iOfficeAI/AionUi

    Standards for keeping all user-facing text translatable: read the i18n config first, use namespaced keys, reuse shared strings and follow the key naming rules.

    33k GitHub starsUsed in 1 repo~1.9k tokens
    Frontend & DesignAuto-check passed

  • Enforce Rules For I18n

    moeru-ai/airi

    Review pending AIRI translations on Crowdin in a batch, then sync them into the repository.

    50k GitHub stars~1.5k tokensUpdated today
    Frontend & DesignAuto-check passed

More from Opentrons/opentrons

All 17 skills in this repo

  • AI Client

    Opentrons/opentrons

    Conventions for the opentrons-ai-client React/TypeScript frontend — project structure, API integration, state management (Jotai), feature flags, types, and testing.

    523 GitHub stars~1.6k tokensUpdated today
    Auto-check passed

  • AI Server

    Opentrons/opentrons

    Conventions for the opentrons-ai-server FastAPI service — project structure, uv dependency management, settings, testing, Docker, and deployment.

    523 GitHub stars~2.5k tokensUpdated today
    Auto-check: notes

  • Analyses Snapshot Testing

    Opentrons/opentrons

    Conventions for the analyses snapshot testing framework in analyses-snapshot-testing/.

    523 GitHub stars~1.7k tokensUpdated today
    Auto-check passed

  • CSS Modules

    Opentrons/opentrons

    CSS Modules conventions, Stylelint rules, design tokens (spacing, colors, typography, border-radius), and patterns for the Opentrons monorepo.

    523 GitHub stars~2.2k tokensUpdated today
    Auto-check passed

  • Docs

    Opentrons/opentrons

    Authoring and styling guidelines for the Opentrons /docs MkDocs project.

    523 GitHub stars~2.8k tokensUpdated today
    Auto-check passed

  • E2E Testing

    Opentrons/opentrons

    E2E testing conventions for Protocol Designer and Labware Library using Playwright + pytest in e2e-testing/.

    523 GitHub stars~3k tokensUpdated today
    Auto-check: notes

Categories

Questions about Locize Sync

What does Locize Sync do?

Locize i18n synchronization workflow for pushing and downloading translations in the Opentrons monorepo. Locize Sync is an agent skill from Opentrons/opentrons. Locize i18n synchronization workflow for pushing and downloading translations in the Opentrons monorepo.

When should I use Locize Sync?

Locize Sync fits situations like: working with locizesync.py; localization files in app/src/assets/localization/; components/src/assets/localization/; syncing translations.

How do I install Locize Sync in Claude Code?

Run `npx skills add Opentrons/opentrons --skill locize-sync -a claude-code`. Or copy the skill folder (.cursor/skills/locize-sync in Opentrons/opentrons) into .claude/skills/locize-sync in your project. Claude Code loads it when a task matches its description.

How do I install Locize Sync in Codex?

Run `npx skills add Opentrons/opentrons --skill locize-sync -a codex`. Or copy the skill folder (.cursor/skills/locize-sync in Opentrons/opentrons) into .agents/skills/locize-sync in your project. Codex loads it when a task matches its description.

Can I use Locize Sync in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Opentrons/opentrons --skill locize-sync -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/locize-sync, .gemini/skills/locize-sync, .github/skills/locize-sync and .opencode/skills/locize-sync in your project.

What does Locize Sync need to run?

Going by SKILL.md and its folder, Locize Sync needs the command-line tools its instructions call (uv, uvx and make) and credentials named LOCIZE_API_KEY. Our summary lists: Python 3; A credential in LOCIZE_API_KEY.

Does Locize Sync access the network?

SKILL.md names 2 domains. As links in the text: github.com and locize.app. This is read from the text; nothing was executed.

Is Locize Sync safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Locize Sync use?

Locize Sync is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Locize Sync use?

About 728 tokens (SKILL.md is roughly 2.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Locize Sync?

Skills that share tags, products or a category with Locize Sync: Readme I18n (Y80/bmm, 344 stars), I18n Lang Files (Mes-Open/OpenMes, 153 stars), Docs I18n Translate (Comfy-Org/docs, 299 stars) and Chatbox i18n Translator (chatboxai/chatbox, 42k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Locize Sync?

Opentrons (a GitHub organization) maintains it in Opentrons/opentrons, which has 523 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 8, 2026.

Source: Opentrons/opentrons on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.