Skip to main content
ZICQ

Skills ZICQ category:Agent Workflows readme-i18n

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.

13 installs

Official URL:skills.sh

What this skill does

Intro in this page language first. The official description stays in its original wording; we do not rewrite SKILL.md.

What it does

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.

When to use it

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

How agents load it

Per Agent Skills progressive disclosure: name and description load at startup (~100 tokens); the full SKILL.md body loads when the skill activates; scripts/, references/, and assets/ load only as needed. This file's sections: Inputs; Defaults And Decision Rules; Workflow; 1. Establish the source README and languages; 2. Audit the Markdown structure before translating; 3. Translate only the prose layer. It includes spec-recommended sections: step-by-step instructions.

File analysis

File analysis: besides SKILL.md, the body references references/preservation-checklist.md, references/language-selector-reference.md. Those resources load on demand.

InputsDefaults And Decision RulesWorkflow1. Establish the source README and languages2. Audit the Markdown structure before translating3. Translate only the prose layer4. Preserve structure while writing the localized README5. Rewrite localized anchors and anchor-dependent links6. Write sibling files using the repo's naming pattern7. Insert or update the language selector8. Final verificationOutput

Source category:skills.sh agent-skill

SKILL.md & Agent activation

Official spec ↗
name
readme-i18n
description
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.
  1. DiscoverThe client exposes names and descriptions to the agent.
  2. ActivateYour request or the task context selects the skill and loads its instructions.
  3. Load resourcesReferenced scripts, documentation and assets are used when needed.
Files referenced by the instructions · 2
  • references/preservation-checklist.md
  • references/language-selector-reference.md

These paths are extracted from the text. Check the upstream package to verify the files exist.

Invocation syntax and available tools depend on your Agent client. Client integration guide ↗

Install this skill

Skills CLI ↗

Choose the target agent and installation scope, keep referenced package files, then verify the skill appears in the client's catalog.

This skill references supporting files. Retrieve the complete directory from the source; copying SKILL.md alone may leave missing dependencies.

Ask your Agent to install

Copy these instructions to a compatible agent and confirm the target directory matches your client.

Install the agent skill "readme-i18n" into my project. The full SKILL.md and official description are at https://zicq.com/en/skills/skl-719aeebe268c8ffd-Readme-I18n.html
Save it as .cursor/skills/readme-i18n/SKILL.md or .claude/skills/readme-i18n/SKILL.md and keep the frontmatter name and description exactly as-is.
This skill also ships scripts/, references/, or assets/ — fetch the whole folder from https://github.com/xixu-me/skills instead of creating only a SKILL.md.

Full package on GitHub ↗

Install from the terminal · Skills CLI

Requires Node.js and npx. First inspect the repository's skill list to confirm the name.

npx skills add 'https://github.com/xixu-me/skills' --list

npx skills add 'https://github.com/xixu-me/skills' --skill 'readme-i18n'

The CLI lets you choose the agent interactively. The default scope is the project; use -g for user scope. Confirm package availability with the discovery command, then use npx skills list to inspect installed skills.

Readable layout
--- name: readme-i18n description: 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. --- 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..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. Establish the source README and languages - Confirm the source README path. Default to `README.md`. - Identify the source language from the file contents and repo context. - Determine target languages from the request or existing repo pattern. - Note any glossary terms, product names, or phrases that must stay untranslated. ### 2. Audit the Markdown structure before translating Read the source README once as structure, not prose. Open [`references/preservation-checklist.md`](./references/preservation-checklist.md) and inventory the elements most likely to break: - headings and heading levels - badge rows, shields URLs, and image links - tables and alignment rows - raw HTML blocks and inline HTML - GitHub alerts or admonitions such as `> [!NOTE]` - code fences, inline code, commands, and config snippets - intra-document anchors such as `(#installation)` - relative links to files, docs, screenshots, or other README variants If the README already has localized siblings, inspect them too before choosing filenames or selector style. ### 3. Translate only the prose layer Translate: - paragraph text - list item prose - table cell prose - visible text inside HTML blocks - image alt text when safe - selector labels and other human-facing labels Do not translate: - fenced code blocks - inline code spans - shell commands - flags such as `--help` - env vars such as `OPENAI_API_KEY` - URLs - file paths - repo/package/project identifiers - badge and image URLs When in doubt, preserve the literal token and translate the surrounding sentence instead. ### 4. Preserve structure while writing the localized README - Keep the same heading hierarchy and section order as the source. - Keep the same number of code fences unless the user explicitly asks to rewrite examples. - Preserve table shape, list nesting, HTML wrappers, and Markdown comments. - Preserve relative links unless a link intentionally needs to point at a localized sibling README. ### 5. Rewrite localized anchors and anchor-dependent links When a translated heading changes, GitHub will generate a different heading ID. After translating headings: - rewrite every same-file `(#...)` link so it matches the localized heading slug in that file - preserve custom explicit anchors such as `` unless the file already uses localized explicit IDs - verify that every intra-document anchor target resolves to an existing heading or explicit anchor Prefer a small heading wording adjustment over a broken anchor. The section order should still match the source README. ### 6. Write sibling files using the repo's naming pattern Default to sibling filenames like: - `README.zh.md` - `README.es.md` - `README.fr.md` If the repo already uses a different multilingual naming pattern, keep using it consistently rather than forcing the default pattern. ### 7. Insert or update the language selector Open [`references/language-selector-reference.md`](./references/language-selector-reference.md) before editing selectors. Placement: - keep the selector near the top of the file - if the README starts with a title, badges, hero image, or short intro block, place the selector immediately after that opening cluster Behavior: - update an existing selector block in place if one already exists - if you add a new selector, use the canonical marker comments from the reference file so later runs can update it deterministically - emphasize the current language and link the other variants - keep selector order and labels consistent across every README variant ### 8. Final verification Before finishing, verify: - localized filenames follow the chosen pattern - every README variant contains exactly one selector block - code fence counts are preserved - badge/image URLs and relative file links still point to the original targets unless intentionally localized - every `(#...)` link resolves inside its own file - the localized README still feels structurally identical to the source ## Output Produce: - one localized sibling README per target language - an updated selector block in every README variant - a brief note to the user covering created or updated files, any assumptions, and any terms intentionally left untranslated ## Maintenance Note Keep `README.md` as the canonical source unless the user says otherwise. When the source README changes later, update each localized sibling by diffing the changed prose, then re-check selectors, filenames, and anchor links instead of reformatting the whole file from scratch. ## Example Prompts **Example 1** `Translate this README into Chinese and add a language switcher. Keep badge URLs, code fences, and all commands exactly as they are.` **Example 2** `Make the repo multilingual. Add Spanish and Chinese README variants, keep the internal anchor links working, and wire the selector into every file.` **Example 3** `We already have README.zh.md. Add README.es.md and update the existing selector in place instead of adding a second one.` ## Common Mistakes - Translating fenced code blocks or inline code instead of only the prose around them - Duplicating the language selector instead of updating the existing block - Translating a heading but forgetting to rewrite same-file `(#...)` links - Changing badge URLs or image sources while trying to translate visible labels - Reordering sections in the localized README even though the source README is the authority

Related skills

Agent Workflows

Skill Creator

Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that exte…

Agent Workflows

Clawdhub

Use the ClawdHub CLI to search, install, update, and publish agent skills from clawdhub.com. Use when you need to fetch new skills on the fl…

Agent Workflows

Agent Team Orchestration

Orchestrate multi-agent teams with defined roles, task lifecycles, handoff protocols, and review workflows. Use when: (1) Setting up a team …

Agent Workflows

Superpowers

Spec-first, TDD, subagent-driven software development workflow. Use when: (1) building any new feature or app — triggers brainstorm → plan →…