# Meta Ad Builder

Publish finished creatives as live Meta (Facebook/Instagram) ads via the Meta Marketing...

- Repository: https://github.com/mrpaidsocial/arcads-claude-code-mrpaidsocial (1640 stars)
- Category: DevOps
- License: MIT
- Last updated: 2026-10-19
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add mrpaidsocial/arcads-claude-code-mrpaidsocial --skill meta-ad-builder -g -a claude-code -y`
Codex: `npx skills add mrpaidsocial/arcads-claude-code-mrpaidsocial --skill meta-ad-builder -g -a codex -y`
Cursor: `npx skills add mrpaidsocial/arcads-claude-code-mrpaidsocial --skill meta-ad-builder -g -a cursor -y`
Gemini CLI: `npx skills add mrpaidsocial/arcads-claude-code-mrpaidsocial --skill meta-ad-builder -g -a gemini-cli -y`

## Description

Publish finished creatives as live Meta (Facebook/Instagram) ads via the Meta Marketing API, plus research and ad-copy support. Uploads an image or video, builds a multi-variant TEXT_LIQUIDITY creative, and creates a PAUSED ad in an existing ad set. Also pulls top-performing ads (ranked by ROAS) and competitor ads from the Ad Library to inform copy. Use when the user asks to deploy / publish / launch a creative as a Meta or Facebook ad, build a Meta ad, push a video or image into an ad set, pull their top ads, or research competitor ads. Not for generating creative (use the image/video skills) and not for writing AdTable/Airtable rows (use adtable-light).

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Meta ad builder

Turn a finished creative, typically the output of a generative-AI skill in this
workspace, into a live Meta ad. The skill covers three phases: **research**
(optional) → **copy** → **deploy**. It talks to the Meta Marketing API directly
via ported, parameterized Python scripts.

## When to use this skill

Trigger on phrases like:
- "deploy this video to Meta" / "publish this as a Facebook ad"
- "build/launch a Meta ad" / "push this creative into <ad set>"
- "create a Meta ad with this image and copy"
- "pull my top-performing ads" / "what are my best ads by ROAS"
- "research competitor ads" / "pull <brand>'s ads from the Ad Library"

Do **not** use this skill to *generate* creative, that's `pixar-style-ad`,
`claymation-ad`, `generate-youtube-thumbnail`, `uni1-image-ad`, etc. Do not use
it to write AdTable/Airtable rows, that's `adtable-light`. This skill is the
*direct Meta Marketing API* deployment step.

## Read order

1. **This file**, workflow, decision tree, safety rules.
2. **[prompting/copy-guide.md](prompting/copy-guide.md)**, the 5-body / 5-title /
   3-description frameworks and the `--copy-file` JSON shape.
3. **[reference/deploy-patterns.md](reference/deploy-patterns.md)**, creative
   spec mechanics, video polling, retry, failure modes.
4. **[reference/meta-api-cheatsheet.md](reference/meta-api-cheatsheet.md)**, the
   full Meta Marketing API reference (campaigns, ad sets, ads, enums, gotchas,
   Ad Library). Consult as needed; don't read end-to-end.

## Prerequisites

The rest: https://github.com/mrpaidsocial/arcads-claude-code-mrpaidsocial/blob/HEAD/shared/skills/meta-ad-builder/SKILL.md