Skip to content
Back to search

meta-ads-launch

Plan, build and teach the launch of a small-budget Meta (Facebook and Instagram) ad test for any app, SaaS or small-business product that has a website and a web app. Produces ad creatives (feed, square, story and link shapes, in any languages including right-to-left), a Facebook page profile picture and cover, Meta Pixel and sign-up tracking, ad copy, and a one-step-at-a-time campaign walkthrough for a first-time advertiser. Use when asked to "run ads", "set up Meta ads", "make social ads", "add the Meta pixel", "teach me to advertise", or to prepare an ad test on a small budget.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/nowfalsalahudeen--meta-ads-launch/badge.svg)](/listings/nowfalsalahudeen--meta-ads-launch)

HTML

<a href="/listings/nowfalsalahudeen--meta-ads-launch"><img src="/api/listings/nowfalsalahudeen--meta-ads-launch/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

The skill is a folder. Put it where your agent loads skills.

**Claude Code**

git clone https://github.com/nowfalsalahudeen/meta-ads-launch ~/.claude/skills/meta-ads-launch

(for one project only, clone it into `<project>/.claude/skills/meta-ads-launch`).

**Other agents:** copy `SKILL.md`, `references/`, `scripts/` and `templates/` into the folder your agent reads skills from. `SKILL.md` is the entry point and the other files are read on demand.

**For the image script** you need Python 3, Google Chrome or Chromium (set `CHROME=/path/to/chrome` if it is not found automatically), and internet access for the web fonts. No Python packages are required.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 52 lines
  1. ---
  2. name: meta-ads-launch
  3. description: Plan, build and teach the launch of a small-budget Meta (Facebook and Instagram) ad test for any app, SaaS or small-business product that has a website and a web app. Produces ad creatives (feed, square, story and link shapes, in any languages including right-to-left), a Facebook page profile picture and cover, Meta Pixel and sign-up tracking, ad copy, and a one-step-at-a-time campaign walkthrough for a first-time advertiser. Use when asked to "run ads", "set up Meta ads", "make social ads", "add the Meta pixel", "teach me to advertise", or to prepare an ad test on a small budget.
  4. ---
  5. # meta-ads-launch
  6. Takes a product that already has a website and a web app, and gets a first Meta ad test live on a small budget: accounts, tracking, creatives, copy, the campaign build, and how to read the result. Written for someone who has never run an ad, and reusable for any product in any market.
  7. **You prepare everything; the user presses every button that spends money or accepts terms.** Never enter payment details, accept Meta terms, publish a campaign or raise a budget yourself. Walk the user through those screens, one step at a time, and ask for a screenshot before the next step.
  8. ## Workflow
  9. 1. **Inspect, never invent.** Read the product's site and app for what it really does, what is free, its URLs, its privacy page, the languages and currency it supports, and whether it has screens to show. Ads may only say what the product does today: no prices before paid plans exist, no "available on the store" for an app that is not published, no invented numbers, testimonials or guarantees.
  10. 2. **Ask what changes the plan** (one message): who the buyer is and where (country, language or languages); the budget for the first test; whether a Facebook page, an Instagram account and a Meta Business account already exist. Defaults if the user does not know: the product's main market, its main language plus one more if it supports it, about USD 25 a day for two days, nothing exists yet.
  11. 3. **Accounts** (`references/campaign-walkthrough.md` Part 1): Facebook page, an Instagram account separate from the user's personal one, Meta Business account, ad account currency, payment method. The user does these.
  12. 4. **Tracking** (`references/tracking.md`): add the Meta Pixel to the site and the web app, with a sign-up event and a "first real use" event. Keep the pixel id in one config value; empty means off and nothing is sent. Update the privacy page. Verify in a real browser that the requests go out, then have the user confirm in Events Manager -> Test events (the Website section, not the Server one).
  13. 5. **Creatives** (`scripts/make_creatives.py`, `references/creative-specs.md`): one hook headline per ad, an offer badge, one button, the product on a browser and a phone, and either two small floating cards or one feature checklist. Make every placement shape (feed 4:5, square 1:1, story 9:16, link 1.91:1) in each language. Look at the outputs yourself before handing them over.
  14. 6. **Page assets** (`make_creatives.py --page`): profile picture 1080x1080 (circle-safe) and a cover 1640x924 with the content kept in the middle band.
  15. 7. **Copy** (`templates/copy.md`): primary text, headline, description, call-to-action and a tracking link with UTM tags, in each language.
  16. 8. **Build the campaign with the user, one step at a time** (`references/campaign-walkthrough.md` Parts 2-5). The first test is the Traffic objective, manual (not Advantage+) setup, ad-set budget, one ad set per language, one to three ads, AI image generation and enhancements OFF, a separate correctly sized image for each placement, and a two-day schedule.
  17. 9. **Read the result** (`references/campaign-walkthrough.md` Part 6): impressions, CTR, cost per click and landing-page views after 24-48 hours; pause the weakest; do not judge sign-ups until there are enough. Move to a sign-up campaign only after roughly 50 sign-up events in a week, then add retargeting.
  18. ## Rules
  19. - **Beginner mode:** when the user says they are confused or asks for "one by one", give at most four small steps, say exactly what to click and what to type, and stop for a screenshot. Name the screen they are on from their screenshot before giving steps.
  20. - **Honesty:** state what is verified (you saw it) and what is not (rules, prices and costs quoted from third-party articles). Cost per click, special-category rules and local advertiser permits must be checked on the official source before spending; say so (`references/compliance.md`).
  21. - **Privacy:** keep the pixel id, emails, account ids and any company data out of the skill, the creatives' file names and any repo. Use placeholders in everything you commit or share.
  22. - **Never** buy followers, promise results, target by protected characteristics, or use before/after claims.
  23. - **Do not deploy or commit** without an explicit request in that turn. Tracking changes need the web app (and the API, if it changed) deployed before they take effect; ask first.
  24. ## Lessons from a first run (these cost real time)
  25. | Symptom | Cause and fix |
  26. |---|---|
  27. | Events Manager "Connect data" offers Shopify, WooCommerce and Tag Manager | Click "See other ways to set up", then Meta Pixel -> manual. Do not pick a partner. |
  28. | Test events shows a "server" test code | That is the Conversions API test. Use the second section, "website's events", and enter the site URL. |
  29. | "Campaign schedule is too short: ad sets using a daily budget" | Daily budgets need a longer window. Make the end date two days after the start, or use a lifetime budget. The "ad can't be uploaded" error on the ad is only a result of this. |
  30. | "You need access to advertise for <instagram account>" | The Instagram account is not assigned to the ad account. Quick fix: run the ad as the Facebook page. Proper fix: Business settings -> Instagram accounts -> add, then assign the ad account. |
  31. | Preview shows a stock photo of a person holding a phone | Meta AI "image generation" and "enhancements" invented it. Turn both off, and Vary aspect ratio too. The thumbnails must show only your own design. |
  32. | "Select media crop" warnings and grey bars | One image is being stretched to every placement. Replace each placement (square, vertical, horizontal) with its own file. Keep light/dark variants matched. |
  33. | UTM tags missing from the URL field | Meta moved them to Tracking -> URL parameters. Paste them there and tick Website events. |
  34. | Budget strategy offers Campaign budget / Budget sharing / Ad set budget | For a tiny test choose Ad set budget so each ad gets the amount set. |
  35. ## Files
  36. - `references/campaign-walkthrough.md` - accounts, campaign, ad set, ad, publish, read results (the screen-by-screen guide).
  37. - `references/tracking.md` - pixel code for a static site and a single-page or Flutter web app, events, new-account detection, privacy text, verification.
  38. - `references/creative-specs.md` - sizes, safe zones, what to put on an ad, copy rules, what to avoid.
  39. - `references/compliance.md` - special ad categories, local advertiser rules, platform policies; all to be verified at the source.
  40. - `scripts/make_creatives.py` - builds the ad images and page assets from a JSON config with headless Chrome.
  41. - `templates/ads.example.json` - a config to copy. `templates/copy.md` - copy patterns to fill in.
README.md · README · 88 lines
  1. # meta-ads-launch
  2. **A Claude skill that takes any app or small-business product from "I have never run an ad" to a first Meta (Facebook + Instagram) ad test on a small budget.**
  3. It prepares what can be prepared and teaches the rest, one small step at a time:
  4. - **Tracking** - Meta Pixel for a marketing site and a single-page or Flutter web app, with sign-up and first-use events counted once, and the privacy wording that goes with it.
  5. - **Creatives** - feed, square, story and link images in any number of languages (right-to-left included), plus a profile picture and cover photo, drawn from screenshots of your real product.
  6. - **Copy** - primary text, headline, description, button and a UTM tracking link, as patterns you fill in.
  7. - **A beginner walkthrough** - accounts, campaign, ad set, ad, publish and how to read the first 48 hours, written as short steps that ask for a screenshot before the next one, including the traps hit on a real first run.
  8. - **Guardrails** - it never spends money, accepts terms or publishes for you. You click those.
  9. <p align="center">
  10. <img src="examples/out/en/feed/launch.png" width="31%" alt="Dark feed ad example">
  11. <img src="examples/out/en/feed/everything.png" width="31%" alt="Light feature-checklist ad example">
  12. <img src="examples/out/ar/story/launch.png" width="31%" alt="Right-to-left story ad example">
  13. </p>
  14. <p align="center"><sub>Generated by <code>scripts/make_creatives.py</code> from a JSON file and two screenshots. Product, brand and numbers are fictional.</sub></p>
  15. ## Install
  16. The skill is a folder. Put it where your agent loads skills.
  17. **Claude Code**
  18. ```bash
  19. git clone https://github.com/nowfalsalahudeen/meta-ads-launch ~/.claude/skills/meta-ads-launch
  20. ```
  21. (for one project only, clone it into `<project>/.claude/skills/meta-ads-launch`).
  22. **Other agents:** copy `SKILL.md`, `references/`, `scripts/` and `templates/` into the folder your agent reads skills from. `SKILL.md` is the entry point and the other files are read on demand.
  23. **For the image script** you need Python 3, Google Chrome or Chromium (set `CHROME=/path/to/chrome` if it is not found automatically), and internet access for the web fonts. No Python packages are required.
  24. ## Use
  25. Ask in plain words:
  26. > "Set up a small Meta ad test for my app. It is an invoicing tool for freelancers, I want to start in Spain, budget about 25 dollars a day."
  27. > "Add the Meta Pixel and a sign-up event to my site and web app."
  28. > "I am confused at the ad set screen, here is a screenshot."
  29. The agent inspects your product, asks a few questions (buyer, country, languages, budget, what accounts exist), then works through tracking, creatives, copy and the campaign build with you. Full tutorial: [docs/getting-started.md](docs/getting-started.md).
  30. ### Make the images yourself
  31. ```bash
  32. cp -R examples my-ads && cd my-ads # start from the working example
  33. python3 ../scripts/make_creatives.py ads.json # every ad, language and shape
  34. python3 ../scripts/make_creatives.py ads.json --lang en --only launch
  35. python3 ../scripts/make_creatives.py ads.json --page # profile picture and cover photos
  36. ```
  37. You supply screenshots of your own product (a desktop browser window and a phone screen) and edit `ads.json`. Every option is in [docs/config-reference.md](docs/config-reference.md).
  38. ## What is in the box
  39. ```
  40. SKILL.md workflow, rules, lessons from a first run (entry point)
  41. references/
  42. campaign-walkthrough.md accounts -> campaign -> ad set -> ad -> publish -> read results
  43. tracking.md pixel code, events, privacy wording, verification
  44. creative-specs.md sizes, safe zones, what goes on an ad, copy rules
  45. compliance.md special ad categories, local rules, policies (verify at the source)
  46. scripts/make_creatives.py ad images and page assets from a JSON config (headless Chrome)
  47. templates/ ads.example.json and copy patterns to fill in
  48. examples/ a complete worked example with fictional screens and its output
  49. docs/ getting started, config reference, how it works
  50. ```
  51. ## Why it exists
  52. A first Meta ad test fails for boring reasons: the wrong data source in Events Manager, a schedule that is too short, AI "enhancements" that invent a stock photo of a person holding a phone, one image stretched to every placement, a pixel that never fires on sign-up. This skill encodes the order that works and the traps, so a first-time advertiser can get a clean test live in an afternoon.
  53. ## Honesty
  54. Costs, special-category rules and local advertiser rules mentioned here come from third-party articles that disagree with each other. Check each at the official source before spending. The skill says the same to the user.
  55. ## Author
  56. Built by **Nowfal** from a real launch. Portfolio: [nowfal.in](https://nowfal.in).
  57. ## Licence
  58. MIT. See [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.