mkdocs-translations Skill (awesome-copilot) for Claude Code: What It Does and How to Install It

Makes Claude translate a whole MkDocs documentation stack into a new language on its own git branch and register the locale in mkdocs.yml.

Installs: 8.8K; on skills.sh
Stars: 40.7K; on GitHub
Updated: Oct 2026; last repo commit

This skill makes Claude translate an entire MkDocs site into one new language. After you give a language and locale code, Claude creates a git branch, translates every file under docs/docs/en and docs/docs/includes/en into a mirrored locale folder, updates include paths and adds the locale to the i18n plugin in mkdocs.yml.

The folder has one file, SKILL.md, and no scripts. SKILL.md tells Claude to keep going until all files are done without asking for confirmation.

Good for

Docs maintainers adding a language to a MkDocs site
Teams with docs under docs/docs/en and docs/docs/includes/en
Contributors who want translation work isolated on a branch

Install mkdocs-translations

Claude Code

Copy this prompt.

Install the mkdocs-translations skill in Claude Code. Run this command:

npx skills add https://github.com/github/awesome-copilot --skill mkdocs-translations

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

From its listing on skills.sh. Source.

What's in the skill

When it loads

Generate a language translation for a mkdocs documentation stack.

Sections in SKILL.md

Role
Required Input
Objective
File Listing and Translation Order
Folder Structure and Output
Include Path Updates
MkDocs Configuration Update
Translation Rules
Translating Includes (docs/docs/includes/en)

Key facts

Author: (awesome-copilot); no author is named for this skill, and the repo LICENSE reads "Copyright GitHub, Inc."
License: MIT (repo LICENSE)
Installs on skills.sh: 8,804 (Nov 2, 2026)
GitHub stars: 40,666 for the whole github/awesome-copilot repo (Nov 2, 2026)
Last repo commit: Oct 30, 2026
Audits on skills.sh: Gen Agent Trust Hub: pass, Socket: pass, Snyk: pass
What it includes: 1 file: SKILL.md (no scripts)
Needs: MkDocs with docs/docs/en and docs/docs/includes/en, plus an i18n plugin in mkdocs.yml

What it includes

Asks for the target language and locale code before it starts
Examples in SKILL.md: es, fr, pt-BR, ko.
Try: “Translate our MkDocs docs into Spanish (es)”
Read · Ask for the language
git checkout -b docs-translation-<language> before any new file
SKILL.md says to do this before creating any files.
Runs code · Create a git branch
Translates docs/docs/en and docs/docs/includes/en file by file
It mirrors the folder structure, keeps Markdown and filenames, and continues automatically without asking for confirmation until the counts match.
Write · List and translate every file
Changes includes/en/... to includes/<locale>/...
In the translated files.
Write · Update include paths
Adds a locale under the i18n plugin with nav and admonition translations
Adds nav_translations and admonition_translations for the new language.
Write · Update mkdocs.yml
Industry-standard terminology; no lint comments; no code-block wrapping
Appends "Translated using GitHub Copilot and GPT-4o." to each translated file.
Read · Translation rules

From the official docs

Permissions

Medium risk

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It works through the whole docs set without asking
SKILL.md says not to prompt for confirmation, approval or next steps and to continue until every file is translated. Our advice: review the new branch as a whole before you merge it. github.com
It edits mkdocs.yml
It adds a locale entry with nav and admonition translations under the i18n plugin. Our advice: check the diff for the rest of your config. github.com
Your docs go to the model
Claude reads and rewrites every page, so the full text of the docs is processed by the model you use. github.com

Technical details

Turning on read-only	No read-only mode.
Sign-in and keys	No credentials are named in SKILL.md.
Scopes	Creates a git branch Writes many new files under docs/docs/<locale>/ and docs/docs/includes/<locale>/ Edits mkdocs.yml and the include references in translated files

Questions

What does the mkdocs-translations skill do?

It makes Claude translate a whole MkDocs documentation stack into another language. It creates a locale folder, translates every file, fixes include paths and adds the locale to mkdocs.yml.

What folder layout does it expect?

English docs in docs/docs/en and includes in docs/docs/includes/en, with an i18n plugin in mkdocs.yml. Those paths are written into SKILL.md.

Will it stop to ask me questions?

It asks for the target language at the start. After that SKILL.md says to proceed automatically through every file without asking for confirmation, and not to bring up formatting or linting issues.

How do I install it?

Use the install box at the top of this page. It has the skills CLI command and folder routes for this one skill.

Does it add a note to translated files?

Yes. SKILL.md says to append the line "Translated using GitHub Copilot and GPT-4o." at the end of each translated file. Our advice: change it if that is not true for your setup.

Is it safe?

It creates a new git branch first and then adds many files and edits mkdocs.yml. SKILL.md has it run without per-file confirmation. Our advice: review the diff before you merge. It bundles no scripts.

Information

updated Nov 2, 2026

Repository: github/awesome-copilot
Folder: skills/mkdocs-translations

github/awesome-copilot skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 2

mkdocs-translations SKILL.md · github.com
awesome-copilot README · github.com