Skip to content
Back to search

superCMO-skills

SkillGitHubIncomplete

Safety scan

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

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/SupercmoHQ/superCMO-skills with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/SupercmoHQ/superCMO-skills'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/supercmohq--supercmo-skills/badge.svg)](/listings/supercmohq--supercmo-skills)

HTML

<a href="/listings/supercmohq--supercmo-skills"><img src="/api/listings/supercmohq--supercmo-skills/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.

**Paste this to your coding agent** (Cursor, Codex, …):

Run `npx --yes @supercmo/skills@0.1.27 --all`. Once it's installed, run the supercmo-setup skill to complete the setup.

Prefer to run it yourself:

npx --yes @supercmo/skills@0.1.27 --all   # every detected host

Run the **supercmo-setup** skill or ask your agent to "set me up".

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

---

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.

.claude-plugin/marketplace.json · Manifest · 19 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "superCMO-skills",
  3. "owner": {
  4. "name": "SuperCMO",
  5. "url": "https://getsupercmo.ai"
  6. },
  7. "metadata": {
  8. "description": "Open, model-agnostic, BYO-keys marketing skills for AI agents",
  9. "version": "0.1.27",
  10. "repository": "https://github.com/SupercmoHQ/superCMO-skills"
  11. },
  12. "plugins": [
  13. {
  14. "name": "supercmo",
  15. "description": "SuperCMO marketing skills — the whole repo installs as one plugin (everything under skills/ ships with it).",
  16. "source": "./"
  17. }
  18. ]
  19. }
README.md · README · 399 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. <img src="assets/logo.png" alt="SuperCMO" width="120" />
  3. # SuperCMO Skills
  4. </div>
  5. ### Enable AI agents to create marketing videos and images
  6. <!-- mcp-name: io.github.SupercmoHQ/supercmo -->
  7. 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.
  8. 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.
  9. *The open-source alternative to closed AI marketing agents.*
  10. [![License: Apache-2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
  11. [![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)
  12. **Install in one command** — into Claude Code, Cursor and Codex, whichever you have (needs
  13. [`uv`](https://docs.astral.sh/uv/getting-started/installation/)):
  14. ```bash
  15. npx --yes @supercmo/skills@0.1.27 --all
  16. ```
  17. For Cursor, run it in your project with `--cursor --project-dir .` so the skills land there too.
  18. Then ask your agent to "set me up": bring your own model keys, or sign in and pay per use with SuperCMO's.
  19. If the skills are useful to you, a ⭐ helps other people find them.
  20. <details open>
  21. <summary><strong>UGC video</strong></summary>
  22. > `create an ugc video for this tshirt. it should be a get ready with me reel. snappy. very genz. [product-photo]`
  23. <div align="center">
  24. <video src="https://github.com/user-attachments/assets/d9daa15f-c534-497e-8e35-6e497b7eaa05" width="300" controls></video>
  25. </div>
  26. </details>
  27. <details open>
  28. <summary><strong>Cartoon video ad</strong></summary>
  29. > `create a cartoon video ad in stylized 3D style, promoting my tumbler. make it fun and entertaining. [product-photo]`
  30. <div align="center">
  31. <video src="https://github.com/user-attachments/assets/45bff56d-ce38-43de-b555-63bb939ebfbb" width="300" controls></video>
  32. </div>
  33. </details>
  34. <details open>
  35. <summary><strong>Product ad video</strong></summary>
  36. > `make me an ad video for this energy drink [product-photo]`
  37. <div align="center">
  38. <video src="https://github.com/user-attachments/assets/ab64d169-743f-444a-a7a4-ccae571b0ea4" width="300" controls></video>
  39. </div>
  40. </details>
  41. ---
  42. ## Contents
  43. - [See how it works](#see-how-it-works)
  44. - [Quick start](#quick-start)
  45. - [Hosted SuperCMO](#hosted-supercmo)
  46. - [Start from a product photo](#start-from-a-product-photo)
  47. - [Why SuperCMO Skills?](#why-supercmo-skills)
  48. - [How the skills work together](#how-the-skills-work-together)
  49. - [The Marketing Production Pipeline](#the-marketing-production-pipeline)
  50. - [Install](#install)
  51. - [Set up a key](#set-up-a-key)
  52. - [Security & trust](#security--trust)
  53. - [Telemetry](#telemetry)
  54. - [Community](#community)
  55. - [Contributing](#contributing)
  56. - [License](#license)
  57. ---
  58. ## See how it works
  59. A full production studio inside Claude. You provide a product photo and a high level (or detailed) brief.
  60. 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.
  61. The best part? You stay in charge all along.
  62. <div align="center">
  63. <video src="https://github.com/user-attachments/assets/08a2f818-b56d-488a-8029-57ad6ad3cd0a" width="680" controls></video>
  64. </div>
  65. ---
  66. ## Quick start
  67. **Paste this to your coding agent** (Cursor, Codex, …):
  68. ```
  69. Run `npx --yes @supercmo/skills@0.1.27 --all`. Once it's installed, run the supercmo-setup skill to complete the setup.
  70. ```
  71. Prefer to run it yourself:
  72. ```bash
  73. npx --yes @supercmo/skills@0.1.27 --all # every detected host
  74. ```
  75. Run the **supercmo-setup** skill or ask your agent to "set me up".
  76. Prefer a preview before spending? Every generation supports `dry_run` — the exact request, no API call.
  77. ---
  78. ## Hosted SuperCMO
  79. Rather not set anything up? [SuperCMO](https://getsupercmo.ai) runs these same skills for you, in the
  80. browser:
  81. - **No setup** — sign in and start; nothing to install, no keys to manage.
  82. - **A workspace per brand** — a private sandbox where the agent runs code and keeps your files.
  83. - **Publishing** — connect your accounts, approve a post, and it goes out to Instagram (Business
  84. account), a Facebook Page, LinkedIn (your profile), YouTube or Reddit.
  85. - **A calendar** — your scheduled posts and recurring tasks in one place, to edit or cancel.
  86. [Try SuperCMO →](https://getsupercmo.ai)
  87. ---
  88. ## Start from a product photo
  89. Starting from your product is faster than describing a video from a blank prompt.
  90. 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:
  91. 1. Upload a product photo and give a short brief
  92. 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
  93. 3. Once approved, it generates the storyboards, renders each clip, stitches them together, and hands back the finished video
  94. ```text
  95. "Make a 30-second unboxing UGC ad for this product." [attach product photo]
  96. ```
  97. What you get back is not a random clip. You get:
  98. - **You stay in charge** - approve the creator, the concept, and the script before anything renders, and change any part along the way.
  99. - **Consistency built in** - maintains the same actor and product across every clip, through the storyboard and anchor references
  100. - **A finished, scroll-stopping video** - delivered at the length you asked for, ready to post
  101. Works inside **Claude Code, Cursor, Codex, Hermes** - any agent that supports the Agent Skills spec.
  102. ---
  103. ### Why SuperCMO Skills?
  104. | | |
  105. | --- | --- |
  106. | **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. |
  107. | **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. |
  108. | **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. |
  109. | **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. |
  110. | **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. |
  111. | **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. |
  112. | **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. |
  113. ---
  114. ## How the skills work together
  115. You act as the creative director, and your agent uses SuperCMO skills to orchestrate the entire production pipeline.
  116. 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."*
  117. ```text
  118. [Brief] "Make a 1-minute video ad for this product [URL] with a voiceover."
  119. │
  120. ├── 1. Analyze ──> Scrapes the URL to understand the product and fetch product images.
  121. │
  122. ├── 2. Plan ──> Breaks the 60s brief into four 15-second shots.
  123. │ Writes the script and shot list.
  124. │
  125. ├── 3. Image ──> Generates master reference images of the product
  126. │ using the best image models.
  127. │
  128. ├── 4. Video ──> Generates the 4 video clips. Locks the anchor reference
  129. │ into every shot so the product doesn't shape-shift.
  130. │
  131. ├── 5. Audio ──> Adds a voiceover, budgeting the script to match the
  132. │ exact length of the video.
  133. │
  134. └── 6. Stitch ──> Stitches the finished clips together to create one
  135. continuous 1-minute video file.
  136. ```
  137. ## The Marketing Production Pipeline
  138. 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:
  139. * **Product Analysis** - Scrapes your URLs to extract brand guidelines, materials, and features so the AI models don't hallucinate your product.
  140. * **Ad Copy & Scripting** - Breaks the brief into a shot-by-shot ad script tailored for platforms like Meta, TikTok, or YouTube.
  141. * **Visual Generation** - Produces master reference images and locks them as anchors so your product looks consistent in every video frame.
  142. * **Audio & Voiceover** - Generates natural, high-energy voiceovers paced perfectly to your video duration.
  143. * **Post-Production** - Trims footage, syncs audio, and stitches the final MP4.
  144. These are the discrete skills installed into your agent to run that pipeline:
  145. <!-- SKILLS:START — auto-generated by scripts/sync_skills.py; do not edit by hand -->
  146. | Skill | Description |
  147. |-------|-------------|
  148. | [generating-ugc-videos](skills/generating-ugc-videos/) | Produces UGC videos of any length - like review, unboxing, try-on, tutorial and more. It casts the actor, writes the script, and storyboards multiple clips to lock in actor and product consistency. It lets you direct every step to get a cohesive, ready-to-run ad in minutes. |
  149. | [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. |
  150. | [generating-cartoon-videos](skills/generating-cartoon-videos/) | Produces a drawn, animated video for your product — cartoon, anime, illustrated or painted, at any length. Your product either stays exactly as photographed or is drawn into the style, and a cast of characters carries the story around it. It settles one art style, writes the story, draws your cast once so every cut is the same cast, then films it clip by clip and lays a voiceover over the top — with your approval before anything expensive renders. |
  151. | [cloning-video-ads](skills/cloning-video-ads/) | Recreates a video ad you admire with your own product. It watches the reference ad, works out the shots, pacing, camera and voiceover that make it work, then rebuilds the same structure around your product — swapping the product, brand and spoken lines for yours while holding the original's craft. You approve the plan before anything expensive renders, and it comes back as one finished clip. |
  152. | [generating-image-ads](skills/generating-image-ads/) | Produces a scroll-stopping image ads for your product — one image, or a set in every placement ratio your feed needs. It keeps your real product and your brand identity perfectly consistent across every frame, and shapes the offer and claims you give it into a well designed ad, following industry best practices. |
  153. | [generating-product-photos](skills/generating-product-photos/) | Directs a commercial photoshoot around your product, automatically applying the correct lighting, framing, camera angles and props to deliver studio-quality product shots across 10+ formats. |
  154. | [researching-competitor-ads](skills/researching-competitor-ads/) | Analyzes what your competitors are advertising and shows you what is actually working — the ads that have run longest, the ones they quietly dropped, and what the winners have in common. A vision model watches the image and video ads that carry the signal — the long-runners, the ones just launched, the ones they dropped — the whole way through. So you learn how each one is built: the hook, the pacing, when the product lands, the proof and the offer. You also get the angles nobody in your category has taken. |
  155. | [analyzing-own-ads](skills/analyzing-own-ads/) | Audits your own advertising the way you would a competitor's — pulling every ad you run from the public library and watching the creative the whole way through. You get the map of what you already cover: which angles, hooks and formats you run, which ads have held longest, what you quietly stopped and how fast, and which winners are still carrying the account with nothing newer built beside them. |
  156. | [planning-campaigns](skills/planning-campaigns/) | Decides what your next ads should be. It reads your brand, your product, the ads you already run and what competitors are doing, then writes concepts ranked by what is worth testing — each a full description of one ad, the buyer it targets and the bet it tests, with the proof it rests on and the skill that would build it. Approve the plan and it builds the concepts you pick, one by one, through the specialist skills. |
  157. | [onboarding-user](skills/onboarding-user/) | Sets your brand up from one link. Give it your website and it works out who you are — your voice, your audience, what you sell — finds who you compete with, and writes both where every future session will find them. |
  158. | [supercmo-setup](skills/supercmo-setup/) | Gets you from installed to generating in a few simple steps |
  159. | [adapting-formats](skills/adapting-formats/) | Takes an ad you already have and remakes it in every other size you need it in. It reads your ad first, works out what has to move and what fills the space the new shape opens up, and shows you that plan before it spends anything — then rebuilds each shape around the original so your product, palette and wording stay recognisably the same rather than being stretched, cropped or letterboxed into a mess. |
  160. | [analyzing-brand](skills/analyzing-brand/) | Works out your brand from your website — your colours, fonts and logo, how you sound, who you sell to, what you sell, and the claims you stand behind. Anything your site doesn't actually say is written down as unconfirmed rather than invented, so the skills that plan and make your ads work from your real brand. |
  161. | [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. |
  162. | [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. |
  163. | [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 accurately. |
  164. | [generating-images](skills/generating-images/) | Routes your brief to the best of 10+ SOTA image models (like Nano Banana, GPT Image), writes detailed prompts as per model specifications and generates multiple variations instantly. |
  165. | [generating-storyboards](skills/generating-storyboards/) | Draws out your entire video concept clip-by-clip as static images, enforcing strict character and product continuity so you can approve camera angles and visual flow before committing to expensive video renders. |
  166. | [generating-videos](skills/generating-videos/) | Routes your brief to the best of 10+ SOTA video models (like Veo, Seedance), writes detailed prompts as per model specifications and generates multi-clip stories that hold continuity across cuts, stitched into one file. |
  167. | [identifying-competitors](skills/identifying-competitors/) | Finds who a brand competes with: searches the web for the alternatives buyers compare it against, proposes a shortlist with a source per name, and confirms the real ones for other skills to build on. |
  168. | [writing-ad-copy](skills/writing-ad-copy/) | Writes the text that runs alongside your ad — headline, primary text, description and call to action — tuned to the fields and best practices of each platform it runs on: Facebook and Instagram, Google Search, LinkedIn, TikTok, X and Reddit. It works one angle several ways and sizes each field so nothing gets cut off in the feed. |
  169. | [writing-video-prompts](skills/writing-video-prompts/) | Translates your scenes into the highly specific, detailed instructions that different video models require. It times the camera motion and steers around known AI rendering limits to match your exact visual brief. |
  170. | [writing-video-scripts](skills/writing-video-scripts/) | Drafts spoken scripts built around proven opening hooks designed specifically to stop the scroll. It sizes the text to fit your exact runtime and paces words across natural breath points for human delivery. |
  171. <!-- SKILLS:END -->
  172. ## Install
  173. Every host loads the **same skills** + the **same local MCP server** - only the wiring differs.
  174. **Prerequisite:** [`uv`](https://docs.astral.sh/uv/getting-started/installation/) on PATH — the MCP
  175. server runs via `uvx`, which provisions Python and the server for you (nothing to `pip install`). The
  176. root `pyproject.toml` / `package.json` are packaging scaffolding — you don't build anything by hand to
  177. run or contribute to the skills.
  178. **npx installer** - registers the MCP server via each host's own mechanism (`codex`/`claude mcp add` where a CLI exists; a `.cursor/mcp.json` for Cursor) and places the skills. One command does every detected host:
  179. ```bash
  180. npx --yes @supercmo/skills@0.1.27 --claude # Claude Code
  181. npx --yes @supercmo/skills@0.1.27 --cursor --project-dir . # Cursor (per project)
  182. npx --yes @supercmo/skills@0.1.27 --codex # Codex
  183. npx --yes @supercmo/skills@0.1.27 --all # every detected host
  184. ```
  185. If the SuperCMO tools don't show up in your agent afterward, restart it once.
  186. **Claude Code plugin** - an alternative to `npx … --claude` (use one, not both): the whole repo installs as one plugin, managed by Claude Code:
  187. ```
  188. /plugin marketplace add SupercmoHQ/superCMO-skills
  189. /plugin install supercmo@superCMO-skills
  190. ```
  191. **Codex plugin** - an alternative to `npx … --codex` (use one, not both): installs the skills + MCP server as one plugin, managed by Codex:
  192. ```bash
  193. codex plugin marketplace add SupercmoHQ/superCMO-skills
  194. codex plugin add supercmo@superCMO-skills
  195. ```
  196. **Claude Cowork / Claude desktop** - download `supercmo-plugin.zip` from the
  197. [latest release](https://github.com/SupercmoHQ/superCMO-skills/releases), then
  198. **Settings → Plugins → Upload local plugin**.
  199. **Found us on [skills.sh](https://skills.sh)?** `npx skills@1.7.4 add SupercmoHQ/superCMO-skills` copies the
  200. skills but **not the MCP server** they call — so `image_generate`/`video_generate` won't exist yet.
  201. Install the server, then reload your agent:
  202. ```bash
  203. npx --yes @supercmo/skills@0.1.27 --all # or --cursor --project-dir . · --codex · --all
  204. ```
  205. ## Set up a key
  206. Generation needs a key. **Two ways — pick one:**
  207. ### Option A · Managed — one command
  208. Generate on **SuperCMO's keys, pay per use** — no vendor signups, nothing to paste.
  209. ```bash
  210. npx --yes @supercmo/skills@0.1.27 login
  211. ```
  212. Opens SuperCMO in your browser to **sign in and authorize this device**; the key is written to
  213. `~/.supercmo/.env` automatically. Buy credits in the web app when you're ready.
  214. ### Option B · Bring your own keys — free
  215. Bring your own vendor keys — requests go **directly to the model vendor; nothing routes through SuperCMO**.
  216. **One file, every host.** The installer creates `~/.supercmo/.env`; the MCP server loads your keys from
  217. there on any host (Claude Code, Cursor, Codex, …). Open it and add a key:
  218. ```bash
  219. # ~/.supercmo/.env
  220. WAVESPEED_API_KEY=your-key # image + video (start here) — https://wavespeed.ai
  221. FAL_KEY= # image + video (alternative) — https://fal.ai
  222. ELEVENLABS_API_KEY= # voiceover (optional) — https://elevenlabs.io
  223. GEMINI_API_KEY= # image/video analysis (opt.) — https://aistudio.google.com
  224. FIRECRAWL_API_KEY= # url extraction (optional) — https://firecrawl.dev
  225. ```
  226. * **One key to start:** `WAVESPEED_API_KEY` covers image + video and is what we recommend — users
  227. report better reliability there. `FAL_KEY` is fully supported too and serves the same models, so
  228. use it if that's the account you already have. With both set, WaveSpeed is used;
  229. `SUPERCMO_MEDIA_PROVIDER=fal` picks the other. The rest are optional — add one when you want that
  230. capability (voiceover, analysis, extraction).
  231. * **Prefer environment variables?** Exporting the key (or putting it in your host's MCP config `env`
  232. block) also works and **takes precedence** — `~/.supercmo/.env` is just the reliable default that also
  233. works for GUI-launched hosts that don't inherit your shell.
  234. * **Check what's set:** ask your agent to run the `setup_status` tool (host-agnostic, no path needed).
  235. ## Security & trust
  236. These skills run inside your agent. Exactly what happens:
  237. * **Open source & inspectable.** Every skill, script, and the MCP server lives in this repo under
  238. Apache-2.0 — read, diff, or pin before you run it.
  239. * **Your keys stay local (BYOK).** With your own vendor keys, they live in `~/.supercmo/.env` (or your
  240. host's MCP config `env` / your shell); the server reads them from its process environment and requests
  241. go **directly to the vendor — nothing routes through SuperCMO**. With the **managed** key, requests go
  242. to SuperCMO's proxy (billed to your credits) — you never hand us a vendor key.
  243. * **The MCP server is local + minimal.** A stdlib-only Python package (`supercmo-skills` on PyPI, source
  244. in `scripts/supercmo_skills/mcp/`), fetched and run on demand via `uvx supercmo-skills@<version>` — it
  245. runs on your machine, launched by your host, and starts only when your host enables the plugin.
  246. * **Dry-run everything.** Generation tools support `dry_run` - a free preview of the exact request
  247. (keys masked), no API call.
  248. Found something off? [Open an issue](https://github.com/SupercmoHQ/superCMO-skills/issues).
  249. ## Telemetry
  250. SuperCMO sends **anonymous, opt-out** usage counts from the MCP server so we can see which tools get
  251. used and prioritize. Full details in [`TELEMETRY.md`](TELEMETRY.md).
  252. * **What we send:** the tool name, whether it succeeded, how long it took, the model and provider,
  253. whether it used your own key or SuperCMO's, an error code if it failed, versions (OS / Python /
  254. SuperCMO), and a random install id. The full list is in [`TELEMETRY.md`](TELEMETRY.md).
  255. * **What we NEVER send:** your prompts, tool arguments, generated media, file paths, keys, hostname,
  256. username, or IP address.
  257. * **Turn it off** (any one): `SUPERCMO_TELEMETRY=false`, `DO_NOT_TRACK=1`, or `DISABLE_TELEMETRY=1`.
  258. It also honors Claude Code's `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`.
  259. * **See what would be sent:** run with `SUPERCMO_TELEMETRY=log` - prints each payload instead of
  260. sending.
  261. * Events go to our own endpoint (`api.getsupercmo.ai`), never a third-party analytics host. The
  262. random install id is **never** linked to any account.
  263. ## Community
  264. Questions, ideas, or something you built? [Open an issue or discussion](https://github.com/SupercmoHQ/superCMO-skills/issues).
  265. Kshitiz ([@kshitizkgp](https://github.com/kshitizkgp)) reads every new issue and replies within one
  266. working day.
  267. ## Contributing
  268. New skills and improvements welcome - see [`CONTRIBUTING.md`](CONTRIBUTING.md). In short:
  269. 1. Create `skills/<your-skill>/` (folder name = the `name` in frontmatter), using
  270. `skills/generating-images/` as the reference layout.
  271. 2. Keep `SKILL.md` short; push detail into `references/`, deterministic work into `scripts/`
  272. (stdlib-only where possible, BYO-keys from env, `--dry-run` on anything that mutates).
  273. 3. Validate - CI runs the same on every PR:
  274. ```bash
  275. python3 scripts/quick_validate.py # structural + strict-YAML frontmatter (blocking)
  276. python3 scripts/listing_gate.py # scripts compile + --dry-run gates (blocking)
  277. python3 scripts/check_shared_client.py # no raw vendor HTTP - the brokering seam (blocking)
  278. python3 scripts/check_catalog_sync.py # provider-key catalog single-sourced (blocking)
  279. ```
  280. ## License
  281. Apache-2.0 - see [`LICENSE`](LICENSE) and [`NOTICE`](NOTICE).
  282. The skill files, scripts, and MCP server in this repository are Apache-2.0. The hosted SuperCMO
  283. product (`getsupercmo.ai`) is a separate service governed by its own terms.
  284. <div align="center">
  285. If SuperCMO saved you time, a ⭐ helps others find it.
  286. Built by [SuperCMO](https://getsupercmo.ai) · [Report an issue](https://github.com/SupercmoHQ/superCMO-skills/issues)
  287. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

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