clear-writing
Installation
SKILL.md
Clear Writing
Write prose with plain force: specific facts, strong verbs, short paths from subject to action, and no ceremonial filler.
Editing Loop
For new prose, draft once, then edit. For existing prose, edit directly.
- Identify the reader, purpose, and the action or understanding the prose should support.
- Preserve information over shape. Keep supported facts, uncertainty, intent, established voice, domain distinctions, and technical literals. Leave unknowns unknown instead of adding plausible specifics.
- Make the main claim explicit. If there is no main claim, write one before polishing.
- Put actors before actions where possible. Prefer active voice unless passive voice keeps the right subject in focus.
- Replace vague praise, empty hedging, and abstractions with concrete facts. Keep uncertainty that changes the meaning.
- Omit needless words, throat-clearing, recap sentences, and generic transitions.
- Read the result for clusters of AI tells: puffery, empty "-ing" phrases, promotional adjectives, ornate metaphors, excessive bolding, and conclusion boilerplate.
- Return the revised prose first. Add notes only when the user asked for explanation or when a tradeoff matters.
Completion criterion: the revision preserves the source's information and uncertainty. Every sentence must state a fact, give an instruction, name a decision, or help the reader act or understand. If a sentence only sounds helpful, delete or replace it.