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

Localization

by kmworks in kmworks/kmreader

A skill your agent uses when updating KMReader translations in Localizable.xcstrings after code changes.

MITAuto-check passedWriting & Content

Install Localization

skills CLI
$ npx skills add kmworks/kmreader --skill localization -a claude-code

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

GitHub CLI
$ gh skill install kmworks/kmreader localization --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/kmworks/kmreader.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/localization .claude/skills/localization && 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
localization
GitHub stars
111
Token cost
~800 tokens
SKILL.md length
337 words
Files
2
Skills in repo
8
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when updating KMReader translations in Localizable.xcstrings after code changes.

  • Works in 3 steps: Run a full make build once to refresh… → Sync extracted strings data into… → Fill missing translations.
  • Updating KMReader translations in Localizable.xcstrings after code changes
  • SKILL.md covers When To Use, Standard Workflow, Missing Translation Check and Per-Key Process, plus 3 more sections
  • Calls make and rg

What it does

Localization is an agent skill from kmworks/kmreader. Use when updating KMReader translations in Localizable.xcstrings after code changes. Covers build/localize refresh, missing key discovery, context lookup, and deterministic updates through misc/translate.py.

Its SKILL.md is about 800 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Writing & Content, covering Translation and Internationalization. The repository describes itself as: A full-featured, native Komga client for iOS, macOS, and tvOS. The licence is MIT.

When your agent uses it

  • Updating KMReader translations in Localizable.xcstrings after code changes
  • Tasks that involve Translation
  • Tasks that involve Internationalization

Example prompts

  • “/localization”

Workflow steps

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

  1. Run a full make build once to refresh extracted strings data.
  2. Sync extracted strings data into Localizable.xcstrings.
  3. Fill missing translations.

What it can do on your machine

Read from SKILL.md and the folder at commit cb2d394. 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:

    • make
    • rg

    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 no API keys, tokens, secrets or passwords.

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

Context cost

Localization loads about 800 tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 337 words of instructions outside code blocks.

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

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 kmworks/kmreader at commit cb2d394, republished under its MIT licence (© kmworks). 337 words, ~800 tokens.

Download SKILL.mdSave it as .claude/skills/localization/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
localization
description
Use when updating KMReader translations in Localizable.xcstrings after code changes. Covers build/localize refresh, missing key discovery, context lookup, and deterministic updates through misc/translate.py.

KMReader Localization

Maintain and complete KMReader translations in KMReader/Localizable.xcstrings.

When To Use

  • The user asks to fill missing translations.
  • New localized strings were introduced and need all supported languages.
  • The user mentions misc/translate.py, make localize, or missing localization entries.

Standard Workflow

Hard requirement:

  • make localize must be preceded by a full make build for the current code state.
  • Without that build, extracted localized strings data may be stale, and Localizable.xcstrings will not be updated correctly.

Default order:

  1. Run a full make build once to refresh extracted strings data.
  2. Sync extracted strings data into Localizable.xcstrings.
  3. Fill missing translations.

Only skip the build step when it is already confirmed that the current code changes have been through a full make build. If that is not explicitly confirmed, run make build before make localize.

bash
make build
make localize

Missing Translation Check

bash
./misc/translate.py list
  • This lists keys with missing languages.
  • If output is No missing translations found., no translation update is needed.

Per-Key Process

  1. Understand key meaning and UI context.
  2. Locate usage in code when needed to avoid semantic drift.
  3. Prepare all target languages first, then write once.
bash
rg -n "String\\(localized: \"<KEY>\"\\)|\"<KEY>\"" KMReader Shared KMReaderWidgets

Current supported target languages:

  • de, en, es, fr, it, ja, ko, ru, zh-Hans, zh-Hant

Deterministic Update Command

Always write all target languages in one command to avoid partial updates. Run ./misc/translate.py update commands sequentially. Do not run multiple update commands in parallel against the same KMReader/Localizable.xcstrings file, because each invocation rewrites the file and concurrent writes can corrupt the JSON. Parallelism is only safe for read-only steps such as rg or ./misc/translate.py list.

bash
./misc/translate.py update "<KEY>" \
  --de "<German>" \
  --en "<English>" \
  --es "<Spanish>" \
  --fr "<French>" \
  --it "<Italian>" \
  --ja "<Japanese>" \
  --ko "<Korean>" \
  --ru "<Russian>" \
  --zh-hans "<Simplified Chinese>" \
  --zh-hant "<Traditional Chinese>"

If Localizable.xcstrings becomes invalid JSON at any point, restore it to a known-good state first, rerun make localize, and then repeat the missing-key updates sequentially.

Quality Rules

  • Preserve placeholders and format markers exactly: %@, %d, %lld, %f, %1$@, \\n.
  • Keep tone consistent with product domains (Reader, Series, Read List, Offline Sync).
  • Do not modify entries where shouldTranslate == false.
  • Do not rewrite unrelated keys; only update requested or missing ones.

Final Verification

bash
./misc/translate.py list

If missing items remain, continue until the list is empty.

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

Files

SKILL.md and 1 other file in .agents/skills/localization of kmworks/kmreader.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit cb2d394

Compare with similar skills

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

Localization compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Localization this skillkmworks/kmreader111—~800Automated safety check: PassMIT
Translation Diff ExportDevolutions/UniGetUI26k—~1.1kAutomated safety check: PassMIT
Translation Diff TranslateDevolutions/UniGetUI26k—~934Automated safety check: PassMIT
Plane UI Translationmakeplane/plane61k—~16kAutomated safety check: PassAGPL-3.0
Translatetagspaces/tagspaces5.3k—~2.2kAutomated safety check: PassAGPL-3.0
Translation Source SyncDevolutions/UniGetUI26k—~1.2kAutomated safety check: PassMIT

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

More from kmworks/kmreader

All 8 skills in this repo

  • Appstore Release

    kmworks/kmreader

    Coordinate the KMReader App Store release workflow. An agent skill from kmworks/kmreader.

    111 GitHub stars~2.5k tokensUpdated today
    Auto-check passed

  • PR Workflow

    kmworks/kmreader

    Create and merge KMReader GitHub pull requests. An agent skill from kmworks/kmreader.

    111 GitHub stars~899 tokensUpdated today
    Auto-check passed

  • Simulator

    kmworks/kmreader

    A skill your agent uses when observing or driving an iOS simulator for KMReader debugging — screenshots, accessibility tree, tap/swipe/gestures, hardware buttons, orientation, and unified logs via…

    111 GitHub stars~797 tokensUpdated today
    Auto-check passed

  • Testflight

    kmworks/kmreader

    Distribute KMReader builds to TestFlight groups via the asc CLI.

    111 GitHub stars~403 tokensUpdated today
    Auto-check passed

  • Changelog

    kmworks/kmreader

    Generate App Store changelog text from commits between the latest tag and HEAD.

    111 GitHub stars~370 tokensUpdated today
    Auto-check passed

  • Repo Conventions

    kmworks/kmreader

    KMReader subsystem conventions and invariants — reader state boundaries, reading-progress sync, offline downloads and caching, local database (GRDB) migrations, SSE dispatch, browse and dashboard…

    111 GitHub stars~18k tokensUpdated today
    Auto-check passed

Categories

Questions about Localization

What does Localization do?

A skill your agent uses when updating KMReader translations in Localizable.xcstrings after code changes. Localization is an agent skill from kmworks/kmreader.xcstrings after code changes.

When should I use Localization?

Localization fits situations like: updating KMReader translations in Localizable.xcstrings after code changes; tasks that involve Translation; tasks that involve Internationalization.

How do I install Localization in Claude Code?

Run `npx skills add kmworks/kmreader --skill localization -a claude-code`. Or copy the skill folder (.agents/skills/localization in kmworks/kmreader) into .claude/skills/localization in your project. Claude Code loads it when a task matches its description.

How do I install Localization in Codex?

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

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

What does Localization need to run?

Going by SKILL.md and its folder, Localization needs the command-line tools its instructions call (make and rg).

Does Localization 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 Localization 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 Localization use?

Localization is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Localization use?

About 800 tokens (SKILL.md is roughly 3.2k 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 Localization?

Skills that share tags, products or a category with Localization: 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 Localization?

kmworks (a GitHub organization) maintains it in kmworks/kmreader, which has 111 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 8, 2026.

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