chinese-documentation

Applies Chinese technical writing conventions for spacing, punctuation, terminology, and document structure.

Updated Jun 11, 2026
One-click install
npx skills add https://github.com/marcocpt/trae_skills --skill chinese-documentation-marcocpt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: chinese-documentation
Source: https://github.com/marcocpt/trae_skills/tree/main/chinese-documentation
Command: npx skills add https://github.com/marcocpt/trae_skills --skill chinese-documentation-marcocpt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Chinese technical documents often read awkwardly due to missing spaces between Chinese and English text, mixed full-width and half-width punctuation, over-translated terminology, and machine-translation style phrasing. This Skill provides a complete set of writing conventions so documentation reads naturally and consistently. ## Core Features & Use Cases - Typography Rules: Enforces spacing between Chinese/English text and numbers, correct full-width vs half-width punctuation, and proper bracket and quote usage. - Terminology Guidance: Defines when to keep English terms (React, API, Redis) versus translate them, with first-occurrence bilingual annotation. - Ready-Made Templates: Provides bilingual API documentation templates and a Chinese README structure for open-source projects. - Use Case: When writing a Chinese README or API reference for an open-source project, apply these rules to eliminate machine-translation tone, fix punctuation mixing, and produce a professional document with a pre-publication checklist. ## Quick Start Review my Chinese technical document and fix all spacing, punctuation, and terminology issues according to standard Chinese copywriting conventions.

Frequently Asked Questions about chinese-documentation

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

FAQPage Schema
How do I format mixed Chinese and English text in technical documents?

Add a space between Chinese characters and English words or numbers, such as "使用 Git 进行版本管理". Do not add spaces around full-width punctuation, and keep degree and percent symbols attached to numbers like 95%.

Which technical terms should stay in English in Chinese documentation?

Keep proper nouns like React, Kubernetes, and Redis, common abbreviations like API, SDK, and CI/CD, commands and code, and terms without accepted Chinese translations such as debounce or middleware. Translate only concepts with established Chinese equivalents.

Should Chinese technical writing use full-width or half-width punctuation?

Use full-width punctuation (,。:) in Chinese sentences and half-width punctuation in English or code contexts. Use full-width parentheses for Chinese content but half-width parentheses when the enclosed content is English or version numbers.

How do I avoid machine-translation tone in Chinese documentation?

Replace passive constructions like "被用来" with direct phrasing like "用于", remove redundant pronouns, split long European-style sentences into short ones, and use lists and tables to structure dense information.

What structure should a Chinese README for open-source projects use?

A typical structure includes a one-line project introduction, feature list, quick start with environment requirements and installation, documentation links, contribution guide, acknowledgments, and license section.