Agent skill · Documentation

mkdocs-translations

Generate a language translation for a mkdocs documentation stack.

GitHub68,948★ · +463/wk · 2 repos on radarProfile →
copilotMIT
Install
npx skills add github/awesome-copilot --skill mkdocs-translations --agent copilot

Same command for any agent — swap --agent for claude-code, codex, cursor.

Facts
Files in the skill folder: 1
SKILL.md size: 4 KB
Bundled scripts: none
Path: skills/mkdocs-translations/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 37,432 · +281 this week
Language: Python

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# 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. --- ## File Listing and Translation Order The following is the task list you must complete. Check each item off as it is done and report that to the user. - [ ] Begin by listing all files and subdirectories under `docs/docs/en`. - [ ] Then list all files and subdirectories under `docs/docs/includes/en`. - [ ] Translate **every file** in the list **one by one** in the order shown. Do not skip, reorder, or stop after a fixed number of files. - [ ] After each translation, **check whether there are remaining files** that have not yet been

What's inside
Steps it walks through
  1. Role
  2. Required Input
  3. Objective
  4. File Listing and Translation Order
  5. Folder Structure and Output
  6. Include Path Updates
  7. MkDocs Configuration Update
  8. Translation Rules
  9. Translating Includes (docs/docs/includes/en)
More from awesome-copilot
All skills →
About this skill
What does the mkdocs-translations skill do?

Generate a language translation for a mkdocs documentation stack.

How do I install it?

Run `npx skills add github/awesome-copilot --skill mkdocs-translations --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From github/awesome-copilot, a repository with 37,432 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going