writing-translate

Translate documents and blog posts into specified languages while preserving formatting.

Updated Dec 2, 2025

Search Tags:#markdown #technical writing #localization #translation #language #document translation

Ready to run

npx skills add https://github.com/qlawmarq/dotfiles-common --skill writing-translate

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: writing-translate
Source: https://github.com/qlawmarq/dotfiles-common/tree/main/skills/writing-translate
Command: npx skills add https://github.com/qlawmarq/dotfiles-common --skill writing-translate

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the translation of documents and blog posts into various languages, ensuring natural, high-quality output and preserving formatting.

Core Features & Use Cases

Multi-language Translation: Translates text into specified languages using language codes.
Front Matter Handling: Preserves and translates front matter fields like title and description.
Technical Document Translation: Accurately translates technical content, leaving code elements untranslated.
Use Case: Translate a technical blog post from Japanese to English, ensuring all code snippets and technical terms are handled correctly, and save it as a new Markdown file.

Quick Start

Translate the file 'article.md' into English.

Frequently Asked Questions about writing-translate

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

FAQPage Schema

How do I translate a markdown document into another language while preserving formatting?▼

To translate a markdown document while preserving formatting, this Skill processes the text and ensures natural output without breaking existing markdown structures. It handles front matter fields like title and description, leaving code elements untranslated for accurate technical document translation.

Can I translate technical blog posts without altering code snippets and technical terms?▼

Yes, you can translate technical blog posts while leaving code snippets and technical terms untouched. This Skill accurately translates technical content by identifying and preserving code elements, ensuring the translated document remains structurally and functionally identical to the original.

Does document translation support front matter processing for multilingual blog posts?▼

Document translation supports front matter processing by identifying and translating specific metadata fields like title and description. This ensures your multilingual blog posts retain proper SEO metadata and structural formatting in the target language output.

What is the best way to translate a Japanese blog post into English?▼

The best way to translate a Japanese blog post into English is using this Skill, which accepts the file and target language code to generate high-quality, natural text. It correctly handles technical terms and formatting, allowing you to save the result as a new Markdown file.

How do I output translated documents as new files?▼

You can output translated documents as new files by specifying the file translation option during processing. This Skill reads your original document, translates the text into the specified language, and provides options for direct file output or text translation.

Are there limitations when translating technical documents with embedded code blocks?▼

When translating technical documents with embedded code blocks, the limitation is that code elements are intentionally left untranslated to preserve functionality. This ensures technical accuracy but means any comments within the code blocks will also remain in the original language.