validate-translation

Validate PO file translations for terminology, punctuation, and reST syntax.

282|224|Updated Jun 24, 2018
One-click install
npx skills add https://github.com/python/python-docs-zh-tw --skill validate-translation-python
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: validate-translation
Source: https://github.com/python/python-docs-zh-tw/tree/main/.claude/skills/validate-translation
Command: npx skills add https://github.com/python/python-docs-zh-tw --skill validate-translation-python

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill reviews translated PO entries for quality, enforcing terminology consistency, punctuation rules, CJK-Latin spacing, reST syntax preservation, and appropriate line lengths.

Core Features & Use Cases

  • Terminology & Glossary Validation: compares terms against glossary.po and terminology dictionaries to flag inconsistencies.
  • Punctuation & Spacing Enforcement: ensures correct full-width vs half-width punctuation and proper CJK-Latin spacing.
  • Syntax & Link Preservation: verifies reST roles, links, and code block markers remain intact during reviews.
  • Use Case: maintainers running QA on Python docs translations across zh_TW and zh_CN to ensure consistency before releases.

Quick Start

Use the validate-translation skill to review a PO file and produce a quality report.

Frequently Asked Questions about validate-translation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate terminology consistency in a translated PO file?

PO file validation checks translated msgstr entries against glossary.po and a terminology dictionary to flag inconsistent term usage, categorizing mismatches as ERROR or WARNING in the final report.

How do I enforce CJK and Latin spacing rules in software localization?

Enforcing CJK and Latin spacing in software localization requires parsing translated PO entries to verify proper full-width and half-width punctuation usage and correct character spacing between Latin and CJK text.

Does PO file validation check reST syntax preservation?

Yes, PO file validation checks reST syntax preservation by verifying that reST roles, hyperlinks, and code block markers remain intact in the translated msgstr entries during the quality review process.

Can I use translation validation for Python docs localization in zh_TW and zh_CN?

Yes, translation validation can be used for Python docs localization in zh_TW and zh_CN, allowing maintainers to run QA on multilingual PO files to ensure terminology and formatting consistency before releases.

What is the best way to generate a translation quality report for multilingual projects?

The best way to generate a translation quality report for multilingual projects is to parse PO files and apply defined validation rules that categorize terminology, spacing, and syntax issues as ERROR, WARNING, or INFO into a concise output report.

Why are my translated PO entries flagged for line length issues?

Translated PO entries are flagged for line length issues because the validation process checks the msgstr text against appropriate line length limits to ensure documentation formatting remains consistent and readable.