writing-clearly-and-concisely▌
obra/the-elements-of-style · updated Apr 8, 2026
Apply Strunk's timeless writing rules to improve clarity and professionalism across all prose.
- ›Covers 18 core rules spanning grammar, punctuation, composition principles, and common usage mistakes
- ›Emphasizes active voice, positive framing, concrete language, and ruthless word elimination as key clarity drivers
- ›Designed for documentation, commit messages, error messages, UI copy, reports, and any prose humans will read
- ›Includes token-efficient subagent dispatch pattern: write a dra
Writing Clearly and Concisely
Overview
William Strunk Jr.'s The Elements of Style (1918) teaches you to write clearly and cut ruthlessly.
WARNING: elements-of-style.md consumes ~12,000 tokens. Read it only when writing or editing prose.
When to Use This Skill
Use this skill whenever you write prose for humans:
- Documentation, README files, technical explanations
- Commit messages, pull request descriptions
- Error messages, UI copy, help text, comments
- Reports, summaries, or any explanation
- Editing to improve clarity
If you're writing sentences for a human to read, use this skill.
Limited Context Strategy
When context is tight:
- Write your draft using judgment
- Dispatch a subagent with your draft and
elements-of-style.md - Have the subagent copyedit and return the revision
All Rules
Elementary Rules of Usage (Grammar/Punctuation)
- Form possessive singular by adding 's
- Use comma after each term in series except last
- Enclose parenthetic expressions between commas
- Comma before conjunction introducing co-ordinate clause
- Don't join independent clauses by comma
- Don't break sentences in two
- Participial phrase at beginning refers to grammatical subject
Elementary Principles of Composition
- One paragraph per topic
- Begin paragraph with topic sentence
- Use active voice
- Put statements in positive form
- Use definite, specific, concrete language
- Omit needless words
- Avoid succession of loose sentences
- Express co-ordinate ideas in similar form
- Keep related words together
- Keep to one tense in summaries
- Place emphatic words at end of sentence
Section V: Words and Expressions Commonly Misused
Alphabetical reference for usage questions
Bottom Line
Writing for humans? Read elements-of-style.md and apply the rules. Low on tokens? Dispatch a subagent to copyedit with the guide.
Discussion
Product Hunt–style comments (not star reviews)- No comments yet — start the thread.
Ratings
4.5★★★★★40 reviews- ★★★★★Kwame Jackson· Dec 28, 2024
Registry listing for writing-clearly-and-concisely matched our evaluation — installs cleanly and behaves as described in the markdown.
- ★★★★★Advait Lopez· Dec 24, 2024
writing-clearly-and-concisely fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
- ★★★★★Dhruvi Jain· Dec 8, 2024
Solid pick for teams standardizing on skills: writing-clearly-and-concisely is focused, and the summary matches what you get after install.
- ★★★★★Harper Gill· Dec 8, 2024
writing-clearly-and-concisely is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
- ★★★★★Oshnikdeep· Nov 27, 2024
We added writing-clearly-and-concisely from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
- ★★★★★Hassan Gonzalez· Nov 23, 2024
Keeps context tight: writing-clearly-and-concisely is the kind of skill you can hand to a new teammate without a long onboarding doc.
- ★★★★★Harper Rao· Nov 19, 2024
Useful defaults in writing-clearly-and-concisely — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
- ★★★★★Kwame Mehta· Nov 15, 2024
writing-clearly-and-concisely has been reliable in day-to-day use. Documentation quality is above average for community skills.
- ★★★★★Ganesh Mohane· Oct 18, 2024
writing-clearly-and-concisely fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
- ★★★★★Jin Jain· Oct 14, 2024
writing-clearly-and-concisely is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
showing 1-10 of 40