writing-clearly-and-concisely
Use when writing or tightening prose humans will read (README files, documentation, commit messages, error messages, explanations, reports, UI text, blog sections). Applies Strunk's rules (active voice, positive form, concrete words, omit needless words) while keeping the author's voice, facts, links, and code intact, and returns a change list tagged with rule numbers. Triggers on "tighten this", "make this clearer", "edit for clarity", "cut the fluff", "this rambles", "make this more concise".
Pinned to revision dc47cd62e8c4, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/writing-clearly-and-concisely/SKILL.md
- skills/writing-clearly-and-concisely/README.md
- skills/writing-clearly-and-concisely/elements-of-style/01-introductory.md
- skills/writing-clearly-and-concisely/elements-of-style/02-elementary-rules-of-usage.md
- skills/writing-clearly-and-concisely/elements-of-style/03-elementary-principles-of-composition.md
- skills/writing-clearly-and-concisely/elements-of-style/04-a-few-matters-of-form.md
- skills/writing-clearly-and-concisely/elements-of-style/05-words-and-expressions-commonly-misused.md
- skills/writing-clearly-and-concisely/scripts/check_edit.py
- skills/writing-clearly-and-concisely/signs-of-ai-writing.md
Every link opens the file at its source, pinned to the revision this page describes.