spy-competitor-ads SKILL.md skillB

spy-competitor-ads from novoads/agent-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add novoads/agent-skills/spy-competitor-ads@git:20260911.9e39357

Pins git:20260911.9e39357 in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 16 of 17 checks passed
Kind
SKILL.md skill
Repository
novoads/agent-skills
Path
skills/spy-competitor-ads/SKILL.md
Versions recorded
7
Latest version
git:20260911.9e39357, committed Sep 11, 2026
First version recorded
Aug 13, 2026
Size
29,012 bytes
Repository stars
28
License
MIT

Downloads a competitor's live ad creatives — the actual MP4s and JPEGs — from the Meta Ad Library into a local swipe folder, through the Novoads API. One sweep per competitor, priced by a live estimate before anything is charged, media pulled the moment the response lands because the CDN links expire, and every ad carried with its permanent Ad Library URL, the page running it, and how many audiences the creative is running against, closing with the three most established and why. Use when…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Spy Competitor Ads

Find what a competitor is actually running, and put the files on disk. That is the whole job.

It ranks what it finds, on evidence the Ad Library actually publishes — how long a creative has
run and how many audiences it runs against. It does **not** judge craft, explain "why it's
winning", or write a brief; it has not watched these ads and neither have you. What you do with
them belongs to `clone-image-ad`, which turns a static into your own ads, a reusable template,
or both.

The mechanics are one HTTP call per competitor. Everything that makes a run good or bad is
judgement: which competitors, which media mode, and which of the returned ads are actually the
brand's rather than somebody else's.

## Before anything: this runs on a Novoads account

- **Base URL:** `https://api.novoads.ai/v1` (host overridable with `NOVOADS_BASE_URL` — host
  only, you append `/v1`).
- **Auth:** `Authorization: Bearer $NOVOADS_API_KEY`, read from `.env` at the repo root. The key
  is `novo_` plus 64 hex.
- **Check:** `./scripts/check-novoads-env.sh`
- **Never** print API keys, commit `.env`, or paste a key into `MASTER_CONTEXT.md`.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add novoads/agent-skills/spy-competitor-ads@sha256:e4940f246661df18

The line at the top of this page pins the label git:20260911.9e39357, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_ae5vkiimuhnpipfs.svg)](https://markdownregistry.com/a/art_ae5vkiimuhnpipfs)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 7 versions of this file, between Aug 13, 2026 and Sep 11, 2026, about one every 5 days.

versioncommittedcommitsizeaudit
git:20260911.9e39357 latest2026-09-11 9e39357 29,012 BB view · diff
git:20260911.e6e82992026-09-11 e6e8299 29,012 BB view · diff
git:20260814.0cfabea2026-08-14 0cfabea 28,935 BB view · diff
git:20260814.62e1e322026-08-14 62e1e32 28,938 BB view · diff
git:20260814.227c71d2026-08-14 227c71d 28,938 BB view · diff
git:20260813.5c277a42026-08-13 5c277a4 28,736 BB view · diff
git:20260813.5616c8d2026-08-13 5616c8d 28,736 BB view

Audit of the latest version

B  16 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No instruction to read or print local credentials (matched: read from `.env)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (29012 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.

Source

GitHub

novoads/agent-skills · 28 stars · license MIT · pushed 2026-10-17 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ae5vkiimuhnpipfs
GET https://markdownregistry.com/api/v1/resolve?ref=novoads/agent-skills/spy-competitor-ads
GET https://markdownregistry.com/api/v1/blob/e4940f246661df1871a94165077171956e630526d737e3cf3c11c4cc843e89d6

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from novoads/agent-skills

project-context Cursor rule
novoads/agent-skills · .cursor/rules/project-context.mdc · Load project memory from MASTER_CONTEXT.md and keep it updated after substantive work.
git:20260808.7d8596e · audit A · 28 stars
AGENTS.md AGENTS.md file
novoads/agent-skills · AGENTS.md
git:20261008.dbec1ea · audit A · 28 stars
CLAUDE.md CLAUDE.md file
novoads/agent-skills · CLAUDE.md
git:20260930.c0004d7 · audit A · 28 stars
CLAUDE.md@shared CLAUDE.md file
novoads/agent-skills · shared/CLAUDE.md
git:20260810.be31445 · audit A · 28 stars
broll-overlay SKILL.md skill
novoads/agent-skills · shared/skills/broll-overlay/SKILL.md · Overlays silent b-roll cutaway clips onto a finished base video — the base audio keeps running underneath while the…
git:20260911.9e39357 · audit A · 28 stars
caption-video SKILL.md skill
novoads/agent-skills · shared/skills/caption-video/SKILL.md · Burn timed, styled captions into a finished video on the local machine, without re-rendering the source. This is the…
git:20260911.9e39357 · audit A · 28 stars
meta-ad-builder SKILL.md skill
novoads/agent-skills · shared/skills/meta-ad-builder/SKILL.md · Publish finished creatives as live Meta (Facebook/Instagram) ads via the Meta Marketing API, plus research and ad-copy…
git:20260911.9e39357 · audit A · 28 stars
music-mix SKILL.md skill
novoads/agent-skills · shared/skills/music-mix/SKILL.md · Lays a music bed under a finished video — the music is trimmed and faded to the video's exact length and ducks beneath…
git:20260911.9e39357 · audit A · 28 stars
analyze-video SKILL.md skill
novoads/agent-skills · skills/analyze-video/SKILL.md · Analyze a reference video and reverse-engineer its style into a reusable Seedance 2.0 prompting template for the…
git:20260930.c0004d7 · audit A · 28 stars
change-voice SKILL.md skill
novoads/agent-skills · skills/change-voice/SKILL.md · Replaces the voice in a video or audio file with one from the Novoads voice catalog, over the REST API. Converts the…
git:20260930.c0004d7 · audit B · 28 stars
chatgpt-image-ad SKILL.md skill
novoads/agent-skills · skills/chatgpt-image-ad/SKILL.md · Generate one or more standalone Meta image-ad creatives via ChatGPT Image 2 (gpt-image-2) through the Novoads API…
git:20260930.c0004d7 · audit A · 28 stars
claymation-ad SKILL.md skill
novoads/agent-skills · skills/claymation-ad/SKILL.md · Builds a hand-sculpted stop-motion CLAY ad on the Novoads REST API as a STORYBOARD: five to eight beats, each rendered…
git:20261017.da488ac · audit A · 28 stars

Every file in novoads/agent-skills

Browse by kind, by grade B, or by owner.