translate-blog

Translates Chinese blog articles to English with frontmatter transformation and mirrored output paths.

3|1|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/firstsun-dev/skills --skill translate-blog-firstsun-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: translate-blog
Source: https://github.com/firstsun-dev/skills/tree/main/custom/writing/translate-blog
Command: npx skills add https://github.com/firstsun-dev/skills --skill translate-blog-firstsun-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Publishing a bilingual blog requires manually translating each Chinese article, remapping frontmatter fields like category, tags, and author names, and placing the result in the correct English directory. This Skill automates that entire pipeline so a translated post lands in the right place with consistent metadata. ## Core Features & Use Cases - Full article translation: Translates the Markdown body from Chinese to English while preserving headings, code blocks, tables, and the original tone of the writing. - Frontmatter transformation: Applies fixed mapping rules for title prefixes, categories, and author names, translates tags and descriptions, and keeps slug, dates, and images unchanged. - Path mirroring: Mirrors the source path from blog/zh-tw/ to blog/en/, creating target directories when needed. - Use Case: You wrote a new post at blog/zh-tw/tech/ai-agent-coding.md and need an English version. Invoke the Skill and it produces blog/en/tech/ai-agent-coding.md with translated content and correctly mapped frontmatter. ## Quick Start Translate the Chinese article at blog/zh-tw/tech/my-post.md into English and save it to the mirrored English blog path.

Frequently Asked Questions about translate-blog

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

FAQPage Schema
How do I translate a Chinese blog post to English with an AI agent?▼

Provide the path to the Chinese article under blog/zh-tw/ and invoke the translate-blog skill. It reads the source, translates the body and frontmatter, and writes the English version to the mirrored path under blog/en/.

How does the skill handle frontmatter fields like slug and category?▼

The slug, pubDate, heroImage, and draft fields are kept exactly as-is. Category and title prefixes are converted using fixed Chinese-to-English mapping tables, while tags and descriptions are translated individually.

Does the translation preserve Markdown formatting and code blocks?▼

Yes. All Markdown structure including headings, tables, blockquotes, lists, and code blocks is preserved. Code itself is left unchanged, while Chinese comments inside code blocks are translated.

What happens if the English output directory does not exist?▼

The skill creates the missing target directory under blog/en/ automatically. After writing the file, it reports the output path and whether a new directory had to be created.

What are the limitations of this blog translation workflow?▼

It only handles articles sourced from blog/zh-tw/ and targets blog/en/. Title prefixes or categories outside the built-in maps are translated naturally rather than mapped, which may produce less consistent terminology.