Agent skill · writing content · aiskillstore
readme-i18n
Use 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 README variants in a GitHub-style repository.
Why this skill is useful
Adds specific workflows and decision rules for translating and localizing README files that the AI wouldn't reliably generate on its own.
What it needs
About 5k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
README Internationalization (i18n) Localize a repository README.md without breaking the repo mechanics around it. The default job is translate + wire-up: read the source-of-truth README create localized sibling files such as README.zh.md preserve GitHub-flavored Markdown structure and repo-specific tokens add or update a shared language selector near the top of every variant This skill is for multilingual README workflows, not general website/app i18n. Inputs Expect these inputs when available: source README path, default README.md source language, default inferred or English one or more target languages optional glossary or do-not-translate list optional filename override if the repo already uses a different multilingual naming pattern If target languages are not named, inspect existing translated files, selectors, filenames, issues, or prior repo conventions. If that still leaves the target languages unclear, ask once. Do not invent target languages. Defaults And Decision Rules Treat the root README.md as the source-of-truth unless the user explicitly says otherwise. If the source language is ambiguous, ask once. Otherwise assume English. Keep section order aligned with the source README. Only make a small heading wording adjustment when needed to produce a valid localized anchor. Output localized siblings with README.<bcp47-tag>.md naming unless the repo already has a different established pattern that should be preserved. Update an existing language selector in place. Do not duplicate it. Translate only human-language content. Preserve project names, package names, commands, CLI flags, option names, environment variables, URLs, file paths, inline code, code fences, HTML attributes, and badge/image URLs. Badge alt text or visible labels may be translated only when the change does not require changing the badge URL, query params, or image source. If a glossary or do-not-translate list is provided, apply it consistently across every target language. Workflow 1. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/readme-i18n