{"id":"a97802a5-d887-49a9-9a15-83b40ff89d81","shortId":"9JVhKL","kind":"skill","title":"mkdocs-translations","tagline":"Generate a language translation for a mkdocs documentation stack.","description":"# MkDocs AI Translator\n\n## Role\nYou are a professional technical writer and translator.\n\n## Required Input  \n**Before proceeding, ask the user to specify the target translation language and locale code.**  \nExamples:\n- Spanish (`es`)\n- French (`fr`)\n- Brazilian Portuguese (`pt-BR`)\n- Korean (`ko`)\n\nUse this value consistently in folder names, translated content paths, and MkDocs configuration updates. Once confirmed, proceed with the instructions below.\n\n---\n\n## Objective  \nTranslate 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.\n\n---\n\n## File Listing and Translation Order\n\nThe following is the task list you must complete. Check each item off as it is done and report that to the user.\n\n- [ ] Begin by listing all files and subdirectories under `docs/docs/en`.\n- [ ] Then list all files and subdirectories under `docs/docs/includes/en`.\n- [ ] 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.\n- [ ] After each translation, **check whether there are remaining files** that have not yet been translated. If there are, **continue automatically** with the next file.\n- [ ] Do **not** prompt for confirmation, approval, or next steps—**proceed automatically** until all files are translated.\n- [ ] 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.\n\n---\n\n## Folder Structure and Output\n\nBefore starting to create **any** new files, create a new git branch using the terminal command `git checkout -b docs-translation-<language>`.\n\n- Create a new folder under `docs/docs/` named using the ISO 639-1 or locale code provided by the user.  \n  Examples:  \n  - `es` for Spanish  \n  - `fr` for French  \n  - `pt-BR` for Brazilian Portuguese\n- Mirror the exact folder and file structure from the original `en` directories.\n- For each translated file:\n  - Preserve all Markdown formatting, including headings, code blocks, metadata, and links.\n  - Maintain the original filename.\n  - Do **not** wrap the translated content in Markdown code blocks.\n  - Append this line at the end of the file:  \n    *Translated using GitHub Copilot and GPT-4o.*\n  - Save the translated file into the corresponding target language folder.\n\n---\n\n## Include Path Updates\n\n- Update include references in files to reflect the new locale.  \n  Example:  \n    `includes/en/introduction-event.md` → `includes/es/introduction-event.md`  \n  Replace `es` with the actual locale code provided by the user.\n\n---\n\n## MkDocs Configuration Update\n\n- [ ] Modify the `mkdocs.yml` configuration:\n  - [ ] Add a new `locale` entry under the `i18n` plugin using the target language code.\n  - [ ] Provide appropriate translations for:\n    - [ ] `nav_translations`\n    - [ ] `admonition_translations`\n\n---\n\n## Translation Rules\n\n- Use accurate, clear, and technically appropriate translations.\n- Always use computer industry-standard terminology.  \n  Example: prefer \"Stack Tecnológica\" over \"Pila Tecnológica\".\n\n**Do not:**\n- Comment on, suggest changes for, or attempt to fix any formatting or Markdown linting issues.  \n  This includes, but is not limited to:\n  - Missing blank lines around headings or lists\n  - Trailing punctuation in headings\n  - Missing alt text for images\n  - Improper heading levels\n  - Line length or spacing issues\n- Do not say things like:  \n  _\"There are some linting issues, such as…\"_\n  _\"Would you like me to fix…\"_\n- Never prompt the user about any linting or formatting issues.\n- Do not wait for confirmation before continuing.\n- Do not wrap the translated content or file in Markdown code blocks.\n\n---\n\n## Translating Includes (`docs/docs/includes/en`)\n\n- Create a new folder under `docs/docs/includes/` using the target language code provided by the user.\n- Translate each file using the same rules as above.\n- Maintain the same file and folder structure in the translated output.\n- Save each translated file in the appropriate target language folder.","tags":["mkdocs","translations","awesome","copilot","github","agent-skills","agents","custom-agents","github-copilot","hacktoberfest","prompt-engineering"],"capabilities":["skill","source-github","skill-mkdocs-translations","topic-agent-skills","topic-agents","topic-awesome","topic-custom-agents","topic-github-copilot","topic-hacktoberfest","topic-prompt-engineering"],"categories":["awesome-copilot"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/github/awesome-copilot/mkdocs-translations","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add github/awesome-copilot","source_repo":"https://github.com/github/awesome-copilot","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 33270 github stars · SKILL.md body (4,174 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T18:52:17.559Z","embedding":null,"createdAt":"2026-04-18T20:26:02.483Z","updatedAt":"2026-05-18T18:52:17.559Z","lastSeenAt":"2026-05-18T18:52:17.559Z","tsv":"'-1':272 '4o':350 '639':271 'accur':420 'actual':381 'add':395 'admonit':415 'ai':14 'alt':476 'alway':426 'append':334 'appropri':410,424,579 'approv':197 'around':467 'ask':29 'attempt':448 'automat':187,202 'b':257 'begin':126 'blank':465 'block':316,333,534 'br':50,289 'branch':250 'brazilian':46,291 'chang':445 'check':112,171 'checkout':256 'clear':421 'code':40,275,315,332,383,408,533,548 'command':254 'comment':442 'complet':111,209 'comput':428 'configur':65,389,394 'confirm':68,196,210,520 'consist':56 'content':61,329,528 'continu':186,522 'copilot':346 'correspond':357 'creat':242,246,261,538 'directori':304 'doc':259 'docs-transl':258 'docs/docs':266 'docs/docs/en':80,134 'docs/docs/includes':543 'docs/docs/includes/en':82,142,537 'document':11,77 'done':119 'en':303 'end':339 'entri':399 'es':43,281,378 'everi':144 'exact':295 'exampl':41,280,374,433 'file':98,130,138,145,167,176,191,205,216,222,226,245,298,308,342,354,368,530,555,565,576 'filenam':323 'fix':164,450,505 'folder':58,83,92,235,264,296,360,541,567,582 'follow':104 'format':97,312,452,514 'fr':45,284 'french':44,286 'generat':4 'git':249,255 'github':345 'gpt':349 'gpt-4o':348 'head':314,468,474,481 'i18n':402 'imag':479 'improp':480 'includ':313,361,365,458,536 'includes/en/introduction-event.md':375 'includes/es/introduction-event.md':376 'industri':430 'industry-standard':429 'input':26 'instruct':72 'iso':270 'issu':456,487,497,515 'item':114 'ko':52 'korean':51 'languag':6,37,88,359,407,547,581 'left':233 'length':484 'level':482 'like':492,502 'limit':462 'line':336,466,483 'link':319 'lint':455,496,512 'list':99,108,128,136,148,223,470 'local':39,274,373,382,398 'maintain':320,562 'markdown':96,311,331,454,532 'match':217 'metadata':317 'mirror':293 'miss':464,475 'mkdoc':2,10,13,64,388 'mkdocs-transl':1 'mkdocs.yml':393 'modifi':391 'must':110 'name':59,267 'nav':413 'never':506 'new':244,248,263,372,397,540 'next':190,199 'number':165,213,219 'object':74 'one':149,151 'order':102,154 'origin':91,302,322 'output':238,572 'path':62,362 'pila':438 'plugin':403 'portugues':47,292 'prefer':434 'preserv':89,309 'proceed':28,69,201 'profession':20 'prompt':194,507 'provid':276,384,409,549 'pt':49,288 'pt-br':48,287 'punctuat':472 'refer':366 'reflect':370 'remain':175,227 'reorder':159 'replac':377 'report':121 'requir':25 'resum':229 'role':16 'rule':418,559 'save':351,573 'say':490 'shown':155 'skill' 'skill-mkdocs-translations' 'skip':158 'sourc':221 'source-github' 'space':486 'spanish':42,283 'specifi':33,86 'stack':12,435 'standard':431 'start':240 'step':200 'stop':161 'structur':93,236,299,568 'subdirectori':132,140 'suggest':444 'target':35,87,358,406,546,580 'task':107 'technic':21,423 'tecnológica':436,439 'termin':253 'terminolog':432 'text':477 'thing':491 'topic-agent-skills' 'topic-agents' 'topic-awesome' 'topic-custom-agents' 'topic-github-copilot' 'topic-hacktoberfest' 'topic-prompt-engineering' 'trail':471 'translat':3,7,15,24,36,60,75,101,143,170,182,207,215,260,307,328,343,353,411,414,416,417,425,527,535,553,571,575 'unprocess':228 'updat':66,363,364,390 'use':53,251,268,344,404,419,427,544,556 'user':31,125,279,387,509,552 'valu':55 'wait':518 'whether':172 'would':500 'wrap':326,525 'writer':22 'yet':180","prices":[{"id":"8912850b-d15c-48e6-ae36-a58e31fb2177","listingId":"a97802a5-d887-49a9-9a15-83b40ff89d81","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"github","category":"awesome-copilot","install_from":"skills.sh"},"createdAt":"2026-04-18T20:26:02.483Z"}],"sources":[{"listingId":"a97802a5-d887-49a9-9a15-83b40ff89d81","source":"github","sourceId":"github/awesome-copilot/mkdocs-translations","sourceUrl":"https://github.com/github/awesome-copilot/tree/main/skills/mkdocs-translations","isPrimary":false,"firstSeenAt":"2026-04-18T21:50:15.638Z","lastSeenAt":"2026-05-18T18:52:17.559Z"},{"listingId":"a97802a5-d887-49a9-9a15-83b40ff89d81","source":"skills_sh","sourceId":"github/awesome-copilot/mkdocs-translations","sourceUrl":"https://skills.sh/github/awesome-copilot/mkdocs-translations","isPrimary":true,"firstSeenAt":"2026-04-18T20:26:02.483Z","lastSeenAt":"2026-05-07T22:40:18.637Z"}],"details":{"listingId":"a97802a5-d887-49a9-9a15-83b40ff89d81","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"github","slug":"mkdocs-translations","github":{"repo":"github/awesome-copilot","stars":33270,"topics":["agent-skills","agents","ai","awesome","custom-agents","github-copilot","hacktoberfest","prompt-engineering"],"license":"mit","html_url":"https://github.com/github/awesome-copilot","pushed_at":"2026-05-18T01:26:59Z","description":"Community-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.","skill_md_sha":"70d4f18ab96cd2f284e42e194046ac50e1dab7fd","skill_md_path":"skills/mkdocs-translations/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/github/awesome-copilot/tree/main/skills/mkdocs-translations"},"layout":"multi","source":"github","category":"awesome-copilot","frontmatter":{"name":"mkdocs-translations","description":"Generate a language translation for a mkdocs documentation stack."},"skills_sh_url":"https://skills.sh/github/awesome-copilot/mkdocs-translations"},"updatedAt":"2026-05-18T18:52:17.559Z"}}