kata-translate

Translate technical Markdown documentation into target languages while preserving structure and canonical terms.

Updated Sep 3, 2025
One-click install
npx skills add https://github.com/guardiatechnology/design-system --skill kata-translate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kata-translate
Source: https://github.com/guardiatechnology/design-system/tree/main/.claude/skills/kata-translate
Command: npx skills add https://github.com/guardiatechnology/design-system --skill kata-translate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you translate technical documentation into multiple target languages without breaking Markdown structure, code blocks, file paths, or canonical terms.

Core Features & Use Cases

  • Rule-driven translation: Uses language directives and layered rules (default, cross-cutting, and language-specific) to keep terminology consistent across translations.
  • Context-aware path mapping: Detects framework-specific documents and computes correct destination paths for each target language.
  • Mandatory preservation & validation: Preserves Markdown hierarchy, code blocks, URLs, and Ahrena canonical terms, then validates that the translated file is complete and correctly placed.

Quick Start

Translate the documentation file at framework/pt-BR/documentation/i18n/lexis/lex-language.md into all required target languages listed in the directives, preserving all Markdown structure, paths, URLs, and canonical terms.

Frequently Asked Questions about kata-translate

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

FAQPage Schema
How do I translate technical Markdown documentation without breaking code blocks and file paths?

Translating technical Markdown without breaking structure requires preserving code blocks, file paths, and URLs while translating only prose. A rule-driven approach ensures localized output remains valid and functional.

What is the best way to maintain consistent terminology across multiple target language translations?

Maintaining consistent terminology across target language translations requires applying layered language rules, including default, cross-cutting, and language-specific directives. This enforces canonical term preservation throughout the localized documentation files.

How does path mapping work when localizing framework-specific documentation into different languages?

Path mapping for localized framework documentation detects framework-specific files and computes correct destination paths for each target language. It maps source paths to language-specific output locations to ensure translated files are correctly placed.

Can I use automated translation validation to check completeness and correct file placement for localized docs?

Yes, you can use validation to check completeness and correct file placement for localized docs. After translating prose while preserving Markdown and code, validation ensures the translated file is complete and located in the correct destination path.

Does i18n translation support preserving canonical terms and URLs in technical documentation?

Yes, i18n translation supports preserving canonical terms and URLs in technical documentation. By reading translation directives and layered language rules, the process translates only translatable prose while explicitly protecting URLs and canonical terminology.

What are the limitations of translating Markdown documentation with code blocks and canonical terminology?

The main limitation is that code blocks, file paths, URLs, and canonical terms cannot be translated and must be strictly preserved. Additionally, achieving correct output requires reading translation directives and applying layered language rules to avoid misplaced or incomplete files.