Agent skill

Localize

Localize ryOS apps and components by extracting hardcoded strings, replacing with translation keys, and syncing across languages.

AGPL-3.0Auto-check passedWriting & Content

Install Localize

skills CLI

$ npx skills add ryokun6/ryos --skill localize -a claude-code

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

GitHub CLI

$ gh skill install ryokun6/ryos localize --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/ryokun6/ryos.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.cursor/skills/localize .claude/skills/localize && 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/

Paste into Claude Code

Install the "localize" agent skill from https://github.com/ryokun6/ryos/tree/main/.cursor/skills/localize into .claude/skills/localize/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "localize", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/ryokun6/ryos/tree/main/.cursor/skills/localize

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add ryokun6/ryos --skill localize -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install ryokun6/ryos localize --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ryokun6/ryos.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.cursor/skills/localize .agents/skills/localize && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "localize" agent skill from https://github.com/ryokun6/ryos/tree/main/.cursor/skills/localize into .agents/skills/localize/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "localize", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add ryokun6/ryos --skill localize -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install ryokun6/ryos localize --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ryokun6/ryos.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.cursor/skills/localize .cursor/skills/localize && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "localize" agent skill from https://github.com/ryokun6/ryos/tree/main/.cursor/skills/localize into .cursor/skills/localize/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "localize", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/ryokun6/ryos.git --path .cursor/skills/localize

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add ryokun6/ryos --skill localize -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install ryokun6/ryos localize --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ryokun6/ryos.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.cursor/skills/localize .gemini/skills/localize && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "localize" agent skill from https://github.com/ryokun6/ryos/tree/main/.cursor/skills/localize into .gemini/skills/localize/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "localize", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install ryokun6/ryos localize

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add ryokun6/ryos --skill localize -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/ryokun6/ryos.git skills-src && mkdir -p .github/skills && cp -r skills-src/.cursor/skills/localize .github/skills/localize && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "localize" agent skill from https://github.com/ryokun6/ryos/tree/main/.cursor/skills/localize into .github/skills/localize/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "localize", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add ryokun6/ryos --skill localize -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install ryokun6/ryos localize --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ryokun6/ryos.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.cursor/skills/localize .opencode/skills/localize && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "localize" agent skill from https://github.com/ryokun6/ryos/tree/main/.cursor/skills/localize into .opencode/skills/localize/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "localize", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: localize
GitHub stars: 1.3k
Token cost: ~1.2k tokens
SKILL.md length: 332 words
Files: 1
Skills in repo: 10
Repo updated: Oct 7, 2026
First seen: Oct 7, 2026
Licence: AGPL-3.0

At a glance

Localize ryOS apps and components by extracting hardcoded strings, replacing with translation keys, and syncing across languages.

Works in 6 steps: Extract Hardcoded Strings → Replace Strings with t() Calls → Add English Translations → …
Localizing an app
SKILL.md covers Workflow Checklist, Step 1: Extract Hardcoded…, Step 2: Replace Strings with… and Step 3: Add English Translations, plus 5 more sections
Calls bun; needs GOOGLE_GENERATIVE_AI_API_KEY

What it does

Localize is an agent skill from ryokun6/ryos. Localize ryOS apps and components by extracting hardcoded strings, replacing with translation keys, and syncing across languages. Use when localizing an app, adding i18n support, translating UI text, or working with translation files.

Its SKILL.md is about 1.2k 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 Writing & Content, covering Translation and Internationalization. The repository describes itself as: ryOS, made with Cursor. The licence is AGPL-3.0.

When your agent uses it

Localizing an app
Adding i18n support
Translating UI text
Working with translation files

Example prompts

“/localize”

Requirements

A credential in GOOGLE_GENERATIVE_AI_API_KEY

Workflow steps

6 steps, taken from the step headings in SKILL.md.

Extract Hardcoded Strings
Replace Strings with t() Calls
Add English Translations
Sync Across Languages
Machine Translate
Validate

What it can do on your machine

Read from SKILL.md and the folder at commit 4a6e61e. 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:
- bun
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- GOOGLE_GENERATIVE_AI_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Localize loads about 1.2k tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 332 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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 ryokun6/ryos at commit 4a6e61e, republished under its AGPL-3.0 licence (© ryokun6). 332 words, ~1,158 tokens.

Download SKILL.mdSave it as .claude/skills/localize/SKILL.md (or your agent's skills folder).

name: localize
description: Localize ryOS apps and components by extracting hardcoded strings, replacing with translation keys, and syncing across languages. Use when localizing an app, adding i18n support, translating UI text, or working with translation files.

Localize App or Component

Workflow Checklist

- [ ] 1. Extract hardcoded strings
- [ ] 2. Replace with t() calls in source files
- [ ] 3. Add English translations to en/translation.json
- [ ] 4. Sync translations across languages
- [ ] 5. Machine translate [TODO] keys
- [ ] 6. Validate coverage and terminology

Step 1: Extract Hardcoded Strings

bash

bun run i18n:extract --pattern [PATTERN]

Step 2: Replace Strings with t() Calls

For each component:

Add import: import { useTranslation } from "react-i18next";
Add hook: const { t } = useTranslation();
Replace strings: t("apps.[appName].category.key")
Add t to dependency arrays for useMemo/useCallback

Key Structure

apps.[appName].menu.*        # Menu labels
apps.[appName].dialogs.*     # Dialog titles/descriptions
apps.[appName].status.*      # Status messages
apps.[appName].toasts.*      # Toast titles/descriptions
apps.[appName].empty.*       # Empty-state titles/hints
apps.[appName].ariaLabels.*  # Accessibility labels
apps.[appName].help.*        # Help items (auto-translated)
apps.[appName].speech.*      # Spoken feedback / speech labels
apps.[appName].conversion.*  # Unit conversion labels
apps.[appName].angle.*       # Angle-mode labels
common.auth.*                # Shared login/signup/recovery dialog labels

Common Patterns

tsx

// Basic
t("apps.ipod.menu.file")

// With variables
t("apps.ipod.status.trackCount", { count: 5 })

// Conditional
isPlaying ? t("pause") : t("play")

// With symbol prefix
`✓ ${t("apps.ipod.menu.shuffle")}`

Step 3: Add English Translations

Add to src/lib/locales/en/translation.json:

json

{
  "apps": {
    "ipod": {
      "menu": { "file": "File", "addSong": "Add Song..." },
      "dialogs": { "clearLibraryTitle": "Clear Library" },
      "status": { "shuffleOn": "Shuffle ON" }
    }
  }
}

Do not rely on defaultValue as the only copy of a new key. t("some.key", { defaultValue: "English" }) renders, but sync and audit scripts only compare locale JSON files, so missing keys stay invisible until the English catalog contains them.

Use Apple-style title casing for standalone English menu and control labels, such as Repeat All, Repeat One, Sign In, and Main Volume. When a casing or terminology rule should be enforced globally, add the key to ENGLISH_STYLE_EXPECTATIONS in scripts/apple-ui-terminology.ts and cover it with tests/unit/i18n/test-translation-audit.test.ts.

Step 4: Sync Across Languages

bash

bun run i18n:sync:mark-todo

Adds missing keys to all 11 language files, marked with [TODO].

Step 5: Machine Translate

bash

bun run i18n:translate

Requires GOOGLE_GENERATIVE_AI_API_KEY env variable.

Step 6: Validate

bash

bun run i18n:sync:dry-run
bun run i18n:audit
bun run i18n:find-untranslated

Use bun run i18n:audit:fix only for terminology drift the script can safely repair, then rerun bun run i18n:audit. When audit reports glossary mismatches that are not auto-fixable, edit the affected locale JSON values by hand and rerun the audit.

Component Guidelines

Component	What to translate
Menu bars	All labels, items, submenus
Dialogs	Titles, descriptions, button labels
Status	`showStatus()` calls and inline state labels
Toasts / empty states	Sonner toast copy, empty-state titles, empty-state hints
Help items	Auto-translated via `useTranslatedHelpItems`
Shared auth dialogs	`common.auth.*`, for login/signup/password recovery copy

Notes

Emoji/symbols (♪, ✓) can stay hardcoded
Help items use pattern: apps.[appName].help.[key].title/description
Help item key order lives in src/hooks/useTranslatedHelpItems.ts; apps with longer localized help rows can export their key list (for example src/apps/maps/helpKeys.ts, src/apps/calculator/helpKeys.ts, or src/apps/internet-explorer/helpKeys.ts) and spread it into APP_HELP_I18N_KEYS
tests/unit/i18n/test-help-i18n-alignment.test.ts covers every registered app; update it only if the global help-key contract changes
Include t in dependency arrays when used in useMemo/useCallback
If Apple terminology changes upstream, refresh the glossary source with bun run i18n:apple-glossary before auditing locale copy

Files

Just SKILL.md in .cursor/skills/localize of ryokun6/ryos.

Open the folder on GitHubat commit 4a6e61e

Compare with similar skills

Localize 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.

Localize compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Localize this skillryokun6/ryos	1.3k	—	~1.2k	Automated safety check: Pass	AGPL-3.0	today
Translation Diff ExportDevolutions/UniGetUI	26k	—	~1.1k	Automated safety check: Pass	MIT	today
Translation Diff TranslateDevolutions/UniGetUI	26k	—	~934	Automated safety check: Pass	MIT	today
Plane UI Translationmakeplane/plane	61k	—	~16k	Automated safety check: Pass	AGPL-3.0	today
Translatetagspaces/tagspaces	5.3k	—	~2.2k	Automated safety check: Pass	AGPL-3.0	yesterday
Translation Source SyncDevolutions/UniGetUI	26k	—	~1.2k	Automated safety check: Pass	MIT	today

Similar skills

Translation Diff Export
Devolutions/UniGetUI
Compares UniGetUI JSON locale files against English, identifies untranslated or source-changed keys, and generates patch, reference, and handoff files for a target language.
26k GitHub stars~1.1k tokensUpdated today
Writing & ContentAuto-check passed
Translation Diff Translate
Devolutions/UniGetUI
Translates a sparse UniGetUI JSON language patch, writes completed entries into the working copy, preserves placeholders and terminology, and prepares the patch for merge-back.
26k GitHub stars~934 tokensUpdated today
Writing & ContentAuto-check passed
Plane UI Translation
makeplane/plane
Sets the rules for translating and updating Plane's UI strings across locales: do-not-translate terms, plural forms, placeholders and AI translation review.
61k GitHub stars~16k tokensUpdated today
Writing & ContentAuto-check passed
Translate
tagspaces/tagspaces
Translate new or untranslated i18n strings from the English locale files (core.json + peri.json) into all other locales, maintaining consistency with each language's existing translations.
5.3k GitHub stars~2.2k tokensUpdated yesterday
Writing & ContentAuto-check passed
Translation Source Sync
Devolutions/UniGetUI
Synchronizes the UniGetUI English language file with source-code usage, identifies missing translation keys, removes unused entries, reports localization drift, and can reorder locale files to match…
26k GitHub stars~1.2k tokensUpdated today
Writing & ContentAuto-check passed
Write Locale Translations
videojs/video.js
Translate or audit the values in a Video.js locale pack. An agent skill from videojs/video.js.
40k GitHub stars~723 tokensUpdated today
Writing & ContentAuto-check passed

Questions about Localize

What does Localize do?

Localize ryOS apps and components by extracting hardcoded strings, replacing with translation keys, and syncing across languages. Localize is an agent skill from ryokun6/ryos. Localize ryOS apps and components by extracting hardcoded strings, replacing with translation keys, and syncing across languages.

When should I use Localize?

Localize fits situations like: localizing an app; adding i18n support; translating UI text; working with translation files.

How do I install Localize in Claude Code?

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

How do I install Localize in Codex?

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

Can I use Localize 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 ryokun6/ryos --skill localize -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/localize, .gemini/skills/localize, .github/skills/localize and .opencode/skills/localize in your project.

What does Localize need to run?

Going by SKILL.md and its folder, Localize needs the command-line tools its instructions call (bun) and credentials named GOOGLE_GENERATIVE_AI_API_KEY. Our summary lists: A credential in GOOGLE_GENERATIVE_AI_API_KEY.

Does Localize access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Localize safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Localize use?

Localize is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Localize use?

About 1.2k tokens (SKILL.md is roughly 4.6k 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 Localize?

Skills that share tags, products or a category with Localize: Translation Diff Export (Devolutions/UniGetUI, 26k stars), Translation Diff Translate (Devolutions/UniGetUI, 26k stars), Plane UI Translation (makeplane/plane, 61k stars) and Translate (tagspaces/tagspaces, 5.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Localize?

ryokun6 (a GitHub user) maintains it in ryokun6/ryos, which has 1,264 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 7, 2026.

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

Install Localize

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Localize App or Component

Workflow Checklist

Step 1: Extract Hardcoded Strings

Step 2: Replace Strings with t() Calls

Key Structure

Common Patterns

Step 3: Add English Translations

Step 4: Sync Across Languages

Step 5: Machine Translate

Step 6: Validate

Component Guidelines

Notes

Files

Compare with similar skills

Similar skills

More from ryokun6/ryos

Related

Questions about Localize