# Translate Skill Documentation Across Languages

Skill documentation often reaches only one language audience. This skill translates SKILL.md and README.md while preserving code, paths, commands, identifiers, and links.

## Install

```bash
npx skillstore add guo-yu/skill-i18n
```

## Metadata

- Status: approved
- Slug: guo-yu-skill-i18n
- Skillstore revision: r2
- Version status: missing
- Tree hash: 81c9f4eb6a379c743e3ea7a295fbc3b526464041413fb1591b86c36e827af8db
- Author: guo-yu
- GitHub username: guo-yu
- License: MIT
- Repository: https://github.com/guo-yu/skills/tree/master/skill-i18n
- Ref: d3f1eeb2412758efee2ef3ab41058c6830543d80
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: confirmation\_required
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, filesystem
- Quality score: 38
- Quality tier: warning
- Public page: https://skillstore.pages.dev/skills/guo-yu-skill-i18n
- Manifest: https://skillstore.pages.dev/api/skills/guo-yu-skill-i18n/manifest

## Capabilities

- Translates SKILL.md and README.md documentation into selected languages.
- Generates locale-suffixed files such as SKILL.zh-CN.md and SKILL.ja.md.
- Preserves code blocks, file paths, command names, identifiers, URLs, and links.
- Stores global defaults and per-skill language and file selections.
- Supports interactive selection and non-interactive command flags.
- Defines an integration flow for share-skill documentation generation.

## Use Cases

- Localize a Skill Repository: Generate translated SKILL.md files while keeping technical syntax unchanged.
- Maintain Team Documentation: Apply consistent language and file settings across repeated documentation updates.
- Prepare International Releases: Create localized skill documentation for inclusion in a shared documentation site.

## Prompt Templates

### Translate the Current Skill

```
Translate SKILL.md into Simplified Chinese and Japanese. Preserve all code, commands, paths, identifiers, URLs, and frontmatter names.
```

### Translate Selected Files

```
Translate SKILL.md and README.md into Spanish. Keep technical content unchanged and report every generated filename.
```

### Configure Project Defaults

```
Set Japanese and Korean as default languages for SKILL.md. Use different settings for the current skill and show the resulting preferences.
```

### Review and Update Translations

```
Compare each existing translation with the newer SKILL.md source. Update only outdated files, preserve established terminology, and list all reviewed sections.
```

## Limitations

- Built-in examples cover Chinese, Japanese, Korean, and Spanish; other languages require custom codes.
- Configuration examples require shell utilities, including jq.
- Translation quality depends on model output and human review.
- Overwrite mode can replace existing translated files.

## Best Practices

- Review terminology and tone with a fluent speaker before publishing translations.
- Keep code, commands, paths, identifiers, URLs, and frontmatter names unchanged.
- Inspect existing translations before enabling overwrite mode.

## Anti Patterns

- Do not translate executable code or technical identifiers.
- Do not overwrite the source SKILL.md file.
- Do not assume generated translations are ready without review.

## Security Audit

- Audited at: 2026-08-05T11:46:51.642\+00:00
- Summary: Most static alerts are false positives caused by Markdown backticks, expected local configuration reads, and normal entropy in translated text. The configuration update uses a predictable temporary file before overwriting a hidden Claude configuration file. The translation workflow also lacks an explicit trust boundary for instructions embedded in source documents.

## Stats

- Views: 172
- Downloads: 25
- Favorites: 0
- Popularity score: 0