translate

To translate English Markdown articles into Chinese while preserving frontmatter, use this Skill to generate per-slug translated files with correct frontmatter structure. It automatically rewrites image references and adds a mandatory translated date field.

Handling image references during Markdown article localization requires rewriting links into ./images/<slug>/ directories. This Skill safely copies per-article assets and updates references to ensure links remain valid in the translated output.

To verify Markdown translation quality, run the built-in translate-verify validation step. It catches leftover ./assets/ references, missing images, incorrect frontmatter shape, and untranslated titles to ensure complete article localization.

You can convert individual article slugs from a specified input_root to an output_root directory. The Skill processes per-slug translated Markdown files, requiring you to provide slugs, input paths, output paths, and date in your request.

Translated Markdown files show residual ./assets/ links when the verification step is skipped or fails. The Skill enforces no residual ./assets/ links by rewriting image references into ./images/<slug>/ and validating file consistency.

You need YAML dependency support to translate technical writing Markdown files into Chinese. This dependency is required to correctly preserve, parse, and generate the frontmatter structure in the per-slug translated output files.