tech-doc-style-chinese — skill for Claude Code and Codex
Style rules for Chinese technical writing: spacing between CJK and Latin, corner brackets, no buzzwords. Ships with a Python linter.
npx skills add reason-machines/trending-skills --skill tech-doc-style-chinese -a claude-codeWhat tech-doc-style-chinese does
The skill covers Chinese product copy, UI strings, API references, FAQs and changelogs. Typography comes first. A space goes between Chinese characters and Latin letters or digits, and visible text uses corner brackets 「」 instead of curly quotes. Code literals, JSON keys, URLs and database field names are exempt.
Tone rules are just as specific. Direct address with 你 or 您 is out, and so are buzzwords like 赋能 or 抓手. English status words get translated by meaning: Success becomes 请求已完成, not a literal 成功. Tables cover common typos and term casing, so id turns into ID, json into JSON, llm into LLM.
The repo includes scripts/lint_copy_rules.py, a zero-dependency script that checks files or directories. CI runs it on pull requests. Project-specific conventions belong in references/Project-Overrides.md, invoked alongside the skill — otherwise the linter flags your own module names.
What it helps with
- add spacing between Chinese characters and Latin text
- swap curly quotes for corner brackets in visible strings
- strip buzzwords like
赋能from product copy - translate English API statuses without calques
- check term casing and common typos before publishing
Example prompts for the agent
- Rewrite this Chinese copy using $tech-doc-style-chinese
- Run
python scripts/lint_copy_rules.py docs/and list the violations - Apply $tech-doc-style-chinese and
references/Project-Overrides.mdto this API page
How to install tech-doc-style-chinese
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill tech-doc-style-chinese -a claude-code2Manually: put the files in place
~/.claude/skills/tech-doc-style-chinese/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/tech-doc-style-chinese/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill tech-doc-style-chinese -a codex2Manually: put the files in place
.agents/skills/tech-doc-style-chinese/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill tech-doc-style-chinese -a cursor2Manually: put the files in place
.cursor/skills/tech-doc-style-chinese/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/trending-skills tech-doc-style-chinese2Manually: put the files in place
.github/skills/tech-doc-style-chinese/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill tech-doc-style-chinese -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/trending-skills --path skills/tech-doc-style-chineseManually: put the files in place
.devin/skills/tech-doc-style-chinese/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill tech-doc-style-chinese -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about tech-doc-style-chinese
How do I install tech-doc-style-chinese in Claude?
Run npx skills add reason-machines/trending-skills --skill tech-doc-style-chinese -a claude-code. The skill file lands at ~/.claude/skills/tech-doc-style-chinese/SKILL.md.
What does tech-doc-style-chinese do?
It sets writing rules for Chinese technical documentation: typography, tone, status translation and section structure. A linter checks your text against them.
How is it different from plain style guides?
It ships a runnable lint script plus tables of typos and term casing. Project conventions go into references/Project-Overrides.md so they do not fight the core rules.
