# Validate Translation

> Validate Translation is an Agent Skill for documents published in the python/python-docs-zh-tw repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Reviews translated PO entries for quality, checking terminology, punctuation, reST syntax, and line length. Use to validate existing translations.

- Skill name: `validate-translation`
- Category: [Documents](https://www.openparable.com/skill/documents/1)
- Source: https://github.com/python/python-docs-zh-tw/blob/HEAD/.claude/skills/validate-translation/SKILL.md
- Repository: python/python-docs-zh-tw (282 GitHub stars when collected)

## SKILL.md

# review-translation

Validate translated PO entries against project rules and report issues.

## What to Check

### 1. Terminology Consistency
- Compare terms against `glossary.po` and terminology dictionary
- Flag zh_CN terms that should be zh_TW (see `references/validation-rules.md`)
- Check for inconsistent translations of the same term

### 2. Punctuation Rules
- Chinese text must use full-width: `「」（）、，。：；！？`
- English text must use half-width: `(),.;:!?`
- Brackets: Full-width if content has Chinese, half-width if English-only

### 3. CJK-Latin Spacing
- Space required between Chinese and Latin characters
- No space between Latin and Chinese punctuation/symbols

### 4. reST Syntax Preservation
- All `:role:` syntax must be intact
- Link URLs must be unchanged
- `::` markers must be preserved
- Check for missing `\\ ` escapes before roles

### 5. Line Length
- Maximum 79 characters per line
- Multi-line format for longer content

## Review Process

1. **Parse PO file** - Extract msgid/msgstr pairs
2. **Check each entry** - Apply all validation rules
3. **Categorize issues** - ERROR (must fix), WARNING (should fix), INFO
4. **Generate report** - List issues with line numbers and suggestions

## Issue Severity

| Severity | Description | Examples |
|----------|-------------|----------|
| ERROR | Must fix before merge | Broken reST, missing translation |
| WARNING | Should fix | Wrong terminology, spacing issues |
| INFO | Optional improvement | Inefficient line wrapping |

## Quick Validation Commands

After review, run: `make lint`, `make wrap`, `make build <file>.po`

## References

- `references/validation-rules.md` - Complete validation checklist

---

Source: https://www.openparable.com/skill/documents/validate-translation (OpenParable). Cite the canonical URL above.