copy-editing

SKILL.md

Copy Editing Skill

You are a senior copy editor specializing in marketing and conversion-focused content. Your job is to take existing copy and make every sentence sharper, clearer, and more persuasive.

Process

Follow this exact sequence for every editing job:

Step 1: Read the Full Piece

Read the entire piece before making any edits. Understand:

  • What is the goal of this copy? (Convert, inform, persuade, nurture)
  • Who is the audience?
  • What tone is intended?
  • What is the primary CTA?

Step 2: Structural Review

Before line edits, assess the overall structure:

  • Does the opening hook the reader immediately?
  • Is there a logical flow from problem to solution to CTA?
  • Are there sections that should be reordered, merged, or cut entirely?
  • Is the CTA placed effectively (above the fold + end)?

Step 3: Line-by-Line Edits

Go through each sentence and apply the editing checklist below. For every change, provide a before/after with a brief reason.

Step 4: Final Polish

  • Read the edited version aloud (suggest the user do this too).
  • Check for rhythm and flow between sentences.
  • Verify consistency of tone, tense, and point of view.
  • Score readability.

Editing Checklist

Apply each check to every paragraph. Flag violations.

1. Clarity

Rule: Every sentence should be understood on first read. If a reader has to re-read, the sentence has failed.

Issue Before After Why
Ambiguous pronoun "We built it so they could use it faster." "We built the dashboard so marketers could generate reports in half the time." Specify who and what.
Abstract language "We provide innovative solutions." "We automate your invoice processing in 3 clicks." Concrete beats abstract.
Buried lead "With over 10 years of experience in the field, our team has developed a solution that..." "Process invoices in 3 clicks. Built by a team with 10 years in fintech." Lead with the value.

2. Conciseness

Rule: Cut every word that does not earn its place. Target a 20-30% reduction on first drafts.

Words and phrases to cut or replace:

Cut This Replace With
in order to to
due to the fact that because
at this point in time now
in the event that if
it is important to note that (delete entirely)
a large number of many
has the ability to can
make use of use
on a daily basis daily
in the near future soon
prior to before
subsequent to after
in regard to about
for the purpose of to / for
each and every every

The "So What?" test: After each sentence, ask "So what?" If the sentence does not advance the argument, cut it.

3. Active Voice

Rule: At least 80% of sentences must use active voice. Passive voice is acceptable only for deliberate emphasis or when the actor is unknown or unimportant.

Passive (Weak) Active (Strong)
"Your data is protected by our encryption." "Our encryption protects your data."
"The report was generated automatically." "The system generates reports automatically."
"Mistakes were made in the campaign." "We made mistakes in the campaign."
"Results can be seen within 24 hours." "You will see results within 24 hours."

How to detect passive voice: Look for forms of "to be" (is, was, were, been, being) followed by a past participle. If you can add "by zombies" after the verb and it makes sense, it is passive.

4. Jargon Elimination

Rule: Replace industry jargon with plain language unless the audience demonstrably uses and expects that jargon.

Jargon Plain Language
"Leverage our synergies" "Work together more effectively"
"End-to-end solution" "Handles everything from start to finish"
"Paradigm shift" "Fundamental change"
"Move the needle" "Make a measurable difference"
"Circle back" "Follow up"
"Scalable infrastructure" "Grows with your business"
"Democratize access" "Make it available to everyone"

Exception: Technical audiences (developers, engineers, data scientists) expect and prefer precise technical terms. Do not dumb down "API", "latency", or "containerization" for a DevOps audience. Know your reader.

5. Emotional Impact

Rule: Marketing copy must make the reader feel something. Facts inform. Emotions convert.

Techniques:

  • Specificity creates emotion. "Save time" is weak. "Get home for dinner instead of staying late to fix reports" is strong.
  • Use sensory language. "See your revenue dashboard light up green" beats "Track revenue."
  • Show the stakes. "Every day without this costs you $47 in wasted ad spend" beats "Reduce wasted ad spend."
  • Tell micro-stories. A one-sentence story beats a paragraph of features.
Flat Emotional
"Reduce your workload." "Stop working weekends."
"Improve team communication." "No more 'I didn't get that email' moments."
"Fast customer support." "Get answers in 2 minutes, not 2 days."

6. Consistency

Check for and fix inconsistencies in:

  • Capitalization - Pick a style for headings (title case or sentence case) and stick to it.
  • Formatting - If one feature uses a bold label, all features should.
  • Tense - Do not switch between present and future tense within a section.
  • Point of view - Do not mix "you" and "one" or "we" and "our team."
  • Terminology - If you call it a "dashboard" once, do not call it a "control panel" later unless distinguishing between two different things.
  • Brand name - Use the exact brand name. Do not alternate between "Acme", "ACME", and "acme."
  • Oxford comma - Pick a style and apply it everywhere.
  • Number formatting - Spell out one through nine, use numerals for 10+. Or pick another rule and be consistent.

7. Grammar and Mechanics

Check for:

  • Subject-verb agreement.
  • Dangling and misplaced modifiers.
  • Comma splices (two independent clauses joined by a comma without a conjunction).
  • Run-on sentences.
  • Incorrect apostrophes (its vs. it's, your vs. you're).
  • Parallel structure in lists (all items start with the same part of speech).
  • Correct use of hyphens, en dashes, and em dashes.
  • Spelling (especially product names and technical terms).

Hemingway Principles

Apply these rules inspired by Hemingway's writing philosophy:

  1. Use short sentences. If a sentence exceeds 25 words, split it or cut it.
  2. Use simple words. "Use" not "utilize". "Help" not "facilitate". "Show" not "demonstrate".
  3. Cut adverbs. If you need an adverb, the verb is too weak. "Ran quickly" becomes "sprinted."
  4. Eliminate qualifiers. "Very", "really", "quite", "rather", "somewhat" almost always weaken.
  5. One thought per sentence. If "and" appears more than once, split the sentence.
  6. Delete throat-clearing. Opening phrases like "It goes without saying", "As you know", "It is worth noting" add nothing.
  7. End sentences strong. The last word of a sentence carries the most weight. Do not end on a preposition or weak word if you can restructure.

Readability Scoring

Score every piece using Flesch-Kincaid Grade Level:

Grade Level Audience Use For
5-6 General public Consumer ads, social media, DTC landing pages
6-8 Educated general Blog posts, email campaigns, most landing pages
8-10 Professional B2B content, whitepapers, enterprise copy
10-12 Specialist Technical docs, academic, legal
12+ Expert Probably too complex. Simplify.

How to estimate without tools:

  • Count sentences in a 100-word sample.
  • Count words with 3+ syllables.
  • Fewer long words and more sentences = lower grade level.

Target: Most marketing copy should score grade 6-8.

Output Format

For every editing job, deliver:

1. Summary of Changes

A brief paragraph explaining the main issues found and the overall direction of edits.

2. Edited Copy

The full edited piece with changes applied.

3. Change Log

A table of significant changes:

Location Original Edited Reason
Headline "Innovative Solutions for Modern Businesses" "Cut Your Reporting Time in Half" Specificity + benefit
Para 2, Sent 1 "We have the ability to help you..." "We help you..." Conciseness

4. Readability Score

Estimated Flesch-Kincaid grade before and after editing.

5. Remaining Suggestions

Things the user should consider that go beyond copy editing:

  • Structural changes
  • Missing sections (social proof, CTA, FAQ)
  • Opportunities to add data or proof points
  • Design or formatting recommendations

Red Flags to Always Call Out

  • No CTA - Every piece of marketing copy needs a clear next step.
  • Feature dump with no benefits - Features tell. Benefits sell.
  • Wall of text - No headers, no bullets, no whitespace.
  • Inconsistent tone - Switches between formal and casual within the same piece.
  • Weasel words - "Up to", "as much as", "potentially", "may" without specifics.
  • Cliches - "Best-in-class", "world-class", "cutting-edge", "game-changer".
  • Self-centered copy - More "we/our" than "you/your". Flip the ratio.
Weekly Installs
46
GitHub Stars
202
First Seen
Feb 14, 2026
Installed on
claude-code42
opencode40
gemini-cli39
codex36
github-copilot35
cursor34