← ClaudeAtlas

clarity-editinglisted

Edit written text for clarity and conciseness — active voice, hedge and weasel-word removal, jargon strip, sentence compression, nominalization fixes, and readability. Use when the user asks to tighten, shorten, edit, or clarify a paragraph or doc, remove hedges and weasel words, convert to active voice, cut jargon, kill passive voice, fix nominalizations, or improve readability. NOT for structuring the overall doc (use structured-writing). NOT for UI microcopy (use ux-writing). NOT for auto-generating docs from code (use documentation-generator). NOT for design-system content/tone (use consistency-standards).
viktorbezdek/skillstack · ★ 9 · Data & Documents · score 74
Install: claude install-skill viktorbezdek/skillstack
# Clarity Editing Good writing is rewriting. First draft: get the thought on the page. Second draft: make the thought disappear behind the sentence. This skill is the second draft. ## The four editing passes Run in order. Each pass targets one problem. ### Pass 1 — compress Cut every word that does not carry its weight. Typical savings: 20-40%. | Cut | Keep | |---|---| | "in order to" | "to" | | "due to the fact that" | "because" | | "at this point in time" | "now" | | "a number of" | "several" / "many" / a number | | "is able to" | "can" | | "make a decision" | "decide" | | "in the event that" | "if" | | "on a daily basis" | "daily" | Sentence-level compression: if a sentence is over 25 words, look for a comma that could be a period. ### Pass 2 — active voice Passive voice hides the actor and adds words. | Passive | Active | |---|---| | "A decision was made by the team to defer the launch." | "The team deferred the launch." | | "It has been observed that users are churning." | "Users are churning." | | "The bug was caused by the cache layer." | "The cache layer caused the bug." | Exceptions — use passive when: - The actor is irrelevant ("the package was delivered"). - The actor is unknown. - You deliberately de-emphasize the actor (accountability writing). Default: active. Every passive sentence should be deliberate. ### Pass 3 — strip hedges Hedges and weasel words sap authority. | Hedge | Strip to | |---|---| | "I think that it might be a good idea to" | ""