ad-frameworks
Skill6 starsChanged 8 months agoApache-2.0View on GitHub
Ad copy frameworks (AIDA, PAS, before-after-bridge, 4Us, FAB) matched to audience awareness. Use when structuring ad scripts or body copy.
In this repository141 other files it gives its agents.
- AGENTS.mdAGENTS.md
- ad-bingSkill
- ad-googleSkill
- ad-linkedinSkill
- ad-metaSkill
- ad-redditSkill
- ad-tiktokSkill
- ad-xSkill
- ad-youtubeSkill
- ai-agent-designSkill
- ai-cost-finopsSkill
- ai-evals-designSkill
- ai-prompt-injection-defenseSkill
- ai-rag-patternsSkill
- analytical-reportSkill
- ats-optimizationSkill
- browser-backlink-submissionSkill
- browser-social-account-maintenanceSkill
- chef-budget-mealsSkill
- coaching-frameworksSkill
- code-review-lensesSkill
- code-reviewSkill
- content-auditSkill
- content-formatsSkill
- content-geoSkill
- content-groundingSkill
- content-humanizeSkill
- content-locale-humanize-arSkill
- content-locale-humanize-deSkill
- content-locale-humanize-esSkill
- content-locale-humanize-frSkill
- content-locale-humanize-hiSkill
- content-locale-humanize-itSkill
- content-locale-humanize-jaSkill
- content-locale-humanize-koSkill
- content-locale-humanize-ptSkill
- content-locale-humanizeSkill
- content-locale-humanize-thSkill
- content-locale-humanize-zhSkill
- content-translateSkill
- content-voiceSkill
- cover-letterSkill
- device-computer-automationSkill
- device-mobile-automationSkill
- document-exportSkill
- geo-visibility-auditSkill
- git-workflowSkill
- issue-diagnosisSkill
- learning-scienceSkill
- marketing-social-gtmSkill
- markup-landing-pageSkill
- octomind-cliSkill
- octomind-configSkill
- octomind-runtimeSkill
- octomind-supervisorSkill
- octomind-workflowSkill
- os-alpineSkill
- os-debianSkill
- os-fedoraSkill
- os-linuxSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
12 rules. About 0 are common, 12 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈12
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 38
Every framework needs an explicit CTA.
- Distinctive: line 58
When to use: brand-awareness ads, product launches to a wide audience, top-of-funnel.
- Distinctive: line 59
Avoid for: retargeting, performance ads with sophisticated audiences.
- Distinctive: line 72
When to use: Performance ads, problem-aware to most-aware audiences, B2B.
- Distinctive: line 73
Avoid for: broad awareness — cold audience tunes out the problem.
- Distinctive: line 85
When to use: transformation products, weight-loss / finance / fitness / productivity, lifestyle.
- Distinctive: line 86
Avoid for: pure information products (no transformation arc).
- Distinctive: line 123
When to use: TikTok / Reels / Shorts UGC and creator-style ads.
- Distinctive: line 124
Avoid for: B2B explainer, anything where a story would feel forced.
- Distinctive: line 142
Run every claim through the 4Us check.
- Distinctive: line 143
Read aloud at 1.5x speed. If it sounds AI / scripted at speed, rewrite for natural cadence.
- Distinctive: line 145
Check the product and proposition are on screen in the first 3–5 s and shown more than once, and that a CTA is present.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 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
Overview
Strong ads aren't written from scratch — they're written into a framework that has been pressure-tested across millions of dollars of spend. The framework's job is to make the structure invisible: the viewer feels a story, the writer follows a checklist. This skill gives you the small set of frameworks that actually convert in 2026 short-form video and direct-response copy, plus a rule for which one to pick based on the audience's awareness level (Schwartz's five stages).
Instructions
Core Rules
- Pick the framework before writing the script. Trying to pick mid-draft means the writer reverts to default narration.
- Every framework needs an explicit CTA. In Meta/Toluna's analysis of 100 short-form ads (correlational), direct-response ads with a CTA were 1.9× likelier to land in the top 20% for purchase intent (measured). Implicit "the offer is the rest of the video" leaves that on the table.
- Put the product and the proposition on screen early, then show them again. In the same correlational analysis, brand plus message in the first 5 s scored 1.7× for brand ads, and showing the product more than once scored 2.7× for direct-response ads (top 20% for purchase intent). Adding context that supports the main message, such as USPs or features ("Tell your story"), scored 5.3× for direct-response ads (measured; top 20% for purchase intent). TikTok's guidance: put the proposition in the first 3 s (official). Never hold the product reveal for the last third.
- Match framework to audience awareness, not your preference. A cold audience can't follow PAS — they don't yet feel the problem.
- One framework per piece. Mixing AIDA + PAS halfway through makes the piece muddled.
- Specifics, not adjectives. "47% faster" beats "much faster". Numbers, names, time spans.
- Every claim needs proof you could show a regulator. Testimonials and before/after beats must reflect typical results or say what's typical, and paid creators or UGC scripts need a clear disclosure (US FTC Endorsement Guides; FTC reviews rule since Oct 2024 bans fake or bought testimonials). Meta and TikTok also restrict before/after imagery in health, weight-loss, and cosmetic ads.
Framework Catalog
AIDA — Attention, Interest, Desire, Action
Old, durable, works for awareness-stage audiences.
| Beat | Job | Time in 30s ad |
| Attention | Hook (see video-hooks) | 0–2s |
| Interest | Reveal what's coming, plant curiosity | 2–8s |
| Desire | Show the outcome / transformation | 8–22s |
| Action | Single, specific CTA | 22–30s |
When to use: brand-awareness ads, product launches to a wide audience, top-of-funnel. Avoid for: retargeting, performance ads with sophisticated audiences.
PAS — Problem, Agitation, Solution
The workhorse of direct-response. Works when the audience already has the pain.
| Beat | Job | Time in 30s ad |
| Problem + proposition | Name the pain, mirror the frustration, and put the product or proposition on screen | 0–5s |
| Agitation | Twist the knife — show what happens if it's not solved, with the product still on screen | 5–16s |
| Solution | Demo the product already introduced, prove it, show it again in use | 16–26s |
| CTA | One specific action | 26–30s |
When to use: Performance ads, problem-aware to most-aware audiences, B2B. Avoid for: broad awareness — cold audience tunes out the problem.
BAB — Before, After, Bridge
Transformation-driven. Strong for D2C, fitness, finance, productivity.
| Beat | Job |
| Before | Show life with the problem (specific, sensory) |
| After | Show life without it (specific, sensory) |
| Bridge | The product / system that gets you there |
When to use: transformation products, weight-loss / finance / fitness / productivity, lifestyle. Avoid for: pure information products (no transformation arc).
4Us — Useful, Urgent, Unique, Ultra-specific
A copy-checking heuristic, not a structure. Apply to every claim in the piece.
| U | Question |
| Useful | Does this help the viewer? |
| Urgent | Why must they act now? |
| Unique | Why this product, not the 10 others? |
| Ultra-specific | Specifics over generics? |
A line that doesn't pass at least 2 of 4 should be rewritten.
FAB — Features, Advantages, Benefits
Translation engine. Use to convert a feature list into copy.
| Layer | Question | Example |
| Feature | What it has | "M3 Pro chip with 12-core CPU" |
| Advantage | What it does | "Compiles 2x faster than M2" |
| Benefit | What it means for the user | "Ship code while the demo is still loading" |
Rule: the script lives at the Benefit layer. F and A are research notes.
Hook → Story → Offer (HSO)
The dominant short-form social structure.
| Beat | Job |
| Hook | First 1.5s (see video-hooks) |
| Story | One specific narrative — first-person, real or composite. ~70% of total runtime. Product visible from the first 3–5 s and shown again in use. |
| Offer | Offer details + CTA, ~20% of runtime. The product is already on screen; this beat names the deal. |
When to use: TikTok / Reels / Shorts UGC and creator-style ads. Default for short-form. Avoid for: B2B explainer, anything where a story would feel forced.
Audience Awareness — pick framework by stage (Schwartz)
| Awareness | Framework | Reason |
| Unaware (no problem felt) | HSO with curiosity hook | Cold audience won't sit through PAS |
| Problem-aware | PAS or BAB | They feel the pain, agitate it |
| Solution-aware | BAB or AIDA | They know solutions exist, differentiate |
| Product-aware | FAB-driven AIDA, with comparison | They know your category, why YOU |
| Most-aware (your fans) | Direct offer — skip framework, lead with deal | Don't sell to people who already bought |
Workflow
- Identify audience awareness stage from the brief (or ask — don't guess).
- Pick the framework from the table above.
- Pre-write the offer before the body — ensures the body builds toward something specific.
- Draft each beat, time-boxed to the ad length.
- Run every claim through the 4Us check.
- Read aloud at 1.5x speed. If it sounds AI / scripted at speed, rewrite for natural cadence.
- Show the script with timestamps, not just lines. Time is the unit, not paragraphs.
- Check the product and proposition are on screen in the first 3–5 s and shown more than once, and that a CTA is present.
Decision Guide
| Situation | Framework |
| TikTok / Reels organic UGC | HSO |
| TikTok / Reels paid ad, problem-aware audience | PAS |
| Meta paid ad, transformation product | BAB |
| YouTube pre-roll (5–15s) | HSO with hard cut at 3s + visible skip-friendly first beat |
| YouTube pre-roll (un-skippable, 15s) | PAS or AIDA, CTA in last 3s |
| Long-form explainer (60–180s) | AIDA with FAB-loaded D-beat |
| Landing page hero | Hook + 4Us-checked one-liner + CTA |
| Cold email | PAS, 75 words max |
| Retargeting / cart-abandon | Direct offer, no framework, lead with deal |
Examples
Example 1: PAS for a B2B SaaS TikTok ad (30s)
Product: An on-call alerting tool. Audience: backend engineers, problem-aware (their team uses PagerDuty + duct tape).
0–3 P Hook: "Your on-call rotation is broken. [Product] fixes the noise."
(visual: phone going off at 3am, hand smacking the snooze, the product's alert card on screen)
3–8 P "67% of pages last quarter were noise — the kind that wakes you up
for a flapping check that auto-resolves before you log in."
(visual: fast-cut alerts spamming a dashboard)
8–18 A "Every false page costs $8 of engineer time and the next real one
hits a tired brain. The third Tuesday in a row, you stop trusting
the alerts entirely. That's when the real outage gets missed."
(visual: someone dismissing alerts on a phone, then a prod outage)
18–26 S "Quietly groups duplicate alerts, runs a 30-second auto-heal, and
only pages a human if the system is still on fire after that."
(visual: dashboard going from red waterfall to one calm card)
26–30 CTA "10 days free. Set it up in 4 minutes. Link in bio."
(visual: founder deadpan to camera)Example 2: HSO for a D2C creator UGC Reel (20s)
Product: A teeth-whitening pen. Audience: cold, scrolling.
0–1.5 Hook: "I tested 11 whitening pens for my wedding. Only one didn't
wreck my enamel."
(visual: line-up of pens, hand pushing 10 off-screen, the winner stays in frame)
1.5–14 Story: "I'm 4 weeks out, panicking, and Sephora is full of strips
that bleed at the gums. This one [show product] — bamboo
applicator, no peroxide, results in 6 days. My dentist
actually said 'whatever you're doing, keep doing it.'"
(visual: morning routine, before/after, dentist text screenshot)
14–20 Offer: "20% off through the link, free returns if it doesn't work
for you in 14 days."
(visual: product on bathroom counter, hand pulling phone toward camera)Example 3: AIDA for a YouTube pre-roll (15s, un-skippable)
0–2 A "Stop scrolling for 12 seconds. This will pay for itself."
2–6 I "Most freelancers under-invoice by 23% and don't know it."
6–11 D "We pulled the data from 4,000 freelance invoices. The fix is one
rule. [show result]"
11–15 A "Free calculator at link. 60 seconds, no signup."Checklist
- Framework picked from the audience awareness stage before drafting; one framework per piece.
- Product and proposition on screen in the first 3–5 s, shown more than once, with USPs or features supporting the main message.
- Explicit single CTA; no claim without proof; every line through the 4Us.
References
- Eugene Schwartz, Breakthrough Advertising (1966) — the awareness-level model.
- David Ogilvy, Ogilvy on Advertising — the canonical book on long-form direct-response.
- Meta Ads Library — to study current top-spending ads.
- TikTok Top Ads — by vertical and region.
- TikTok creative best practices — proposition in the first 3 s (official, 2025-06).
- Meta: Reels creative strategies — Meta x Toluna analysis of 100 short-form video ads, correlational: CTA 1.9× (direct-response), brand plus message in first 5 s 1.7× (brand ads), product shown more than once 2.7× (direct-response, top 20% purchase intent), "Tell your story" (USPs or features supporting the main message) 5.3× (direct-response) (official, measured, 2025-12-02).
- ppc.land write-up of the Meta/Toluna study — secondary coverage (reported, 2026-05-18).
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.

