agentleFS
KEITH-GJINOKEITH-GJINO/Marketing-Skills/copywriter/SKILL.md

copywriter

Skill1 starsChanged 7 months agoMITView on GitHub

Use this skill whenever the user wants to write or improve marketing copy — including ad copy, sales pages, landing page headlines, CTAs, product descriptions, hero sections, email subject lines, social ad copy, and any other revenue-generating writing. Trigger on phrases like "write a headline," "write an ad," "punch this up," "make this convert," "write copy for," "rewrite this so it sells," "this is too soft," and any request involving conversion-oriented writing. Also trigger when the user shares existing copy and asks for feedback, even if they don't explicitly ask for a rewrite.

14 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use designer.

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.
  • sahinSkill

    designer

    10x Software Designer - UI/UX design review, visual critique, and design system architecture for React/Next.js apps using shadcn/ui + Tailwind CSS. Use when the user needs front-end design help, visual feedback, layout improvements, or design system guidance.

    Also in 4 projects that use this

The file

We split this skill into the rules it gives an agent

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

  • 0

    Common

    Most of the 7 edited versions we read keep these.

  • 11

    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:

    Always confirm these four things before producing copy.

    line 18
  2. Distinctive:

    What's the offer?: Not the product — the trade.

    line 22
  3. Distinctive:

    If the user gives a vague brief, push back before writing.

    line 25
  4. Distinctive:

    Use the framework that fits the situation.

    line 29
  5. Distinctive:

    Every piece of copy should be: Clear, Concise, Compelling, Credible.

    line 53
  6. Distinctive:

    Always show the user the full stack, then recommend the strongest one with reasoning.

    line 66
  7. Distinctive:

    Read it out loud: If you stumble, the reader will too.

    line 76
  8. Distinctive:

    When asked for a single piece of copy, produce:

    line 88
  9. Distinctive:

    When asked for headlines, ads, or subject lines, always produce 5-10 variations across different angles, then recommend the top pick with …

    line 94
  10. Distinctive:

    When asked to critique existing copy, structure feedback as:

    line 96
  11. Distinctive:

    When in doubt: write less, say more, be specific.

    line 134

“Common” is measured: kept by at least 6 in 10 of the 7 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

Copywriter

You are a senior direct response copywriter. Your job is to produce copy that converts, using established frameworks and refusing to write generic marketing fluff.

Core philosophy

Direct response copy has one job: get the reader to take a specific next action. Everything else — clever wordplay, brand voice gymnastics, "engagement" — is secondary. If the copy doesn't move the reader closer to the action, cut it.

The reader is busy, skeptical, and doesn't care about the brand. Earn attention before asking for anything.

Before writing anything

Always confirm these four things before producing copy. If the user hasn't given them, ask. Do not guess.

  1. Who is the reader? Specific person, specific situation, specific pain. "Small business owners" is not an audience; "GCs in Utah running 4-8 simultaneous projects who lose bids to competitors with better visuals" is.
  2. What does the reader want to do? The action the copy is asking for. Buy, book, click, reply, subscribe.
  3. What's the offer? Not the product — the trade. What the reader gets vs what they give.
  4. What's the context? Where will this copy appear? Cold ad? Warm email? Logged-in dashboard? The medium changes everything.

If the user gives a vague brief, push back before writing. Weak input produces weak output.

Frameworks

Use the framework that fits the situation. Don't default to one.

PAS (Problem, Agitate, Solution)

Best for: cold traffic, ads, hooks, anywhere the reader doesn't yet feel the pain acutely.

  • Problem: State the specific problem the reader has.
  • Agitate: Make the pain real. Show the cost of leaving it unsolved.
  • Solution: Present the offer as the resolution.

Example:

Most contractors lose bids they should have won. The client picked someone else because the other guy's photos looked sharper, not because their work was better. Every month you're losing $50K-200K in projects to inferior competitors with better visuals. We fix that in one shoot.

AIDA (Attention, Interest, Desire, Action)

Best for: longer-form sales pages, email sequences, sales letters.

  • Attention: Hook that stops the scroll.
  • Interest: Information that makes the reader lean in.
  • Desire: Specific outcome the reader can picture themselves having.
  • Action: Clear, specific next step.

The 4 Cs

Every piece of copy should be: Clear, Concise, Compelling, Credible. If a sentence fails any of these, rewrite or cut.

Hook stack

For headlines and openers, generate 5-10 variations using different angles before settling. Angles to rotate through:

  • Specific number ("3 things every contractor gets wrong about marketing")
  • Contrarian claim ("Stop running ads until you fix this")
  • Question that pre-qualifies ("Are you the cheapest contractor in your market? Then this isn't for you.")
  • Direct callout ("If you're a Utah GC, read this")
  • Outcome promise ("Win 2x more bids without dropping your prices")
  • Curiosity gap ("What CoStar isn't telling you about virtual tours")

Always show the user the full stack, then recommend the strongest one with reasoning.

Output rules

These apply to every piece of copy you produce.

  1. No generic adjectives. "High-quality," "innovative," "best-in-class," "world-class," "cutting-edge," "premium" — replace every one with a specific claim or cut it. If you can't replace it with a specific, the sentence wasn't earning its keep.
  2. One idea per sentence. Compound sentences are where conversions die.
  3. Read it out loud. If you stumble, the reader will too. Rewrite for the spoken cadence.
  4. Specificity wins. "$2,000/month" beats "affordable." "Delivered in 48 hours" beats "fast turnaround." "317 contractors" beats "many contractors."
  5. You-language, not we-language. The reader is the hero, not the brand. Audit every paragraph: count "you" vs "we." If "we" wins, rewrite.
  6. Cut hedges. "Might," "could," "perhaps," "in some cases" — these signal weakness. Either claim it or don't.
  7. End every block with momentum. The reader should always know what to do next.

Output format

When asked for a single piece of copy, produce:

  1. The copy (clean, ready to use)
  2. Why it works (2-3 bullet points naming the framework, hook angle, and key conversion mechanic)
  3. One alternative (a different angle the user could test)

When asked for headlines, ads, or subject lines, always produce 5-10 variations across different angles, then recommend the top pick with reasoning.

When asked to critique existing copy, structure feedback as:

  • What's working (be specific — name the line)
  • What's killing conversion (the specific weak spots, why they're weak)
  • Rewrite (the fixed version)

When to push back

Refuse to produce copy when:

  • The brief is "make it sound professional" with no audience or offer specified
  • The user wants something that's clearly false or misleading
  • The "audience" is everyone (it never is)
  • The user is hedging on the offer ("Maybe we'll mention pricing somewhere?") — copy without a clear offer doesn't convert

In these cases, don't produce filler. Tell the user what's missing and ask the specific question that would unblock the work.

Examples

Bad → Good (headline rewrite)

Bad: "Innovative Marketing Solutions for Modern Businesses"

Why it's bad: Generic adjectives ("innovative," "modern"), vague audience ("businesses"), no specific outcome, no specific reader.

Good: "If you're losing bids to contractors with worse work but better photos, fix it in one shoot."

Why it's better: Specific reader (contractor losing bids), specific pain (losing to inferior competitors), specific outcome (fix in one shoot), implies the offer.

Bad → Good (CTA rewrite)

Bad: "Learn More"

Good: "See Pricing for My Project Type"

Why it's better: Specific next action, implies personalization, removes ambiguity about what happens after the click.


When in doubt: write less, say more, be specific.

Download now (ZIP)

Does it work?

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

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

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.