baoyu-translate

Translate articles between languages with quick, normal, and refined modes.

Updated May 18, 2018
One-click install
npx skills add https://github.com/812lcl/dotfiles --skill baoyu-translate-812lcl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: baoyu-translate
Source: https://github.com/812lcl/dotfiles/tree/main/.agents/skills/baoyu-translate
Command: npx skills add https://github.com/812lcl/dotfiles --skill baoyu-translate-812lcl

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires markdown-it, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Translates articles and documents between languages with three modes - quick (direct), normal (analyze then translate), and refined (analyze, translate, review, polish). Supports custom glossaries and terminology consistency via EXTEND.md. Use when user asks to "translate", "翻译", "精翻", "translate article", "translate to Chinese/English", "改成中文", "改成英文", "convert to Chinese", "localize", "本地化", or needs any document translation. Also triggers for "refined translation", "精细翻译", "proofread translation", "快速翻译", "快翻", or when a URL or file is provided with translation intent.

Core Features & Use Cases

  • Three-mode translation: quick, normal, refined with dedicated workflows
  • Glossary support via EXTEND.md and built-in glossary references
  • Chunked translation for long content with per-chunk processing and terminology consistency
  • Frontmatter-aware translation preserving metadata
  • Optional resources under scripts/, references/, assets/

Use cases: translating articles, localizing documents, and processing long-form content with terminology consistency.

Quick Start

Provide the source text or URL, specify target language and mode, and Baoyu-translate will perform the translation.

Frequently Asked Questions about baoyu-translate

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

FAQPage Schema
How do I translate long markdown articles with consistent terminology?

Translating long markdown articles with consistent terminology requires a chunked workflow that processes content per-chunk while merging built-in glossaries and custom EXTEND.md entries to maintain term consistency throughout the document.

What is the difference between quick, normal, and refined translation modes?

Quick translation mode performs a direct translation, normal mode analyzes the text before translating, and refined mode adds a review and polish step after translating to produce higher quality localized content.

Can I preserve frontmatter metadata when translating markdown documents?

Yes, you can preserve frontmatter metadata when translating markdown documents because the translation process is frontmatter-aware, ensuring that your YAML metadata remains intact while the body content is localized.

How do I set up a custom glossary for multilingual document localization?

You can set up a custom glossary for multilingual document localization by creating an EXTEND.md file with your specific terminology entries, which the translator merges with built-in glossaries during the translation process to ensure consistent vocabulary.

Does markdown-based translation work with dependencies like markdown-it?

Yes, markdown-based translation works with the markdown-it dependency to parse and process markdown formatting, allowing the tool to accurately translate text while preserving structural elements like headers, links, and code blocks.

When should I use refined translation instead of quick translation for articles?

You should use refined translation instead of quick translation when you need high-quality localized content, as refined mode includes analysis, translation, review, and polish steps, whereas quick mode is best for fast direct translations.