agentleFS
Sign inStart free
OpenClaudiaOpenClaudia/openclaudia-skills/skills/copy-editing/SKILL.md

copy-editing

Skill723 starsChanged 5 months agoMITView on GitHub

Line-by-line copy editing and improvement for marketing content. Polish existing copy for clarity, conciseness, impact, and conversion. Trigger phrases: "edit my copy", "improve this copy", "polish this text", "copy edit", "make this clearer", "tighten this up", "proofread", "review my copy", "make this more persuasive", "fix my writing".

We split this skill into the rules it gives an agent

20 rules. 0 are common, 20 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 88 edited versions we read keep these.

  • 20

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Follow this exact sequence for every editing job:

    line 17
  2. Distinctive:

    Read the entire piece before making any edits.

    line 21
  3. Distinctive:

    Before line edits, assess the overall structure:

    line 29
  4. Distinctive:

    Read the edited version aloud (suggest the user do this too).

    line 42
  5. Distinctive:

    Check for rhythm and flow between sentences.

    line 43
  6. Distinctive:

    Verify consistency of tone, tense, and point of view.

    line 44
  7. Distinctive:

    Rule: Every sentence should be understood on first read.

    line 53
  8. Distinctive:

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

    line 86
  9. Distinctive:

    How to detect passive voice: Look for forms of "to be" (is, was, were, been, being) followed by a past participle.

    line 101
  10. Distinctive:

    Check for and fix inconsistencies in:

    line 144
  11. Distinctive:

    Formatting: - If one feature uses a bold label, all features should.

    line 147
  12. Distinctive:

    Tense: - Do not switch between present and future tense within a section.

    line 148
  13. Distinctive:

    Point of view: - Do not mix "you" and "one" or "we" and "our team."

    line 149
  14. Distinctive:

    Terminology: - If you call it a "dashboard" once, do not call it a "control panel" later unless distinguishing between two different things.

    line 150
  15. Distinctive:

    Brand name: - Use the exact brand name.

    line 152
  16. Distinctive:

    Use short sentences: If a sentence exceeds 25 words, split it or cut it.

    line 174
  17. Distinctive:

    Cut adverbs: If you need an adverb, the verb is too weak.

    line 176
  18. Distinctive:

    One thought per sentence: If "and" appears more than once, split the sentence.

    line 178
  19. Distinctive:

    No CTA: - Every piece of marketing copy needs a clear next step.

    line 233
  20. Distinctive:

    Wall of text: - No headers, no bullets, no whitespace.

    line 235

“Common” is measured: kept by at least 6 in 10 of the 88 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
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.

IssueBeforeAfterWhy
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 ThisReplace With
in order toto
due to the fact thatbecause
at this point in timenow
in the event thatif
it is important to note that(delete entirely)
a large number ofmany
has the ability tocan
make use ofuse
on a daily basisdaily
in the near futuresoon
prior tobefore
subsequent toafter
in regard toabout
for the purpose ofto / for
each and everyevery

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.

JargonPlain 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.
FlatEmotional
"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 LevelAudienceUse For
5-6General publicConsumer ads, social media, DTC landing pages
6-8Educated generalBlog posts, email campaigns, most landing pages
8-10ProfessionalB2B content, whitepapers, enterprise copy
10-12SpecialistTechnical docs, academic, legal
12+ExpertProbably 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:

LocationOriginalEditedReason
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.

Download now (ZIP)

  • Other versions91 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 91

    1. coreyhaines31/marketingskills★ 58ksame name
    2. TheCraigHewitt/seomachine★ 7.5ksame name
    3. LeoYeAI/openclaw-marketing-skills★ 1ksame name
    4. Nexus-JPF/note-companion★ 870same name
    5. mysticaltech/marketingskills★ 352same name
    6. boraoztunc/skills★ 337same name
    7. Cesarjoquin/Marketing-Skills★ 190same name
    8. zrosenfield/sharepoint-ai-skills★ 96same name
    9. b1rdmania/ghostclaw★ 91same name
    10. eventschedule/eventschedule★ 89same name

    81 more not listed

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • Used alongsideProjects with it also use popups, free-tools and 10 more.

    Other files people use alongside this one.

    Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
    • CesarjoquinSkill

      popups

      When the user wants to create or optimize popups, modals, overlays, slide-ins, or banners for conversion purposes. Also use when the user mentions "exit intent," "popup conversions," "modal optimization," "lead capture popup," "email popup," "announcement banner," "overlay," "collect emails with a popup," "exit popup," "scroll trigger," "sticky bar," or "notification bar." Use this for any overlay or interrupt-style conversion element. For forms outside of popups, see cro. For general page conversion optimization, see cro.

      Also in 22 projects that use this

    • CesarjoquinSkill

      free-tools

      When the user wants to plan, evaluate, or build a free tool for marketing purposes — lead generation, SEO value, or brand awareness. Also use when the user mentions "engineering as marketing," "free tool," "marketing tool," "calculator," "generator," "interactive tool," "lead gen tool," "build a tool for leads," "free resource," "ROI calculator," "grader tool," "audit tool," "should I build a free tool," or "tools for lead gen." Use this whenever someone wants to build something useful and give it away to attract leads or earn links. For downloadable content lead magnets (ebooks, checklists, templates), see lead-magnets.

      Also in 23 projects that use this

    • pixelswithblissSkill

      co-marketing

      When the user wants to find co-marketing partners, plan joint campaigns, or brainstorm partnership opportunities. Use when the user says 'co-marketing,' 'partner marketing,' 'joint campaign,' 'who should we partner with,' 'integration marketing,' 'cross-promotion,' 'collaborate with another company,' 'partnership ideas,' or 'co-brand.' For customer referral programs, see referral-program. For launch-specific partnerships, see launch-strategy.

      Also in 23 projects that use this

    • coreyhaines31Skill

      marketing-council

      When the user wants multiple expert perspectives on a marketing question — a simulated board of advisors staffed by legendary marketers (Seth Godin, David Ogilvy, Eugene Schwartz, April Dunford, Rory Sutherland, Alex Hormozi, Byron Sharp, and more). Also use when the user mentions 'marketing council,' 'board of advisors,' 'advisory board,' 'what would Seth Godin say,' 'what would Ogilvy think,' 'channel Hormozi,' 'get multiple perspectives,' 'debate this,' 'have the council review,' 'marketing mentors,' or asks how a famous marketer would approach their problem. The council gives each advisor's take through their documented frameworks, surfaces where they disagree, and synthesizes a recommendation. For executing the winning direction, hand off to positioning, offers, copywriting, ads, or the relevant skill.

      Also in 17 projects that use this

    • ukunal91appSkill

      community-marketing

      Build and leverage online communities to drive product growth and brand loyalty. Use when the user wants to create a community strategy, grow a Discord or Slack community, manage a forum or subreddit, build brand advocates, increase word-of-mouth, drive community-led growth, engage users post-signup, or turn customers into evangelists. Trigger phrases: "build a community," "community strategy," "Discord community," "Slack community," "community-led growth," "brand advocates," "user community," "forum strategy," "community engagement," "grow our community," "ambassador program," "community flywheel.

      Also in 34 projects that use this

    • VercelSkill

      site-architecture

      Use when planning or restructuring what pages a site has and how they connect: hierarchy, navigation, URL patterns, breadcrumbs, and internal linking. Not for XML sitemaps, which are in seo-audit.

      Also in 52 projects that use this

    • +5 more from Cesarjoquin
  • In this repository77 other files it gives its agents.

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free