{"id":"a97802a5-d887-49a9-9a15-83b40ff89d81","shortId":"9JVhKL","kind":"skill","title":"Mkdocs Translations","tagline":"Awesome Copilot skill by Github","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"],"capabilities":["skill","source-github","category-awesome-copilot"],"categories":["awesome-copilot"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/github/awesome-copilot/mkdocs-translations","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"install_from":"skills.sh"}},"qualityScore":"0.300","qualityRationale":"deterministic score 0.30 from registry signals: · indexed on skills.sh · published under github/awesome-copilot","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:v1","enrichmentVersion":1,"enrichedAt":"2026-04-22T11:40:19.740Z","embedding":null,"createdAt":"2026-04-18T20:26:02.483Z","updatedAt":"2026-04-22T11:40:19.740Z","lastSeenAt":"2026-04-22T11:40:19.740Z","tsv":"'-1':267 '4o':345 '639':266 'accur':415 'actual':376 'add':390 'admonit':410 'ai':9 'alt':471 'alway':421 'append':329 'appropri':405,419,574 'approv':192 'around':462 'ask':24 'attempt':443 'automat':182,197 'awesom':3 'b':252 'begin':121 'blank':460 'block':311,328,529 'br':45,284 'branch':245 'brazilian':41,286 'category-awesome-copilot' 'chang':440 'check':107,166 'checkout':251 'clear':416 'code':35,270,310,327,378,403,528,543 'command':249 'comment':437 'complet':106,204 'comput':423 'configur':60,384,389 'confirm':63,191,205,515 'consist':51 'content':56,324,523 'continu':181,517 'copilot':4,341 'correspond':352 'creat':237,241,256,533 'directori':299 'doc':254 'docs-transl':253 'docs/docs':261 'docs/docs/en':75,129 'docs/docs/includes':538 'docs/docs/includes/en':77,137,532 'document':72 'done':114 'en':298 'end':334 'entri':394 'es':38,276,373 'everi':139 'exact':290 'exampl':36,275,369,428 'file':93,125,133,140,162,171,186,200,211,217,221,240,293,303,337,349,363,525,550,560,571 'filenam':318 'fix':159,445,500 'folder':53,78,87,230,259,291,355,536,562,577 'follow':99 'format':92,307,447,509 'fr':40,279 'french':39,281 'git':244,250 'github':7,340 'gpt':344 'gpt-4o':343 'head':309,463,469,476 'i18n':397 'imag':474 'improp':475 'includ':308,356,360,453,531 'includes/en/introduction-event.md':370 'includes/es/introduction-event.md':371 'industri':425 'industry-standard':424 'input':21 'instruct':67 'iso':265 'issu':451,482,492,510 'item':109 'ko':47 'korean':46 'languag':32,83,354,402,542,576 'left':228 'length':479 'level':477 'like':487,497 'limit':457 'line':331,461,478 'link':314 'lint':450,491,507 'list':94,103,123,131,143,218,465 'local':34,269,368,377,393 'maintain':315,557 'markdown':91,306,326,449,527 'match':212 'metadata':312 'mirror':288 'miss':459,470 'mkdoc':1,8,59,383 'mkdocs.yml':388 'modifi':386 'must':105 'name':54,262 'nav':408 'never':501 'new':239,243,258,367,392,535 'next':185,194 'number':160,208,214 'object':69 'one':144,146 'order':97,149 'origin':86,297,317 'output':233,567 'path':57,357 'pila':433 'plugin':398 'portugues':42,287 'prefer':429 'preserv':84,304 'proceed':23,64,196 'profession':15 'prompt':189,502 'provid':271,379,404,544 'pt':44,283 'pt-br':43,282 'punctuat':467 'refer':361 'reflect':365 'remain':170,222 'reorder':154 'replac':372 'report':116 'requir':20 'resum':224 'role':11 'rule':413,554 'save':346,568 'say':485 'shown':150 'skill':5 'skip':153 'sourc':216 'source-github' 'space':481 'spanish':37,278 'specifi':28,81 'stack':430 'standard':426 'start':235 'step':195 'stop':156 'structur':88,231,294,563 'subdirectori':127,135 'suggest':439 'target':30,82,353,401,541,575 'task':102 'technic':16,418 'tecnológica':431,434 'termin':248 'terminolog':427 'text':472 'thing':486 'trail':466 'translat':2,10,19,31,55,70,96,138,165,177,202,210,255,302,323,338,348,406,409,411,412,420,522,530,548,566,570 'unprocess':223 'updat':61,358,359,385 'use':48,246,263,339,399,414,422,539,551 'user':26,120,274,382,504,547 'valu':50 'wait':513 'whether':167 'would':495 'wrap':321,520 'writer':17 'yet':175","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-04-22T06:52:25.933Z"},{"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-04-22T11:40:19.740Z"}],"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","source":"skills_sh","category":"awesome-copilot","skills_sh_url":"https://skills.sh/github/awesome-copilot/mkdocs-translations"},"updatedAt":"2026-04-22T11:40:19.740Z"}}