concise-writing

star 1

Enforces tight, scannable prose in all writing output. Use when the user says "write", "draft", "summarize", "document", "README", "message", "announcement", or any task producing prose — technical docs, commit messages, PR descriptions, emails, reports. Applies conciseness rules: cut filler, active voice, lead with the point, concrete over abstract. Do NOT use for creative writing, fiction, or when the user explicitly asks for verbose/detailed explanations.

zachmayer By zachmayer schedule Updated 3/12/2026

name: concise-writing description: > Enforces tight, scannable prose in all writing output. Use when the user says "write", "draft", "summarize", "document", "README", "message", "announcement", or any task producing prose — technical docs, commit messages, PR descriptions, emails, reports. Applies conciseness rules: cut filler, active voice, lead with the point, concrete over abstract, state each fact exactly once. Do NOT use for creative writing, fiction, or when the user explicitly asks for verbose/detailed explanations.

Apply these principles to all writing output:

Core Rules

  1. Eliminate filler - Remove words that add no meaning: "basically", "essentially", "in order to", "it should be noted that", "as a matter of fact"
  2. Active voice - "The function returns X" not "X is returned by the function"
  3. One idea per sentence - If a sentence has "and" or "but", consider splitting it
  4. Lead with the point - Put conclusions first, supporting details after
  5. Concrete over abstract - "Latency dropped from 200ms to 50ms" not "Performance improved significantly"
  6. State each fact exactly once - The document's structure should make repetition unnecessary; if a fact recurs, reorder so it's needed once

Structure

  • Short paragraphs - 2-4 sentences max
  • Use lists for 3+ related items
  • Use headers to let readers skip to what they need
  • Front-load the most important information
  • Apply Gestalt principles - organize the page with proximity, similarity, and whitespace so layout carries structure the prose needn't restate

Cut List

Remove these on sight:

  • "I think" / "I believe" - just state it
  • "Very" / "really" / "quite" - find a stronger word or drop it
  • "In terms of" - rephrase
  • "The fact that" - rephrase
  • "It is important to note that" - just note it
  • Throat-clearing introductions ("Before we begin...", "First, let me say...")

Test

After writing, ask: "Can I remove any sentence without losing meaning?" If yes, remove it.

Install via CLI
npx skills add https://github.com/zachmayer/skills --skill concise-writing
Repository Details
star Stars 1
call_split Forks 0
navigation Branch main
article Path SKILL.md
More from Creator