writing-clearly-and-concisely

obra/the-elements-of-style · updated Apr 8, 2026

$npx skills add https://github.com/obra/the-elements-of-style --skill writing-clearly-and-concisely
0 commentsdiscussion
summary

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
skill.md

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:

  1. Write your draft using judgment
  2. Dispatch a subagent with your draft and elements-of-style.md
  3. Have the subagent copyedit and return the revision

All Rules

Elementary Rules of Usage (Grammar/Punctuation)

  1. Form possessive singular by adding 's
  2. Use comma after each term in series except last
  3. Enclose parenthetic expressions between commas
  4. Comma before conjunction introducing co-ordinate clause
  5. Don't join independent clauses by comma
  6. Don't break sentences in two
  7. Participial phrase at beginning refers to grammatical subject

Elementary Principles of Composition

  1. One paragraph per topic
  2. Begin paragraph with topic sentence
  3. Use active voice
  4. Put statements in positive form
  5. Use definite, specific, concrete language
  6. Omit needless words
  7. Avoid succession of loose sentences
  8. Express co-ordinate ideas in similar form
  9. Keep related words together
  10. Keep to one tense in summaries
  11. 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.
general reviews

Ratings

4.540 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

1 / 4