cmux-localization

Localization rules and audit workflow for cmux UI strings, settings rows, menus, shortcuts, schema/config text, docs, command/help text, alerts, tooltips, and web messages. Use whenever changing user-facing text.

Jump to install

Repository: disler/learning-cmux-with-agents
Last source activity: June 29, 2026 at 16:28
Detected SKILL.md language: English
Stars: 103
Forks: 21

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/disler/learning-cmux-with-agents --skill cmux-localization

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

3 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

cmux-architecture

cmux package architecture, refactor layering, dependency inversion, file organization, DocC documentation, package design discipline, testability, and Swift 6 concurrency rules. Use before adding or meaningfully rewriting Swift files, Swift packages, coordinators, services, repositories, or public package APIs.

2026-06-29

cmux-backend

Backend TypeScript and Cloud VM development rules for cmux. Use when editing web/app/api, web/services, backend scripts, Cloud VM lifecycle, provider integrations, Postgres, Stack Auth pricing gates, migrations, or provider image build scripts.

2026-06-29

cmux-browser

End-user browser automation with cmux. Use when you need to open sites, interact with pages, wait for state changes, and extract data from cmux browser surfaces.

2026-06-29

View all from this repository

cmux Localization

Use this skill for any user-facing string change.

Hard rules

All user-facing strings must be localized.

Use String(localized: "key.name", defaultValue: "English text") for Swift/AppKit/SwiftUI strings.

Keys go in Resources/Localizable.xcstrings with translations for all supported languages, currently English and Japanese.

Never use bare string literals in SwiftUI Text(), Button(), alert titles, tooltips, menus, or dialogs.

Localization audit is required for every user-facing change.

defaultValue, English fallback text, schema descriptions, or copied English strings do not count as localization.

For localized web/docs content, update every supported message catalog, currently web/messages/en.json and web/messages/ja.json, plus any localized data structures carrying inline translations.

Audit checklist

Before finishing a task that changes UI, Settings rows, menus, shortcut metadata, schema/config text, docs, command/help text, alerts, or tooltips:

Enumerate the changed user-facing surfaces.

Verify each surface has entries for every supported locale.

Parse touched localization files.

Compare changed message keys across locales.

Use rg over changed Swift/TS/TSX/docs files for newly introduced bare English.

State the localization audit in the final handoff, or explicitly say what could not be verified.

Related shortcut rule

Every new cmux-owned keyboard shortcut must be added to KeyboardShortcutSettings, visible/editable in Settings, supported in ~/.config/cmux/cmux.json, and documented in the keyboard shortcut and configuration docs.

Detailed reference

Read references/audit-workflow.md for a deeper audit process, common false positives, and examples of surfaces that count as user-facing.

name	cmux-localization
description	Localization rules and audit workflow for cmux UI strings, settings rows, menus, shortcuts, schema/config text, docs, command/help text, alerts, tooltips, and web messages. Use whenever changing user-facing text.