agent-speak-readabilitylisted
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