convert-docs

Translate English Markdown documentation into a target language directory.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/a2f0/tearleads --skill convert-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convert-docs
Source: https://github.com/a2f0/tearleads/tree/main/.codex/skills/convert-docs
Command: npx skills add https://github.com/a2f0/tearleads --skill convert-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the translation of documentation from a source language (English) to a target language, ensuring consistency and completeness across different language versions of your docs.

Core Features & Use Cases

  • Automated Translation: Translates Markdown files from docs/en/ to a specified target language folder (e.g., docs/es/).
  • Structure Preservation: Maintains the original Markdown structure, including headings, lists, links, code blocks, and frontmatter.
  • Orphaned File Pruning: Removes translated files in the target directory that no longer have a corresponding source file in English.
  • Use Case: A global software company needs to maintain its documentation in English, Spanish, and Ukrainian. This Skill can be used to translate new English documentation into Spanish and Ukrainian, ensuring all language versions are up-to-date.

Quick Start

Translate the English documentation into Spanish by running the convert-docs skill with the target language set to 'es'.

Frequently Asked Questions about convert-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate markdown documentation translation into multiple languages?

Automated documentation translation reads Markdown files from an English source directory and outputs them to a target language folder. It translates the content while preserving the original Markdown structure, including headings, lists, links, and code blocks.

Does documentation translation preserve Markdown structure and frontmatter?

Yes, translating documentation preserves the original Markdown structure. It maintains formatting elements like headings, lists, links, code blocks, and frontmatter during the translation process to ensure the output files match the source layout.

How do I handle orphaned files when localizing technical documentation?

Orphaned file pruning removes translated files in the target language directory that no longer have a corresponding source file in the English directory. This keeps your localized documentation sets clean and synchronized with the source content.

Can I use automated localization workflows for user guides and technical docs?

Yes, automated localization workflows support translating technical documentation and user guides. By translating Markdown files from a source language to a specified target language directory, it ensures consistency across different language versions of your docs.

What is the best way to maintain multi-language documentation across updates?

Maintaining multi-language documentation involves translating new English source files to specified target language folders and pruning orphaned files. This automated localization workflow ensures all language versions remain up-to-date and structurally consistent.

Do I need natural language processing capabilities for content translation?

Yes, content translation requires natural language translation capabilities. The process reads English source files, translates the text content using these capabilities, and writes the localized output to the target directory using file system operations.