Check I18n

Overview

Validate that i18n keys defined in Go source code match the keys in TOML translation files. Ensures all keys in internal/i18n/keys.go have corresponding entries in en.toml and zh-CN.toml, and vice versa.

When to Use

• After adding new i18n keys to internal/i18n/keys.go
• After adding translations to internal/i18n/locales/en.toml or zh-CN.toml
• Before committing i18n-related changes
• To diagnose missing translation issues

Workflow

Step 1: Run the Check Script

Execute the validation script from the project root:

go run scripts/check_i18n.go

Or use the bundled script in this skill:

go run .claude/skills/check-i18n/scripts/check_i18n.go

Step 2: Interpret Results

The script compares keys.go with both locale files and reports:

OK Output (all keys match):

Comparing keys.go with en.toml:
  OK

Comparing keys.go with zh-CN.toml:
  OK

Error Output (mismatches found):

Comparing keys.go with en.toml:
  Missing in TOML (defined in keys.go):
    - error_new_key
  Extra in TOML (not in keys.go):
    - error_deprecated_key

Step 3: Fix Mismatches

File Locations

Key Format

In keys.go, keys are defined as:

const (
    ErrGeneric = "error_generic"
    ErrNotFound = "error_not_found"
)

In TOML files, keys are defined as sections:

[error_generic]
other = "An error occurred"

[error_not_found]
other = "Resource not found"

Resources

scripts/

• check_i18n.go - Validation script that extracts keys from Go source and TOML files, then compares them