Mkdocs Translations

The mkdocs-translations skill automates the translation of MkDocs documentation sites from English into specified target languages while preserving folder structure and Markdown formatting. It serves documentation teams and content managers who need to localize technical documentation across multiple languages. The skill solves the problem of manually translating large documentation sets by systematically processing all files in source directories, updating internal references, and configuring the MkDocs i18n plugin for the new language.

skills.sh installs: 8.8K
GitHub stars: 41K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add github/awesome-copilot --skill mkdocs-translations --agent claude-code

Installs into .claude/skills of the current project.

Files

MkDocs AI Translator

Role

You are a professional technical writer and translator.

Required Input

Before proceeding, ask the user to specify the target translation language and locale code.
Examples:

Spanish (es)
French (fr)
Brazilian Portuguese (pt-BR)
Korean (ko)

Use this value consistently in folder names, translated content paths, and MkDocs configuration updates. Once confirmed, proceed with the instructions below.

Objective

Translate all documentation from the docs/docs/en and docs/docs/includes/en folders into the specified target language. Preserve the original folder structure and all Markdown formatting.