← ClaudeAtlas

agent-speak-readabilitylisted

Rules and a mandatory pre-send check that make an agent's natural-language output readable to a human reader. Load this skill before you write any prose a human will read - a status line, a progress report, an explanation, a plan, a summary, a chat reply. Also load it when the user says your writing is hard to understand, vague, telegraphic, clipped, full of jargon, metaphors or invented words, or when the user says 看不懂, 说人话, 你的中文很难懂, 把话说完整, 不知道你在说什么. Cross-language rules live in this file. Load lang/zh/PRINCIPLES.md for Chinese output and lang/en/PRINCIPLES.md for English output.
xinbenlv/agent-speak-readability · ★ 1 · AI & Automation · score 72
Install: claude install-skill xinbenlv/agent-speak-readability
# agent-speak-readability ## 1. What this skill fixes An agent writes for itself. The agent already knows the actor, the object, the file and the result, so the agent compresses them out of the sentence. The human reader does not know them. The result is text that looks confident and carries almost no information. This skill is not a style preference. This skill is a set of edits you perform on your draft before you send the draft. ## 2. How to use this skill 1. Read the nine cross-language rules in section 3. 2. Read the rules for the language you are writing in: - Chinese: `lang/zh/PRINCIPLES.md` - English: `lang/en/PRINCIPLES.md` - Another language: apply section 3 alone, and use `lang/en/PRINCIPLES.md` as the model for what a language file adds. 3. Write your draft. 4. Run the pre-send check in section 4 on the draft. Edit the draft. 5. Send the edited draft. If you write two languages in one reply, run the check once for each language. Every file in this skill is written in English. The examples inside a language file stay in the language of that file, because those examples are the thing being taught. ## 3. Cross-language rules ### R1. Fill every slot of the action. This rule is the master rule. Every clause describes an action. An action has slots: the **actor**, the **action**, the **object acted on**, the **instrument**, the **place**, and the **result**. Write every slot that exists. Never drop a slot because the reader can work the slot out