SuperCMO Skills
About
Open-source skills that empower any AI agent (Claude, Cursor, Codex, Hermes, etc.) to generate end-to-end marketing campaigns — UGC videos, ad videos, product photography and more.
Details
- Author
- supercmohq
- Categories
- Marketing, Other, AI
Jump to
Setup
Install SuperCMO Skills in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/supercmohq/superCMO-skills
Follow the installation instructions in the repository README, then restart your MCP client.
Enable AI agents to create marketing videos and images
Open-source skills that empower any AI agent (Claude, Cursor, Codex, Hermes, etc.) to generate end-to-end marketing campaigns - UGC videos, ad videos, product photography and more.
Just provide a product photo and a brief. The agent extracts the product details, selects the optimal AI image and video models, casts AI actors, and edits the generated content into finished, campaign-ready assets. It can produce videos of any length while maintaining perfect actor and product consistency.
The open-source alternative to closed AI marketing agents.
create an ugc video for this tshirt. it should be a get ready with me reel. snappy. very genz. [product-photo]
create a cartoon video ad in stylized 3D style, promoting my tumbler. make it fun and entertaining. [product-photo]
make me an ad video for this energy drink [product-photo]
- See how it works
- Quick start
- Start from a product photo
- Why SuperCMO Skills?
- How the skills work together
- The Marketing Production Pipeline
- Install
- Set up a key
- Security & trust
- Telemetry
- Community
- Contributing
- License
A full production studio inside Claude. You provide a product photo and a high level (or detailed) brief.
The AI agent then plans the video → writes the script → generates the AI actor → creates storyboards → generates the video clips → stitches them together, and delivers the final video.
The best part? You stay in charge all along.
Paste this to your coding agent(Claude Code, Cursor, Codex, …):
Run npx --yes github:SupercmoHQ/superCMO-skills --all. Tell me whether it succeeded, then follow the next steps it prints to set up a key.
npx --yes github:SupercmoHQ/superCMO-skills --all # every detected host
Prefer a preview before spending? Every generation supportsdry_run— the exact request and cost, no API call.
Starting from your product is faster than describing a video from a blank prompt.
Hand SuperCMO asingle product photoand it builds a UGC ad around it - a creator on camera reviewing, unboxing, trying on, or demoing your product:
- Upload a product photo and give a short brief
- It analyzes the product, picks the format, casts the creator, and writes the script. Then shows you the concept and waits for your approval before spending a cent
- Once approved, it generates the storyboards, renders each clip, stitches them together, and hands back the finished video
"Make a 30-second unboxing UGC ad for this product." [attach product photo]
What you get back is not a random clip. You get:
- You stay in charge- approve the creator, the concept, and the script before anything renders, and change any part along the way.
- Consistency built in- maintains the same actor and product across every clip, through the storyboard and anchor references
- A finished, scroll-stopping video- delivered at the length you asked for, ready to post
Works insideClaude Code, Cursor, Codex, Hermes- any agent that supports the Agent Skills spec.
You act as the creative director, and your agent uses SuperCMO skills to orchestrate the entire production pipeline.
Here is an example of how the skills chain together behind the scenes to execute a complex brief like:"Make a 1-minute video ad for this product [URL] with a voiceover."
[Brief] "Make a 1-minute video ad for this product [URL] with a voiceover." │ ├── 1. Analyze ──> Scrapes the URL to understand the product and fetch product images. │ ├── 2. Plan ──> Breaks the 60s brief into four 15-second shots. │ Writes the script and shot list. │ ├── 3. Image ──> Generates master reference images of the product │ using the best image models. │ ├── 4. Video ──> Generates the 4 video clips. Locks the anchor reference │ into every shot so the product doesn't shape-shift. │ ├── 5. Audio ──> Adds a voiceover, budgeting the script to match the │ exact length of the video. │ └── 6. Stitch ──> Stitches the finished clips together to create one continuous 1-minute video file.
SuperCMO installs a full creative agency into your text-based agent. It doesn't just generate media; it orchestrates the specific steps required to make high-converting ads:
- Product Analysis- Scrapes your URLs to extract brand guidelines, materials, and features so the AI models don't hallucinate your product.
- Ad Copy & Scripting- Breaks the brief into a shot-by-shot ad script tailored for platforms like Meta, TikTok, or YouTube.
- Visual Generation- Produces master reference images and locks them as anchors so your product looks consistent in every video frame.
- Audio & Voiceover- Generates natural, high-energy voiceovers paced perfectly to your video duration.
- Post-Production- Trims footage, syncs audio, and stitches the final MP4.
These are the discrete skills installed into your agent to run that pipeline:
Every host loads thesame skills+ thesame local MCP server- only the wiring differs.Prerequisite:uvon PATH — the MCP server runs viauvx, which provisions Python and the server for you (nothing topip install). The rootpyproject.toml/package.jsonare packaging scaffolding — you don't build anything by hand to run or contribute to the skills.
npx installer- registers the MCP server via each host's own mechanism (codex/claude mcp addwhere a CLI exists; a.cursor/mcp.jsonfor Cursor) and places the skills. One command does every detected host:
npx --yes github:SupercmoHQ/superCMO-skills --claude # Claude Code npx --yes github:SupercmoHQ/superCMO-skills --cursor --project-dir . # Cursor (per project) npx --yes github:SupercmoHQ/superCMO-skills --codex # Codex npx --yes github:SupercmoHQ/superCMO-skills --all # every detected host
If the SuperCMO tools don't show up in your agent afterward, restart it once.
Claude Code plugin- an alternative tonpx … --claude(use one, not both): the whole repo installs as one plugin, managed by Claude Code:
/plugin marketplace add SupercmoHQ/superCMO-skills /plugin install supercmo@superCMO-skills
Codex plugin- an alternative tonpx … --codex(use one, not both): installs the skills + MCP server as one plugin, managed by Codex:
codex plugin marketplace add SupercmoHQ/superCMO-skills codex plugin add supercmo@superCMO-skills
Claude Cowork / Claude desktop- downloadsupercmo-plugin.zipfrom thelatest release, thenSettings → Plugins → Upload local plugin.
Found us onskills.sh?npx skills add SupercmoHQ/superCMO-skillscopies the skills butnot the MCP serverthey call — soimage_generate/video_generatewon't exist yet. Install the server, then reload your agent:
npx --yes github:SupercmoHQ/superCMO-skills --all # or --cursor --project-dir . · --codex · --all
Generation needs a key.Two ways — pick one:
Generate onSuperCMO's keys, pay per use— no vendor signups, nothing to paste.
npx --yes github:SupercmoHQ/superCMO-skills login
Bring your own vendor keys — requests godirectly to the model vendor; nothing routes through SuperCMO.
One file, every host.The installer creates~/.supercmo/.env; the MCP server loads your keys from there on any host (Claude Code, Cursor, Codex, …). Open it and add a key:
# ~/.supercmo/.env WAVESPEED_API_KEY=your-key # image + video (start here) — https://wavespeed.ai FAL_KEY= # image + video (alternative) — https://fal.ai ELEVENLABS_API_KEY= # voiceover (optional) — https://elevenlabs.io GEMINI_API_KEY= # image/video analysis (opt.) — https://aistudio.google.com FIRECRAWL_API_KEY= # url extraction (optional) — https://firecrawl.dev
- One key to start:WAVESPEED_API_KEYcovers image + video and is what we recommend — users report better reliability there.FAL_KEYis fully supported too and serves the same models, so use it if that's the account you already have. With both set, WaveSpeed is used;SUPERCMO_MEDIA_PROVIDER=falpicks the other. The rest are optional — add one when you want that capability (voiceover, analysis, extraction).
- Prefer environment variables?Exporting the key (or putting it in your host's MCP configenvblock) also works andtakes precedence—~/.supercmo/.envis just the reliable default that also works for GUI-launched hosts that don't inherit your shell.
- Check what's set:ask your agent to run thesetup_statustool (host-agnostic, no path needed).
These skills run inside your agent. Exactly what happens:
- Open source & inspectable.Every skill, script, and the MCP server lives in this repo under Apache-2.0 — read, diff, or pin before you run it.
- Your keys stay local (BYOK).With your own vendor keys, they live in~/.supercmo/.env(or your host's MCP configenv/ your shell); the server reads them from its process environment and requests godirectly to the vendor — nothing routes through SuperCMO. With themanagedkey, requests go to SuperCMO's proxy (billed to your credits) — you never hand us a vendor key.
- The MCP server is local + minimal.A stdlib-only Python package (supercmo-skillson PyPI, source inscripts/supercmo_skills/mcp/), fetched and run on demand viauvx supercmo-skills@<version>— it runs on your machine, launched by your host, and starts only when your host enables the plugin.
- Dry-run everything.Generation tools supportdry_run- a free preview of the exact request (keys masked), no API call.
SuperCMO sendsanonymous, opt-outusage counts from the MCP server so we can see which tools get used and prioritize. Full details inTELEMETRY.md.
- What we send:the tool name, whether it succeeded, how long it took, versions (OS / Python / SuperCMO), and a random install id. Nothing else.
- What we NEVER send:your prompts, tool arguments, generated media, file paths, keys, hostname, username, or IP address.
- Turn it off(any one):SUPERCMO_TELEMETRY=false,DO_NOT_TRACK=1, orDISABLE_TELEMETRY=1. It also honors Claude Code'sCLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC.
- See what would be sent:run withSUPERCMO_TELEMETRY=log- prints each payload instead of sending.
- Events go to our own endpoint (api.getsupercmo.ai), never a third-party analytics host. The random install id isneverlinked to any account.
Questions, ideas, or something you built?Open an issue or discussion.
New skills and improvements welcome - seeCONTRIBUTING.md. In short:
- Createskills/<your-skill>/(folder name = thenamein frontmatter), usingskills/generating-images/as the reference layout.
- KeepSKILL.mdshort; push detail intoreferences/, deterministic work intoscripts/(stdlib-only where possible, BYO-keys from env,--dry-runon anything that mutates).
- Validate - CI runs the same on every PR:
python3 scripts/quick_validate.py # structural + strict-YAML frontmatter (blocking) python3 scripts/listing_gate.py # scripts compile + --dry-run gates (blocking) python3 scripts/check_shared_client.py # no raw vendor HTTP - the brokering seam (blocking) python3 scripts/check_catalog_sync.py # provider-key catalog single-sourced (blocking)
The skill files, scripts, and MCP server in this repository are Apache-2.0. The hosted SuperCMO product (getsupercmo.ai) is a separate service governed by its own terms.
If SuperCMO saved you time, a ⭐ helps others find it.
Free MCP that drives an audit of your marketing. Your AI connects, adsOS digs through your ads, email and site, and hands back a growth plan you can run today.
Generate on-brand image and video ads straight from your prompts.
AI video ad production for gtm-engineers & growth teams — 107 tools for UGC concepts, AI avatars, Veo 3 video rendering, and performance feedback.
Create and manage AI-powered short-form social content, including avatars, product scenes, videos, slideshows, scheduling, and publishing.
Create AI UGC video ads with tools for creators, cost estimates, and video generation.
Manage Meta, Google & TikTok ads — launch campaigns, track performance, spy on competitors, generate AI creatives.
Guides for making interactive videos & AI product demos that answer viewers' questions.
CreationLoop is your Marketing Agent. Read the overview, offer, and FAQ; apply as a design partner.
Run reusable AI creative workflows for ecommerce product photography, UGC ads, image-to-video, text-to-video, asset uploads, and async generation results.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
