AdSwipeFile

View saved version →

---
name: competitor-ads
description: Show what ads a brand or competitor is running in the AdSwipeFile ad library, and sum up the formats, hooks, angles and offers it repeats, with a link to every ad cited. Use for "what ads is {brand} running", "show me my competitor's Facebook ads", competitor research, spying on a competitor's creatives, or a brand creative teardown.
---

# Competitor ads

1. Find the brand with `search_library`. If no brand matches, say the library
   does not have it; do not tear down a similar brand instead.
2. Call `list_ads` with the brand slug (`limit` 20 to 30). Count the formats
   and niches across the results.
3. Read a sample of five to eight ads with `get_ad`, spread across the formats
   you counted, for their copy and audiences. Keep to that sample; do not
   read every ad.
4. Report:
   - **Formats**: which ones the brand leans on, with counts from step 2.
   - **Angles and hooks**: the recurring promises, pains and openings, each
     with a link to an ad that shows it.
   - **Offers**: discounts, bundles, guarantees or free trials that appear.
   - **Audiences**: who the ads address, from the `audiences` field.
5. If the user follows the brand on AdSwipeFile, `list_followed_ads` adds its
   newest Meta ads, launched since the library last filed them. Cite each with
   its `url`.

## Rules

- Base every claim on an ad you listed or read, and link that ad's `url`.
- Say the teardown covers the brand's ads in this library, not everything the
  brand has run.
- Never state an ad's results: spend, ROAS, conversions, or that one ad beat
  another. The library holds no such data. "Winning" in this library means an
  ad the brand kept running and that was filed as worth studying; a long run
  (`sort: "longest_running"`) or many variants is a reason to study an ad,
  not proof that it performed.
- If `get_ad` returns an ad without its copy, with a line saying so, base the
  angles on the ad's name, description and formats, and pass that line on once.

View saved version →

---
name: find-winning-ads
description: Find winning Facebook and Instagram ads in the AdSwipeFile ad library by niche, format, brand or keyword, and present them with links. Use for "show me winning ads in {niche}", "what's working in {niche} right now", ad inspiration, ad examples, or examples of a format (UGC, before and after, testimonial, comparison).
---

# Find winning ads

## Resolve names to slugs first

`list_ads` filters on slugs. Turn the user's words into them before listing:

- A product, idea or loose phrase ("protein powder", "sleep gummies"): call
  `search_library` and use the brands, niches or ads it returns.
- An industry ("skincare", "SaaS"): match it against `list_niches`. Niches are
  broad (skincare sits under Beauty / Personal Care), so pick the closest and
  say which one you used.
- A format ("UGC", "before/after", "reviews"): match it against `list_formats`.
- A brand: call `search_library` with its name. If no brand matches, say the
  library does not have it rather than substituting another brand.

Call each list tool at most once per conversation; reuse what it returned.

## List and present

- Call `list_ads` with the slugs, and a `limit` close to what the user asked
  for. Results are the newest additions to the library first. For "what's
  working" or "what's been running longest", pass `sort: "longest_running"`;
  a long run is a reason to study an ad, not proof of its results.
- For each ad give the brand, niche, formats and its page `url`. Show the
  `image` when the host renders images.
- `created_at` is when the ad was added to the library, not when it ran.
  Never call it a launch or run date.
- If fewer ads match than asked, say how many there are. Offer to widen the
  search (drop the format, or try a neighbouring niche) instead of padding.
- Use `nextCursor` only when the user asks for more.

Only read an ad in full with `get_ad` when the user wants its copy, or when the
task needs the copy (see the write-hooks-from-ads skill).

View saved version →

---
name: get-started
description: Set up AdSwipeFile after installation, check its connection when asked, and help the user ask a first question about winning ads, competitor ads or hooks. Use for get started, onboarding, setup, "is it connected", "what can this ad library do", or questions about what the library holds.
---

# Get started with AdSwipeFile

Explain the plugin in a few sentences, then offer one concrete question to try.
Explicit user instructions take priority over this guidance.

## Choose the requested path

- For "set up", "get started" or "is it connected", call `list_niches` once.
  If it answers, the connection works: say so and name a few niches it returned.
  Do not call more tools just to check.
- If tools are unavailable or sign-in fails, say the connection is not
  verified and direct the user to connect or reconnect AdSwipeFile in the host.
  Do not claim the plugin is ready because this skill loaded.
- For "what can it do", explain without calling a tool.
- If the user already asked a real question, answer it with the tools instead
  of stopping at suggesting a question.

## What to say

- AdSwipeFile is an ad library of winning Facebook and Instagram ads: real
  Meta ads from brands, filed by brand, niche (industry) and format (UGC,
  before and after, testimonial, comparison…). Ask what a competitor is
  running, what's working in a niche, or for hooks from real ads.
- Each ad has its brand, niche, formats, audiences, an image and a page link.
  When `get_ad` returns an ad without its copy, it adds a line saying so: pass
  that line on.
- Every tool is read-only. Signing in also lets it list the ads the user saved
  on adswipefile.com, and the newest ads of the brands they follow there.

## What it cannot do

Say so plainly if asked: it has no spend, reach, CTR or ROAS figures; it
cannot create, run or buy ads; it does not generate images or video; it is a
curated collection, not a live feed of Meta's ad library; and it cannot save,
remove or follow anything.

## Suggested first questions

Offer one, adapted to what the user mentioned:

- "What ads is Liquid Death running? Sum up its hooks and angles."
- "Show me winning UGC ads from skincare brands, with their hooks."
- "Find testimonial ads for supplements and write 3 hooks for my product."

View saved version →

---
name: review-saved-ads
description: List the ads the user saved on adswipefile.com and find what they have in common: formats, niches, hooks, angles and offers. Use for "show me the ads I saved", "what do my saved ads have in common", their favorites, boards or swipe file.
---

# Review saved ads

1. Call `list_saved_ads`. It returns the ads saved on the signed-in account,
   newest first.
2. If it returns none, say so, and explain that ads are saved with the heart
   on an ad's page on adswipefile.com.
3. List the ads with brand, niche, formats and page `url`, then name what they
   share: the formats and niches that recur, and, if the user wants depth, the
   angles and offers from reading a few with `get_ad`.

## Rules

- The plugin is read-only. It cannot save, remove or organize ads into boards;
  point the user to adswipefile.com for that.
- Do not read every saved ad with `get_ad`; read a few that represent the
  patterns.
- Saved ads are the user's own choices. Describe them; do not rank them as
  better or worse performers, since the library has no performance data.

View saved version →

---
name: write-hooks-from-ads
description: Read winning ads in the AdSwipeFile ad library, name the hook and angle each one uses, and write original hooks, headlines or ad copy for the user's product in those patterns. Use for "write hooks for my product", "give me angles from ads that are working", "what hook does this ad use", or ad copy inspired by real ads.
---

# Write hooks from real ads

## Gather

1. Learn the user's product, audience and the claim they can back. Ask only
   if the request does not say what the product is.
2. Find relevant ads (see find-winning-ads): the product's niche, and the
   format the user wants, or Testimonial, Pain Point, Before & After and
   Comparison when they name none.
3. Read four to six of them with `get_ad` for their copy.

If `get_ad` returns an ad without its copy, with a line saying so, pass that
line on once. Work from the ads' names, descriptions and formats, and say the hooks
are drawn from those rather than from the full copy.

## Write

- First name the pattern each source ad uses (a question about a pain, a
  specific number, a before and after, a customer's words, a myth corrected),
  each with a link to the ad.
- Then write the hooks or copy for the user's product in those patterns.
  Write new sentences: never reuse an ad's wording, brand names, slogans or
  testimonials.
- Use only claims the user gave you. Mark any figure, result or guarantee you
  had to assume as a placeholder for the user to confirm, such as
  "[X] customers".
- Keep each hook to one line unless the user asked for longer copy.