doc-translator

Translate French Markdown documentation to English with i18n-aware UI terminology.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Swear4/agent_rules --skill doc-translator-swear4
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-translator
Source: https://github.com/Swear4/agent_rules/tree/main/agent-universal/skills/doc-translator
Command: npx skills add https://github.com/Swear4/agent_rules --skill doc-translator-swear4

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Translating FR documentation to EN with i18n-aware adaptation solves language barriers in product documentation.

Core Features & Use Cases

  • Preserve the original Markdown structure while translating to idiomatic English
  • Apply i18n mappings to UI labels, buttons and menus for accurate terminology
  • Works in Phase 4 of the Documentation KB pipeline after doc-writer produced FR files

Quick Start

Run the translator after doc-writer has produced all FR files to generate the corresponding EN files.

Frequently Asked Questions about doc-translator

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

FAQPage Schema
How do I translate French Markdown documentation to English while preserving frontmatter?

To translate French Markdown documentation to English while preserving frontmatter, use an i18n-aware translation process that maintains the exact Markdown structure, switches the lang value from fr to en, and keeps the slug identical.

How does i18n-aware adaptation work for UI labels during document translation?

i18n-aware adaptation for UI labels works by applying predefined i18n mappings during translation to replace French UI terms, buttons, and menus with their consistent, idiomatic English equivalents.

Can I translate FR documentation files without an English i18n reference?

No, translating FR documentation files requires both the original FR source files and English i18n references to ensure accurate terminology mapping and produce consistent localized outputs.

What is the best way to automate FR to EN document translation in a localization pipeline?

The best way to automate FR to EN document translation in a localization pipeline is to run the translation phase after initial FR files are generated, applying i18n mappings to produce structured EN outputs.

Does translating Markdown files change the original document slug?

Translating Markdown files preserves the original document slug exactly, changing only the frontmatter language tag from fr to en while keeping the structural format intact.

When do I need to run a French to English translation phase in a documentation pipeline?

You need to run a French to English translation phase after your documentation writer has produced all original FR files, ensuring the complete source content is ready for i18n-aware adaptation.