baoyu-translate

Translates markdown articles between languages using quick, normal, and refined multi-stage workflows.

2|Updated May 30, 2026
One-click install
npx skills add https://github.com/virahitvin8/crafty-gis --skill baoyu-translate-virahitvin8
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: baoyu-translate
Source: https://github.com/virahitvin8/crafty-gis/tree/main/GIT_STAR/assignment-generator/antigravity-skills-main/antigravity-skills-main/skills/baoyu-translate
Command: npx skills add https://github.com/virahitvin8/crafty-gis --skill baoyu-translate-virahitvin8

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Translating long articles and documents often produces inconsistent terminology, stiff machine-like phrasing, and lost markdown structure, especially when content exceeds context limits. ## Core Features & Use Cases - Three Translation Modes: Quick mode for direct translation, normal mode with content analysis first, and refined mode with analyze, draft, critique, revise, and polish stages for publication quality. - Chunked Long-Document Translation: Splits markdown over 4000 words at block boundaries using a markdown-it based script, then translates chunks in parallel with a shared glossary prompt for terminology consistency. - Custom Glossaries and Preferences: Supports EXTEND.md preference files with custom glossaries, audience profiles, and style presets, plus a built-in English-to-Chinese glossary. - Use Case: A user provides a 10,000-word English blog post URL and asks to translate it to Chinese; the skill analyzes the content, chunks it, translates each chunk with consistent terminology, then reviews and polishes the final markdown output. ## Quick Start Translate this article to Chinese using refined mode and save the result with consistent terminology.

Frequently Asked Questions about baoyu-translate

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

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

Use normal or refined mode, which chunks content over 4000 words at markdown block boundaries and translates each chunk with a shared prompt containing the merged glossary. This keeps term translations consistent across all chunks.

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

Quick mode translates directly in one pass. Normal mode analyzes the content first, then translates. Refined mode runs a full workflow of analysis, draft, critical review, revision, and polish for publication-quality output.

How do I add a custom glossary for translation?

Create an EXTEND.md file in your project or home config directory with a glossary section listing from and to term pairs in YAML. You can also reference external glossary files in markdown table or YAML format.

Does the translation preserve markdown formatting?

Yes, all markdown formatting is preserved including headings, bold, italic, images, links, and code blocks. YAML frontmatter fields are renamed with a source prefix and translated values are added as new fields.

What runtime is required to run the chunking script?

The chunking script requires bun, or npx as a fallback to run bun on demand. It depends on the markdown-it package for parsing markdown into blocks before splitting.