translation-guide

Generate translation style guides from existing translations or validate translations against them.

3|Updated Aug 8, 2026
One-click install
npx skills add https://github.com/Jose-Polanco-Oxte/Echos-Live-Music-Visualizer --skill translation-guide-jose-polanco-oxte
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: translation-guide
Source: https://github.com/Jose-Polanco-Oxte/Echos-Live-Music-Visualizer/tree/main/.agents/skills/localization/sub-skills/software-localization/translation-guide
Command: npx skills add https://github.com/Jose-Polanco-Oxte/Echos-Live-Music-Visualizer --skill translation-guide-jose-polanco-oxte

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams maintaining multilingual products often lack explicit translation standards, leading to inconsistent formality, terminology, and punctuation across languages. This Skill analyzes existing translations to surface implicit conventions and codify them into an enforceable style guide. ## Core Features & Use Cases - Style Guide Generation: Analyze source and target language files to detect formality levels, terminology patterns, grammatical conventions, and punctuation rules, then write a .translation-guide.md. - Compliance Checking: Validate translations against an existing guide and report deviations per language, such as wrong formality or non-standard terminology. - Config Integration: Propose structured tone and glossary fields for .translation-sync.json so rules are enforced programmatically. - Use Case: A team onboarding new translators for French, German, and Spanish runs the generate mode to document that French uses formal "vous" and infinitive button labels, then runs check mode before each release to catch deviations. ## Quick Start Ask the assistant to analyze the existing translation files in this project and generate a translation style guide for all languages.

Frequently Asked Questions about translation-guide

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

FAQPage Schema
How do I create a translation style guide from existing translations?

Run the skill in generate mode, which reads your source and target language files, detects formality levels, terminology patterns, and punctuation conventions, then writes a .translation-guide.md file documenting the rules per language.

How do I check translations for consistency across languages?

Use the check mode, which loads .translation-guide.md and validates every translation against its rules. It reports deviations per language, such as informal pronouns where formal ones are required or non-standard terminology choices.

What inconsistencies can a translation style guide detect?

It detects formality mismatches (formal vs informal pronouns), terminology drift where the same English term has multiple translations, grammatical pattern breaks like noun forms instead of infinitives on buttons, and punctuation or quotation mark style violations.

Can translation rules be enforced automatically instead of manually?

Yes. After generating the guide, the skill proposes adding structured tone and glossary fields to .translation-sync.json. The translation-sync skill then enforces these rules programmatically, which is stronger than free-form custom instructions.

Which terms should be excluded from translation?

Terms consistently left untranslated across all sampled languages, such as product names, brand names, and technical terms, are flagged as do-not-translate candidates. The skill proposes adding them to the glossary configuration automatically.