skill-i18n（国际化技能）

Skill i18n

Translate skill documentation files (SKILL.md, README.md) into multiple languages, making it easier to share skills with international users.

Usage

Supported Languages

Configuration

All settings are stored in ~/.claude/skill-i18n-config.json:

{
  "default_languages": ["zh-CN", "ja"],
  "default_files": ["SKILL.md"],
  "skills_config": {
    "port-allocator": {
      "languages": ["zh-CN", "ja", "ko"],
      "files": ["SKILL.md", "README.md"]
    }
  }
}

Configuration Fields:

Execution Steps

Command: /skill-i18n

Translate files in current skill directory:

1. Detect current directory # Check if current directory contains SKILL.md if [! -f SKILL.md]; then echo "Error: SKILL.md not found in current directory" exit 1 fi
2. Load configuration # Read config file CONFIG=$(cat ~/.claude/skill-i18n-config.json 2>/dev/null || echo '{}') # Get skill name from directory SKILL_NAME=$(basename "$(pwd)") # Check for skill-specific config SKILL_CONFIG=$(echo "$CONFIG" | jq -r ".skills_config[\"$SKILL_NAME\"] // null")
3. First-run selection (if no config) If no configuration exists for this skill, show TUI selection: {"questions": [{"question": "Which languages should be generated?", "header": "Languages", "multiSelect": true, "options": [{"label": "简体中文 (zh-CN)", "description": "Simplified Chinese"}, {"label": "日本語 (ja)", "description": "Japanese"}, {"label": "한국어 (ko)", "description": "Korean"}, {"label": "Español (es)", "description": "Spanish"}]}, {"question": "Which files should be translated?", "header": "Files", "multiSelect": true, "options": [{"label": "SKILL.md", "description": "Skill documentation (recommended)"}, {"label": "README.md", "description": "Repository readme"}]}]}
4. Save configuration # Save selection to config for future runs jq --arg skill "$SKILL_NAME" \ --argjson langs '["zh-CN", "ja"]' \ --argjson files '["SKILL.md"]' \ '.skills_config[$skill] = {"languages": $langs, "files": $files}' \ ~/.claude/skill-i18n-config.json > tmp.json && mv tmp.json ~/.claude/skill-i18n-config.json
5. Execute translation

- For each selected file and language, generate translation - See "Translation Rules" section below

Command: /skill-i18n <skill-name>

Translate files for specified skill:

1. Search skill location # Search in common locations SKILL_PATH="" # Check ~/.claude/skills/ if [-d ~/.claude/skills/"$SKILL_NAME"]; then SKILL_PATH=~/.claude/skills/"$SKILL_NAME" fi # Check code repository (if configured) if [-z "$SKILL_PATH"] && [-d ~/Codes/skills/"$SKILL_NAME"]; then SKILL_PATH=~/Codes/skills/"$SKILL_NAME" fi if [-z "$SKILL_PATH"]; then echo "Error: Skill '$SKILL_NAME' not found" exit 1 fi
2. Execute translation (same as default command)

Command: /skill-i18n config

Configure default settings:

1. Show current configuration echo "Current configuration:" cat ~/.claude/skill-i18n-config.json | jq.
2. Interactive configuration via AskUserQuestion {"questions": [{"question": "Select default languages for new skills:", "header": "Defaults", "multiSelect": true, "options": [{"label": "简体中文 (zh-CN)", "description": "Simplified Chinese"}, {"label": "日本語 (ja)", "description": "Japanese"}, {"label": "한국어 (ko)", "description": "Korean"}, {"label": "Español (es)", "description": "Spanish"}]}]}
3. Update configuration file

Command-Line Flags

For integration with other skills (e.g., share-skill):

Priority order:

1. Command-line flags (highest priority)
2. Skill-specific config in skills_config
3. Global default_languages and default_files
4. Interactive TUI selection (if no config exists)

Example integration:

# share-skill calls skill-i18n internally
/skill-i18n --lang zh-CN,ja --files SKILL.md --skill port-allocator --no-prompt

Translation Rules

Preserve Unchanged

These elements must NOT be translated:

• Code blocks (bash,json, etc.)
• File paths (~/.claude/settings.json, ~/Codes/skills/)
• Command names (/port-allocator, /skill-i18n, git push)
• Technical identifiers (variable names, JSON keys)
• URLs and links

Translate Naturally

• Adapt sentence structure to target language
• Use appropriate formality level:

- Japanese: Polite form (です/ます) - Chinese: Standard written form - Korean: Polite form (합니다/습니다) - Spanish: Formal usted form

• Localize examples where appropriate

Frontmatter Handling

---
name: port-allocator          # Keep unchanged (identifier)
description: Translate this   # Translate to target language
---

Style Adaptation

Different languages may use different visual styles:

Follow existing translation patterns in the project if available.

Output Format

Translation Success

Translation complete

Skill: port-allocator
Source: SKILL.md

Generated:
  - SKILL.zh-CN.md (简体中文)
  - SKILL.ja.md (日本語)

Config saved for: port-allocator
Next run will auto-translate to: zh-CN, ja

Existing Files Detected

Existing translations detected:
  - SKILL.zh-CN.md (modified 2 days ago)
  - SKILL.ja.md (modified 2 days ago)

Options:
  [ ] Overwrite all
  [ ] Skip existing
  [ ] Select individually

Configuration Saved

Configuration updated

Default languages: zh-CN, ja
Default files: SKILL.md

Skill-specific config:
  port-allocator: zh-CN, ja, ko (SKILL.md, README.md)
  share-skill: zh-CN, ja (SKILL.md)

Integration with share-skill

skill-i18n integrates with share-skill for documentation generation:

# share-skill docs with i18n
/share-skill docs --i18n

# This internally calls:
/skill-i18n --lang <configured-langs> --files SKILL.md --no-prompt

When share-skill detects --i18n flag:

1. Check if skill-i18n is available
2. Load language configuration
3. Call skill-i18n to generate translations
4. Include translated files in documentation site

Notes

1. Source file safety - Never overwrite the source SKILL.md file
2. First-run prompt - First translation requires language selection
3. Per-skill config - Different skills can have different language settings
4. Incremental updates - Only translate when source file is newer than translations
5. Integration-friendly - Command-line flags allow other skills to call skill-i18n