mkdocs-translations

Translate MkDocs documentation into a target language and update mkdocs.yml for i18n.

Updated Mar 8, 2026
One-click install
npx skills add https://github.com/tamago0224/kuroshio-mta --skill mkdocs-translations-tamago0224
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mkdocs-translations
Source: https://github.com/tamago0224/kuroshio-mta/tree/main/.agents/skills/mkdocs-translations
Command: npx skills add https://github.com/tamago0224/kuroshio-mta --skill mkdocs-translations-tamago0224

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many projects use MkDocs for documentation but translating the content into multiple languages is manual and error‑prone. This Skill automates the creation of localized documentation sets.

Core Features & Use Cases

  • Automatic file discovery: Lists all Markdown files in the English source folders.
  • One‑click translation: Generates translated copies while preserving the original folder hierarchy.
  • Git workflow integration: Creates a dedicated branch for the translation work.
  • MkDocs i18n configuration: Updates mkdocs.yml with the new locale entries.

Quick Start

Ask the mkdocs-translations skill to translate the documentation into Spanish.

Frequently Asked Questions about mkdocs-translations

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

FAQPage Schema
How do I translate MkDocs documentation into another language?

MkDocs i18n configuration is updated by this Skill to include new locale entries in the mkdocs.yml file, ensuring the i18n plugin correctly registers and serves the translated Markdown files alongside the original English sources.

Does MkDocs translation require a specific git workflow?

Yes, MkDocs translation through this Skill requires a dedicated git branch. It integrates with your git workflow to isolate the automated translation work and generated localized Markdown files from the main branch.

How do I add multilingual i18n support to an existing MkDocs project?

Adding multilingual i18n support involves generating translated Markdown files and updating the mkdocs.yml configuration. This Skill automates that process, requiring only a target locale code to comply with the i18n plugin format.

What is needed to automate MkDocs translation for a new locale?

Automating MkDocs translation requires a git branch name and a target locale code. The Skill then handles file discovery, translation generation, and the mkdocs.yml configuration updates needed for the new language.

Will translating MkDocs files preserve my original folder structure?

Translating MkDocs files preserves the original folder structure completely. The Skill generates localized Markdown copies that mirror the English source directory hierarchy, maintaining project organization for the i18n plugin.