Agent skill · writing content · github
mkdocs-translations
Generate a language translation for a mkdocs documentation stack.
Why this skill is useful
Adds specific translation procedures and folder structure management for MkDocs documentation that the AI wouldn't reliably generate on its own.
What it needs
About 3k tokens when loaded. Last updated 2026-08-07. 37,534 stars on the source repository.
What this skill does
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 translated. If there are, continue automatically with the next file. [ ] Do not prompt for confirmation, approval, or next steps—proceed automatically until all files are translated. [ ] Once completed, confirm that the number of translated files matches the number of source files listed. If any files remain unprocessed, resume from where you left off. --- Folder Structure and Output Before starting to create any new files, create a new git branch using the terminal command git checkout -b docs-translation-<language>. Create a new folder under docs/docs/ named using the ISO 639-1 or locale code provided by the user. Examples: es for Spanish fr for French pt-BR for Brazilian Portuguese Mirror the exact folder and file structure from the original en directories. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills github/mkdocs-translations