superCMO-skills

<div align="center">

<img src="assets/logo.png" alt="SuperCMO" width="120" />

# SuperCMO Skills

</div>

### Enable AI agents to create marketing videos and images

<!-- mcp-name: io.github.SupercmoHQ/supercmo -->
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.*

[![License: Apache-2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
[![CI](https://img.shields.io/github/actions/workflow/status/SupercmoHQ/superCMO-skills/validate.yml?branch=main&label=CI)](https://github.com/SupercmoHQ/superCMO-skills/actions)

<details open>
<summary><strong>UGC video</strong></summary>

> `create an ugc video for this tshirt. it should be a get ready with me reel. snappy. very genz. [product-photo]`

<div align="center">
  <video src="https://github.com/user-attachments/assets/d9daa15f-c534-497e-8e35-6e497b7eaa05" width="300" controls></video>
</div>

</details>

<details open>
<summary><strong>Cartoon video ad</strong></summary>

> `create a cartoon video ad in stylized 3D style, promoting my tumbler. make it fun and entertaining. [product-photo]`

<div align="center">
  <video src="https://github.com/user-attachments/assets/45bff56d-ce38-43de-b555-63bb939ebfbb" width="300" controls></video>
</div>

</details>

<details open>
<summary><strong>Product ad video</strong></summary>

> `make me an ad video for this energy drink [product-photo]`

<div align="center">
  <video src="https://github.com/user-attachments/assets/ab64d169-743f-444a-a7a4-ccae571b0ea4" width="300" controls></video>
</div>

</details>

---

## Contents

- [See how it works](#see-how-it-works)
- [Quick start](#quick-start)
- [Start from a product photo](#start-from-a-product-photo)
- [Why SuperCMO Skills?](#why-supercmo-skills)
- [How the skills work together](#how-the-skills-work-together)
- [The Marketing Production Pipeline](#the-marketing-production-pipeline)
- [Install](#install)
- [Set up a key](#set-up-a-key)
- [Security & trust](#security--trust)
- [Telemetry](#telemetry)
- [Community](#community)
- [Contributing](#contributing)
- [License](#license)

---

## See how it works

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.

<div align="center">
  <video src="https://github.com/user-attachments/assets/08a2f818-b56d-488a-8029-57ad6ad3cd0a" width="680" controls></video>
</div>

---

## Quick start

**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.
```

Prefer to run it yourself:

```bash
npx --yes github:SupercmoHQ/superCMO-skills --all   # every detected host
```

Prefer a preview before spending? Every generation supports `dry_run` — the exact request and cost, no API call.

---

## Start from a product photo

Starting from your product is faster than describing a video from a blank prompt.

Hand SuperCMO a **single product photo** and it builds a UGC ad around it - a creator on camera reviewing, unboxing, trying on, or demoing your product:

1. Upload a product photo and give a short brief
2. 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
3. Once approved, it generates the storyboards, renders each clip, stitches them together, and hands back the finished video

```text
"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 inside **Claude Code, Cursor, Codex, Hermes** - any agent that supports the Agent Skills spec.

---

### Why SuperCMO Skills?

| | |
| --- | --- |
| **You direct, it produces** | SuperCMO doesn't decide what your campaign should say — you do. It handles the production work underneath: scripting to your brief, casting, shooting, editing. It checks in at every step, so you can redirect it mid-run instead of accepting whatever comes out the end. |
| **No tool hopping** | Making one video ad today means jumping between tools: script in one, images in another, voice in a third, video in a fourth, then stitching it in an editor. SuperCMO does it all from a single brief, in one place. |
| **The right model, picked for you** | Every AI image/video model works differently and needs different prompting. Knowing that Veo wants one kind of prompt and Kling another — and which to reach for in the first place — is most of the work. SuperCMO's skills already know. You write the brief; it handles the rest. |
| **Consistency across every shot** | One good clip is easy. Ten clips where the product and the face stay identical is the part that breaks. SuperCMO storyboards before it renders and locks a reference into every generation, so continuity holds across the whole cut. |
| **Editing included** | It doesn't just hand back a raw 10-second clip. It generates the media, splits long clips, trims footage, adds voiceover, and stitches everything into a finished asset. |
| **Pay per use, no subscription** | Most marketing tools charge monthly whether you use them or not. SuperCMO doesn't — bring your own vendor keys (free), or generate on SuperCMO's keys and pay per use. No lock-in. |
| **Runs where you already work** | Inside Claude Code, Cursor, OpenAI Codex, Hermes, Openclaw, or any agent that supports the Agent Skills spec. Your keys and files stay on your machine. |

---

## How the skills work together

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."*

```text
[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.

```

## The Marketing Production Pipeline

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:

<!-- SKILLS:START — auto-generated by scripts/sync_skills.py; do not edit by hand -->
| Skill | Description |
|-------|-------------|
| [analyzing-products](skills/analyzing-products/) | Analyzes an e-commerce link or photo to map out your product's exact physical mechanics and extract clean reference images, building a highly accurate creative brief without any manual research or extraction. |
| [generating-ad-videos](skills/generating-ad-videos/) | Produces a polished, cinematic product commercial in your brand's voice — a no-actor product showcase or an actor-led story ad, at any length. It storyboards every clip to hold your real product identical across cuts, writes the voiceover and casts the actor when the ad calls for one, then stitches it into one ready-to-run spot you approve step by step before anything expensive renders. |
| [generating-ai-actors](skills/generating-ai-actors/) | Casts a distinct, demographic-specific AI actor as a reusable identity reference, allowing you to reliably feature the exact same brand face across an entire multi-asset image and video campaign. |
| [generating-audio](skills/generating-audio/) | Converts scripts into audio. Lets you preview voice candidates from top models before generating. It then formats your script's numbers, dates, and URLs so the chosen AI model pronounces them accura