SkillFoxx

Simplified Technical Chinese skill

A skill with a controlled Chinese for technical writing: 40 rules, a banned-word vocabulary and a checker modeled on ASD-STE100.

  • 82 ★ on the repository
  • Last commit
  • MIT
Skill

Minimal access

Why this level

  • The skill only changes text and runs a local checker, with no external calls.
All reasons and checks

mzopedia/simplified-technical-chineseAuthor:mzopedia

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/simplified-technical-chinese

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Minimal accessThe tool runs nothing and makes no network calls.

  • The skill only changes text and runs a local checker, with no external calls.

This is third-party code. Review the repository files before installing.

What it does

Simplified Technical Chinese (STC) is a controlled language for technical Chinese: procedures, API docs, troubleshooting guides and explanatory answers from LLMs. The goal is that a reader gets it right on the first read. The method comes from ASD-STE100, the controlled English of aircraft manuals: numbered rules, a vocabulary where one meaning equals one word and sentence constraints that a script can check. The repository holds 40 rules on two levels (must and should), a vocabulary of banned words and replacements, the `tools/check.py` checker on Python 3.9 with no dependencies and a skill for Claude Code, Codex and Cursor. The rules address Chinese specifics: 进行 plus verb, long pre-nominal modifiers, the ambiguity of 以上 and 以下, and the difference between 可以 and 支持. An instruction is at most 30 units and a description at most 40.

Who it is for. Authors of Chinese technical documentation and teams that ask a model to explain in Chinese briefly and unambiguously.

Good fit when

  • An installation procedure is rewritten into short unambiguous steps.
  • API docs are checked for banned words, long sentences and passive voice.
  • A model has to answer in Chinese in STC mode, without `请` and `您`.
  • A text is run through `check.py` with `--strict` before publication.

Not a fit when

  • The text is not in Chinese: the rules and vocabulary are written for Chinese.
  • You need a check of facts, term choice and logic: the checker is syntactic only.
  • You edit marketing or literary text: STC targets technical prose.

Example request

Rewrite this deployment guide in Simplified Technical Chinese and check the result with the `tools/check.py` script.

Limitations

Version 0.2. The vocabulary covers general technical writing, about 150 table entries, and not domain terminology. The checker catches banned words, synonyms, sentence and paragraph length, passive voice, double negation and open lists with 等, but does not judge facts, term choice, logic or meaning restrictions. There is no controlled reading study: calibration measured false positives on 3.5 million characters of documentation. A Russian-speaking user has to read Chinese to judge the edits. STC is not affiliated with ASD.

How to disable. Delete the `simplified-technical-chinese` folder from the agent skills directory. Remove the normal-mode system prompt from project settings.

FAQ

How do I connect the skill?

Run `npx skills add mzopedia/simplified-technical-chinese` or clone the repository into the skills folder: `git clone --depth 1 https://github.com/mzopedia/simplified-technical-chinese.git ~/.claude/skills/simplified-technical-chinese`.

What if I do not use the skill?

Paste the shortened rule set ("normal mode") from the README into the system prompt. The full set is in `规范.md`.

What options does the checker have?

`--strict` exits with code 1 on must-level findings, `--json` prints JSON, `--kind` forces a sentence type, `--max-op` and `--max-desc` change the length limits.

What does the checker skip?

Code, inline code, HTML comments, text inside 「」, YAML front matter and anything between `<!-- stc:off -->` and `<!-- stc:on -->`.

How does STC differ from ASD-STE100?

The method is the same, but the rules are written for Chinese. STC is not a translation of STE and not affiliated with ASD.

Discussion

No questions or reviews yet.

Skills

A skill for Chinese technical writing: rewrites docs, interface strings and API descriptions, keeps the facts intact and checks output with a linter

SkillMinimal access1.6K

Skill that rewrites Chinese technical text into controlled language: one action per sentence, active voice, one term per idea.

SkillMinimal access96

A skill for Chinese technical docs: short sentences, facts over adjectives and a 14-item check for AI tells

SkillExtended access415

Simplified Technical English Skill

simplified-technical-english

A skill that makes a model write in Simplified Technical English (ASD-STE100), a controlled English for technical documentation. Unofficial

SkillMinimal access1K

A skill that makes an agent write docs and replies in plain English on ASD-STE100 rules: short sentences, one term per meaning, condition before command

SkillExtended access4.4K

A skill that rewrites dense, ambiguous English into ASD-STE100 Simplified Technical English so another agent cannot misread it

SkillMinimal access6.4K

README in short

The README shows a rewrite example, explains the motivation (a Karpathy post about STE in October 2026), the contents, the main rules, agent usage, checker commands and limits.

README badge

Original SKILL.md

---
name: simplified-technical-chinese
description: 用简明技术中文（STC）写或改写中文技术内容：操作步骤、安装部署、故障排查、接口和参数说明、技术概念解释、给人读的解释性回答。用户提到「简明技术中文」「STC」「受控中文」「像 ASD-STE100 那样写中文」「一词一义」时使用；用户要求把中文技术说明「写清楚」「别有歧义」时也可使用。不用于营销文案、叙事、法律原文和代码。
---

# 简明技术中文

目标：读者读一遍就不会读错。做法：限制用词，限制句式，一句一事。

完整规则见 [规范.md](规范.md)，词表见 [词表.md](词表.md)。本文件只列最常用的部分。

## 模式

- 常规模式（默认）：执行全部【必须】规则和词表的自动检查条目。【建议】规则只在明显时处理。
- 严格模式：用户说「严格」「全部规则」时，执行全部规则。

用户没有说明时用常规模式。

## 写之前先分类

- 操作句：告诉读者做什么。放在编号列表里，动词开头，不超过 30 字。
- 描述句：其他句子。不超过 40 字。

字数算法：每个汉字计 1，每个英文单词或数字串计 1，行内代码计 1，标点不计。

## 必须遵守的规则

词：

- 一个概念全文只用一个词。不换同义词。（1.1）
- 不用「进行」「加以」「作出」「予以」加动词。直接用动词。（1.4）
- 不用没有数值的程度词：「很」「非常」「较」「大量」「尽快」「及时」。写数值或条件。（1.5）
- 缩写首次出现写全称并括注，之后固定写法。（1.6）
- 不用黑话：「赋能」「抓手」「闭环」「拉通」「沉淀」「痛点」「对标」「打法」「拉齐」。（1.7）

句：

- 一句只说一件事。分号不能用来把两句并成一句。（2.2）
- 操作句用祈使句，不写「请」「您」「用户需要」「应该」。（2.3）
- 用主动句，写出执行者。「被」「由」「受到」是信号。（2.4）

Report a problem