
copy-editor
Performs line-level prose editing — pruning adverbs, activating voice, cutting redundancy, and enforcing parallel structure for concision and readability. Use when revising any written content, even if the request is just 'make this better,' 'tighten this up,' or 'clean up the writing.'
- Installs
- 46
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/joellewis/skill-library --skill copy-editor- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads copy-editor automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Overview
Copy-editing is the tactical refinement of prose at the sentence level. It transforms a "Shitty First Draft" into vigorous, clear communication by pruning adverbs, activating the voice, and expunging fad words. The goal is to ensure that every word "tells" and that the reader never stumbles over convoluted logic or unnecessary complexity.
Guiding Principles
Principle 1: The "Dental Draft" (Source: Lamott, Bird by Bird)
Treat editing as a process of checking every tooth. Once the "Down Draft" (getting thoughts on paper) is complete, perform a meticulous "Dental Draft" to see if each sentence is loose, cramped, or healthy.
Principle 2: Omit Needless Words (Source: Strunk, The Elements of Style)
Vigorous writing is concise. If a word does not add meaning, cut it. Eliminate qualifiers (e.g., "very," "rather," "basically") and "verbal false limbs" (e.g., "the fact that," "in order to").
Principle 3: Use the Active Voice (Source: Strunk, The Elements of Style)
The active voice is more direct and forceful. Replace passive constructions ("The report was written by him") with active ones ("He wrote the report"). This usually results in shorter, stronger sentences.
Principle 4: Expunge Fad Words (Source: McPhee, Draft No. 4)
Mercilessly go after "fad words" that have lost their meaning through overusage (e.g., "pivot," "proactive," "iconic," "reach out"). Replace them with specific, accurate English.
Principle 5: Kill the Adverb (Source: Hemingway App / Lamott)
Adverbs are often a sign of weak verbs. Instead of "he ran quickly," use "he sprinted." Use blue highlights (figuratively or literally) to identify adverbs and replace them with stronger verbs or nouns.
When to Use This Skill
- Refining a finished draft for publication or executive review.
- Improving the readability of complex technical documentation.
- Pruning wordy or "fluffy" marketing copy.
- Shortening a document to fit a specific length or page count.
When NOT to Use This Skill
- During the "Shitty First Draft" phase (where self-correction kills flow).
- When writing dialogue or first-person memoirs where a specific, potentially "imperfect" voice is the goal.
Core Process
Step 1: The "Down Draft" Acceptance (Source: Lamott, Bird by Bird)
Acknowledge that your first draft is supposed to be bad. Do not edit while writing. Get everything on the page through your "one-inch picture frame."
Step 2: The Strunkian Pruning (Source: Strunk, The Elements of Style)
Review the draft specifically for:
- Active Voice: Subject -> Verb -> Object.
- Positive Form: Describe what is, not what isn't.
- Parallelism: Express coordinate ideas in similar form.
Step 3: The Hemingway Audit (Source: Hemingway App methodology)
Identify and fix readability "Red Flags":
- Yellow/Red Sentences: Split sentences that are too long or contain more than two clauses.
- Purple Words: Replace complex vocabulary with everyday English.
- Blue Adverbs: Delete them or upgrade the verb.
Step 4: The McPhee "All" Check (Source: McPhee, Draft No. 4)
Scan for repetition. If a unique or "expensive" word (e.g., "horripilation") is used once, it adds flavor; if used twice, it becomes a mannerism. Check for overused transitions like "but" or "however."
Step 5: The "Read Aloud" Final (Source: Lamott / Strunk)
Read the entire piece aloud. Your ear will catch the "mechanical symmetry" and clunky rhythms that your eye misses. If you run out of breath before finishing a sentence, it is too long.
Frameworks & Models
The Three Drafts (Source: Lamott, Bird by Bird)
- The Down Draft: Getting it all down (Child's draft).
- The Up Draft: Fixing it up (Grown-up draft).
- The Dental Draft: Checking every tooth (Editor's draft).
The Hemingway Readability Grade
- Aim for Grade 9 or below: Most professional writing should be readable by a 9th-grader.
- Complex sentences (Red): Logic is meandering; must be broken apart.
- Hard to read (Yellow): Sentence is too dense; needs shortening.
Cross-Skill Invocations
REQUIRED SUB-SKILL: None. RECOMMENDED SUB-SKILL: non-fiction-precision — to ensure the structure is sound before fixing the sentences.
Common Mistakes
- Over-editing too early: Trying to make the first sentence perfect and never finishing the paragraph. (Source: Lamott)
- The "Forceful" vs "Forcible" Trap: Using the wrong word because it sounds more "sophisticated." (Source: Strunk)
- Mannerisms: Falling into a "singsong" rhythm of sentences that are all the same length. (Source: McPhee)
- Performative Framing: Using syntactic patterns that manufacture tension instead of stating things plainly. These feel manipulative and erode trust: (Source: Strunk / Graham)
- Contrast framing: "This isn't X, it's Y" — just state what it is.
- Engagement bait / false suspense: "But here's the thing," "Here's what most people get wrong" — skip the windup and deliver the point.
- Contrarian hooks: "The real question is…" — manufactured disagreement before a straightforward claim. Direct, confident prose states things as they are. If the point is strong, it does not need a theatrical frame.
Diagnostic Checklist
- Have I replaced all passive voice with active voice?
- Have I eliminated adverbs by using stronger verbs?
- Are there any "fad words" or jargon that can be simplified?
- Does the sentence length vary to avoid monotony?
- Have I checked for unique words that are used more than once?
- Is the prose free of performative framing (contrast hooks, engagement bait, contrarian setups)?
Sources
- Strunk, William. The Elements of Style. Ch. 2 (Elementary Principles of Composition), Ch. 5 (An Approach to Style).
- McPhee, John. Draft No. 4. Ch. 2 (Structure), Ch. 4 (Checkpoints).
- Lamott, Anne. Bird by Bird. "Shitty First Drafts," "Short Assignments," "Perfectionism."
- Hemingway Editor methodology (hemingwayapp.com).
FAQ
What does the copy-editor skill do?
Performs line-level prose editing — pruning adverbs, activating voice, cutting redundancy, and enforcing parallel structure for concision and readability. Use when revising any written content, even if the request is just 'make this better,' 'tighten this up,' or 'clean up the writing.'
How do I install copy-editor?
Run npx skills add https://github.com/joellewis/skill-library --skill copy-editor in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/copy-editor/ (personal) or .claude/skills/copy-editor/ (project).
Which AI agents can use copy-editor?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is copy-editor safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains copy-editor?
It is published by joellewis in joellewis/skill-library. It has 46 recorded installs.
More from joellewis/skill-library
fiction-architect
joellewis/skill-library
Open the skill to read its SKILL.md instructions.
world-building-logic
joellewis/skill-library
Open the skill to read its SKILL.md instructions.
character-vulnerability
joellewis/skill-library
Open the skill to read its SKILL.md instructions.
problem-framing
joellewis/skill-library
Use when beginning analytical or strategic tasks, facing undefined problems, or facing analysis paralysis—requires explicit problem definition before proceeding.
Popular marketing & seo skills
reddit-automation
flowkit-labs/skills
Find Reddit threads where people are genuinely asking for what you offer, then draft short, genuinely helpful replies — disclosing your affiliation honestly and naming your product only when it truly answers the question. Two moves: discovery — scan the right subreddits for real needs (recommendation asks, expressed pain, competitor mentions) and rank the few threads where you can actually help; drafting — write from real experience, respect each community's self-promo rules, and keep a human in the loop to review and post. This markets on Reddit the honest way: contribute value, disclose who you are, never astroturf. Distilled from the playbook behind doany.ai's Reddit agent. Triggers on "find reddit opportunities", "reddit marketing", "reddit automation", "reply on reddit for my product", "reddit community engagement", "reddit lead gen", or any ask to turn Reddit threads into genuine, disclosed marketing replies.
twitter-automation
101-skills/superpowers
Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet
twitter-automation
magentosh/superpowers
Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet
twitter-automation
qu-skills/superpowers
Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet
product-launch-video
heygen-com/hyperframes
Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.
twitter-automation
skills-shell/superpowers
Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet