writing-marketing-copy
Skill0 starsChanged 4 months agoMITView on GitHub
Writes marketing copy calibrated to audience awareness level (Schwartz), structured with a matching body framework (AIDA/PAS/BAB/FAB/4Ps), and checked against the 4 U's headline test - with a worked example showing how the same product gets four different headlines and a full PAS-structured ad depending on what the reader already knows. Use whenever the user wants ad copy, a headline, landing page copy, or wants existing marketing copy improved.
2 other projects use a version of this.
Adopted by
Most recently taken up by
- thrillmade/agent-skillstheir own version, first seen Nov 16, 2026
- stonegiantstudio/skillstheir own version, first seen Sep 29, 2026
Other versions2 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 2
- stonegiantstudio/skills★ 3same name
- thrillmade/agent-skills★ 3same name
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.
In this repository19 other files it gives its agents.
- adding-authenticationSkill
- auditing-seoSkill
- automating-git-workflowsSkill
- building-email-sequencesSkill
- building-graphql-apisSkill
- building-wordpress-pluginsSkill
- designing-carouselsSkill
- fine-tuning-ml-modelsSkill
- handling-web-formsSkill
- n8n-automationSkill
- organizing-spreadsheetsSkill
- reviewing-cloudflare-workers-codeSkill
- reviewing-code-for-securitySkill
- scaffolding-landing-pagesSkill
- setting-up-error-monitoringSkill
- setting-up-firebase-authSkill
- using-nextjs-best-practicesSkill
- working-with-postgres-databasesSkill
- writing-terraform-codeSkill
The file
We split this skill into the rules it gives an agent
1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
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
- Distinctive: line 32
Before calling any headline final, check it against all four - a headline that's only strong on one axis usually underperforms one that's …
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Writing marketing copy
Writes copy calibrated to what the audience already knows and believes - the single biggest lever in whether copy converts, and the one most often skipped - then structures the body with the classic copywriting framework that actually fits the format and awareness level, instead of defaulting to whatever framework is most familiar.
Workflow
- Establish awareness level first, before writing a single word of copy (Eugene Schwartz's framework, from Breakthrough Advertising): unaware, problem-aware, solution-aware, product-aware, or most-aware. This determines whether the headline should name the problem, the solution, or the product directly - see the worked example below.
- Pick one structural framework for the body copy, matched to the awareness level and format - see "Structural frameworks" below. Don't mix two structures in one piece (e.g. half AIDA, half PAS) - pick one and follow it through.
- Lead with the strongest specific claim, not a generic benefit - a number or concrete outcome beats an abstract promise.
- Grade the headline against the 4 U's (below) before moving on - a headline that fails all four is a first draft, not a final one.
- One CTA per piece of copy - competing calls-to-action reduce conversion on all of them.
- Address the obvious objection explicitly rather than hoping the reader doesn't think of it.
- Cut generic/AI-sounding filler on the edit pass - "unlock your potential," "seamlessly integrate," etc. Replace with something specific to this product.
Structural frameworks (pick one per piece)
Awareness level decides the angle - which of these decides the shape the copy takes from first line to CTA. Match to format and awareness level rather than defaulting to one framework for everything:
- AIDA (Attention → Interest → Desire → Action) - the general-purpose default for short ads and social copy. Safest choice when unsure which to use.
- PAS (Problem → Agitate → Solution) - names the pain, makes it concrete/uncomfortable, then relieves it with the offer. Strongest for unaware/problem-aware audiences, where the pain itself hasn't been fully framed yet - agitating before solving is what makes the solution land as relief rather than a random pitch.
- BAB (Before → After → Bridge) - paints life before the product, life after, then the product as the bridge between them. Strongest for transformation-driven copy: testimonials, case studies, onboarding/nurture emails - anywhere the contrast is the persuasive engine.
- FAB (Feature → Advantage → Benefit) - states what it is, what that does, then why that matters to this reader. Strongest for product-aware/most-aware audiences comparing specifics - they've already bought the category, now they need the concrete "so what."
- 4 Ps (Picture → Promise → Proof → Push) - paints a picture, promises an outcome, stacks proof (data, testimonials, guarantees), then pushes to act. Strongest for longer-form sales pages where a single headline can't carry the whole argument and proof needs room to build.
Headline check: the 4 U's
Before calling any headline final, check it against all four - a headline that's only strong on one axis usually underperforms one that's decent on all four:
- Urgent - is there a reason to act now, not eventually?
- Unique - does it say something a competitor's headline couldn't equally claim?
- Useful - is the value to the reader concrete, not implied?
- Ultra-specific - does it use a real number, name, or detail instead of a vague superlative?
Worked example: same product, four awareness levels
Product: a tool that auto-generates Meta Ads performance reports from raw campaign data (concrete stand-in, not a real client - but a real applied test of the framework rather than a generic template).
Unaware (doesn't know they have the problem yet - here, the "problem" is the hours lost to manual reporting, which many people don't consciously flag as a problem):
"Toda sexta-feira, alguém no seu time perde a tarde inteira copiando número de anúncio pra planilha."
Why this headline: names a scenario the reader recognizes before naming any solution - unaware readers bounce off solution-first copy because they haven't framed it as a problem yet.
Problem-aware (knows manual reporting is a pain, hasn't looked for a fix):
"Relatório de Meta Ads read de novo até sexta? Tem um jeito de isso levar 10 minutos, não a tarde toda."
Why: validates the pain directly, then briefly gestures at "a way" without yet naming the category of solution - problem-aware readers need to feel seen before they'll follow to a solution.
Solution-aware (knows automated reporting tools exist, hasn't picked one):
"A maioria das ferramentas de relatório automatiza a coleta. A nossa também analisa e já sugere o que pausar."
Why: solution-aware readers are comparing options - the headline has to differentiate against the category, not re-explain what automated reporting is.
Product-aware (knows this specific product, hasn't converted):
"Ainda copiando CPL manualmente? Seu relatório de ontem já estaria pronto às 9h."
Why: product-aware readers need a nudge, not an introduction - a specific, almost accusatory "you're still doing X" beats a generic feature recap they've already seen.
This is the actual test of the skill: the same product produces four genuinely different headlines, not one headline with the awareness level swapped in as a label. If a draft would work equally well at any awareness level, it hasn't actually applied the framework.
Worked example continued: the problem-aware headline, built out with PAS
A headline alone doesn't prove the structural framework was applied - here's the same problem-aware angle carried through a full short ad using PAS, since problem-aware is exactly the case PAS fits best:
Problem: Relatório de Meta Ads de novo até sexta?
Agitate: Todo mundo do time já sabe: sexta de manhã é copiar número de anúncio pra planilha, de novo, na mão - e se der um erro de digitação, ninguém percebe até o relatório já ter ido pro cliente.
Solution: O [produto] puxa os números direto da conta de anúncios e monta o relatório sozinho, todo fim de semana, sem planilha e sem erro de digitação.
[Ver como funciona →]
Why this is PAS and not just "problem-aware copy with steps": Problem and Agitate are two distinct beats, not one - the Problem line names the situation, the Agitate line makes the cost of it concrete (time lost, silent errors reaching the client) before Solution is introduced. Cutting straight from Problem to Solution without agitating is the most common way a PAS attempt collapses back into a plain feature pitch.
Headline check (4 U's) applied to the Problem line above: Urgent - weak (no explicit deadline pressure beyond "sexta" itself). Unique - weak (a competitor could say the same thing). Useful - strong (names a real, recognizable cost). Ultra-specific - moderate ("sexta" is concrete; "relatório de Meta Ads" is specific to the category but not to this reader). This is a realistic grading, not a cherry-picked perfect example - most first-draft headlines pass 2 of 4, not 4 of 4, and that's the signal to revise rather than ship.
Notes
- Match tone to the brand's existing voice if a style guide or existing copy is available - don't default to a generic "punchy marketing voice" that clashes with established brand tone.
- Getting the awareness level wrong is the most common reason copy "doesn't convert" despite being well-written - if unsure which level the audience is at, ask rather than guessing.
- Don't force-fit a framework: if the format is a single-line ad headline with no room for a body, AIDA/PAS/BAB/4Ps don't apply at all - only the awareness-level angle and the 4 U's check do. Structural frameworks are for anything with a body (ad copy, email, landing page section), not for a headline in isolation.
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
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.

