meta-media-upload-guide

meta-media-upload-guide is a skill for Claude Code from Ad-Superpowers/ad-superpowers-plugin. It costs 170 tokens per session (8,868 once invoked), scanned A, original, MIT.

A guide to uploading images and videos into Meta Ads from local files, public web addresses, or connected storage services. Meta Ads is the advertising system for Facebook and Instagram.

In plain words
What is it for?
Use it to upload ad images or videos, reuse media already in an ad account, and prepare multiple creative assets for campaigns.
Why use it?
It clarifies why a remote service cannot always access a file on your computer and helps choose an appropriate upload route.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the ad-superpowers plugin — 120 skills, 35 commands, 5 agents, 1 MCP server shipped together

Good fit Use it to upload ad images or videos, reuse media already in an ad account, and prepare multiple creative assets for campaigns.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/ad-superpowers/ad-superpowers-plugin/meta-media-upload-guide
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add Ad-Superpowers/ad-superpowers-plugin --skill meta-media-upload-guide
Clone the repo
git clone --depth 1 https://github.com/Ad-Superpowers/ad-superpowers-plugin

Made for: Claude Code.

Or install ad-superpowers, the plugin that ships this one along with the rest of its 120 skills, 35 commands, 5 agents, 1 MCP server.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for meta-media-upload-guide

README.md
[![agentmods](https://agentmods.dev/badge/skills/ad-superpowers/ad-superpowers-plugin/meta-media-upload-guide/github.svg)](https://agentmods.dev/skills/ad-superpowers/ad-superpowers-plugin/meta-media-upload-guide)
Your own site
<a href="https://agentmods.dev/skills/ad-superpowers/ad-superpowers-plugin/meta-media-upload-guide"><img src="https://agentmods.dev/badge/skills/ad-superpowers/ad-superpowers-plugin/meta-media-upload-guide/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for meta-media-upload-guide

Your own site · 80×15
<a href="https://agentmods.dev/skills/ad-superpowers/ad-superpowers-plugin/meta-media-upload-guide"><img src="https://agentmods.dev/badge/skills/ad-superpowers/ad-superpowers-plugin/meta-media-upload-guide.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 170 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 8,868 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00170 $0.08868
Opus 5.5 $0.00068 $0.03547
Sonnet 5.5 $0.00034 $0.01774
Haiku 4.5 $0.00017 $0.00887

Measured 29d ago against content hash 78a8a51777a0, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

meta-media-upload-guide scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 29d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

Keep the capability in memory. If using curl, supply its URL and returned
plugin/skills/meta-media-upload-guide/SKILL.md · 635 lines

How it starts

The opening of the file, as written. The whole thing — 635 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Meta Media Upload Guide

Requires the Ad Superpowers MCP server with a Meta Ads connection.

The single source of truth for getting creative assets into Meta Ads when using Ad Superpowers' MCP tools. Eliminates the most common workflow confusion: "why won't Claude upload my local file?".

Choose the upload route

Reuse an existing destination-account image_hash or video_id first (PATH B). For a local JPEG/PNG up to 20 MB (20,000,000 bytes), prefer private staging when assets_stage is available (PATH C). The client needs file access and HTTP upload (for example a local shell); the remote MCP server cannot open a client path or an attachment in another application. Client support must be tested, not inferred from a product name. Use a connected Meta account that your workspace is currently allowed to modify. Tool discovery alone does not establish upload access; do not change rollout settings yourself.

An already public, direct HTTPS media URL remains supported (PATH A). For meta_upload_image(image_url=...), AdSuperpowers downloads the image and uploads it to Meta. Do not publish private client files merely to obtain a URL.

Legacy meta_upload_image(image_data=...) remains available with the existing 4 MiB raw-byte limit. Around 50 KB is a practical context warning, not an additional enforced limit. Avoid sending ordinary creative-sized base64 strings through the conversation. If staging or local shell access is unavailable, use an approved existing URL or manual Ads Manager upload and library discovery. For a local MP4 up to 500 MB (500,000,000 bytes), follow the private staging route in PATH D. Preserve IDs and outcomes from earlier attempts: a later successful upload does not resolve an old uncertain attempt. Never repeat or restage an uncertain upload automatically. An existing approved asset, an already approved URL or authorized manual Ads Manager upload remains an option.

For a folder, use the bounded staged workflow below when available. Manual Ads Manager drag/drop remains an alternative, especially when Meta must be the only remote store. Uploading media does not authorize creating or activating ads.

Read the full file on GitHub · 635 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 29d ago Changed · +24 lines 78a8a51777a0
  2. 1mo ago First seen · 611 lines · 170 tokens per session scan A 0a406684afc6

Subscribe to this mod's changes

meta-media-upload-guide is a skill published in the GitHub repository Ad-Superpowers/ad-superpowers-plugin (5 stars, last pushed 29d ago), licensed MIT. It adds 170 tokens to every session and 8,868 once invoked, about $0.0007 per session on Opus 5.5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-11.

Related

Other skills, from other repositories

analytics

Growth analytics authority — GA4 event tracking, conversion funnels, attribution models, cohort analysis, A/B testing, Supabase analytics queries, and revenue reporting patterns.

LuuOW/meridian-mcp · 33 tokens

creative-generate

A workflow for creating advertising images and banners from a strategy brief. It separates the main visual artwork from the accurately typeset text and produces variants for display or social formats.

logly/mureo · 131 tokens

cro-optimizer

CRO specialist that pulls live analytics data via the Humblytics MCP, analyzes conversion funnels, identifies drop-off points, and generates prioritized A/B test hypotheses. Use when analyzing conversion rates, diagnosing funnel leaks, optimizing signup flows, or creating test roadmaps. Triggers: CRO, conversion rate…

Humblytics/humblytics-marketing-skills · 76 tokens

learn

Save a marketing diagnosis insight to the pro-diagnosis knowledge base so it is applied in future operations across all platforms. Use when the user runs /learn, explicitly teaches the agent a marketing insight, corrects the agent's analysis, or asks to remember/record an operational learning for next time. Also use…

logly/mureo · 98 tokens

lead-form-create

Create a Meta Instant Form (Lead Ad form) through a one-question-at-a-time interview. Use when the user asks to create a lead form, Instant Form, CV form, or similar. The agent collects required parameters via a guided dialogue, confirms, then calls metaadsleadformscreate. Also use when the user asks in Japanese…

logly/mureo · 93 tokens

ai-hive-simulate-dn-samuel

A research and content-planning workflow that studies DN-Samuel's public material and turns its general methods into original work using your own facts and experience. It can also organise authorised documents into a source-linked reference library.

wubin1836/ai-hive-agent-skills · 334 tokens