ad-brief

ad-brief is a command for Claude Code from seancrowe01/ads-machine. It costs 41 tokens per session (1,433 once invoked), scanned A, original, MIT.

A production-planning command that turns a scripted advertisement into a printable filming brief. The brief includes shots, filming details, extra footage ideas, on-screen text guidance, and a thumbnail concept.

In plain words
What is it for?
Use it to select scripted ads from an Airtable advertising pipeline, create shot-by-shot filming instructions for specified video formats, and update the selected records to Briefed status.
Why use it?
It converts a finished script into practical instructions for the person filming, so production details do not have to be worked out on set.

Command for Claude Code

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.

agentmods
npx agentmods add commands/seancrowe01/ads-machine/ad-brief
Clone the repo
git clone --depth 1 https://github.com/seancrowe01/ads-machine

Made for: Claude Code.

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 ad-brief

README.md
[![agentmods](https://agentmods.dev/badge/commands/seancrowe01/ads-machine/ad-brief.svg)](https://agentmods.dev/commands/seancrowe01/ads-machine/ad-brief)
Your own site
<a href="https://agentmods.dev/commands/seancrowe01/ads-machine/ad-brief"><img src="https://agentmods.dev/badge/commands/seancrowe01/ads-machine/ad-brief.svg" alt="Measured on agentmods" height="20"></a>
Per session 41 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,433 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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 $0.00041 $0.01433
Opus 5 $0.00020 $0.00717
Sonnet 5 $0.00008 $0.00287
Haiku 4.5 $0.00004 $0.00143

Measured 5d ago against content hash 65330a780b8b, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

ad-brief scanned grade A with 0 findings 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 5d 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.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/commands/ad-brief.md · 241 lines

How it starts

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

Creative Brief Generator

You are a creative director preparing a filming brief. You take a scripted ad from the Pipeline and produce a complete, printable production card that someone can take to a filming session.

What you produce: Shot list, filming card, B-roll suggestions, text overlay specs, and thumbnail concept. Pipeline record updated to Briefed status.


Config

Read from CLAUDE.md:

Airtable Base ID: YOUR_AIRTABLE_BASE_ID
Ad Pipeline Table: YOUR_PIPELINE_TABLE_ID

Also read: reference/visual-styles.md


Step 1: Select Scripted Ads

If the user specifies which ad, use that.

Otherwise, show Pipeline records with Status = Scripted:

Use Airtable MCP: list_records
  filter: {Status}='Scripted'
  fields: Name, Angle, Format, Hook, Script

Let the user pick one or batch-select multiple.


Step 2: Generate Shot List

Break the script into numbered shots with production details:

SHOT LIST -- {ad name}
Format: {9:16 / 4:5 / 1:1}
Total shots: {N}

---

Shot 1: HOOK (0-3s)
  Framing: Close-up, eye level
  Camera: Static (phone on tripod)
  Action: Speaker delivers hook directly to camera
  Audio: Voice only, no music
  Text overlay: "{hook text}" -- top third, white on dark background, large

Shot 2: BODY BEAT 1 (3-8s)
  Framing: Medium shot
  Camera: Static or slight push-in
  Action: {what the speaker does}
  B-roll option: {alternative visual}
  Text overlay: "{key phrase}" -- center, medium

Shot 3: ...

Shot Details to Include

  • Framing: Close-up, medium, wide, over-shoulder, screen recording
  • Camera: Static, pan, push-in, handheld
  • Action: What the subject does during this shot
  • Audio: Voice, music, sound effects, silence
  • Text overlay: Exact text, position, timing
  • B-roll alternative: What to show if not filming a person

Step 3: B-Roll Suggestions

For each script section, suggest 3-5 B-roll options from the standard categories (see reference/visual-styles.md):

Read the full file on GitHub · 241 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. 5d ago First seen · 241 lines · 41 tokens per session scan A 65330a780b8b

Subscribe to this mod's changes

ad-brief is a command published in the GitHub repository seancrowe01/ads-machine (20 stars, last pushed 5mo ago), licensed MIT. It adds 41 tokens to every session and 1,433 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other commands, from other repositories

competitive-auction-insights

Analyze Google Ads auction insights to understand competitive landscape. See who you're competing against and where you're winning or losing. (requires Pro subscription).

Ad-Superpowers/ad-superpowers-plugin · 27 tokens

organic-performance-audit

Comprehensive audit of your organic search performance using Google Search Console data. Analyzes keyword rankings, CTR optimization opportunities, page performance, search type breakdown, and trend analysis with actionable recommendations. (requires Pro subscription).

Ad-Superpowers/ad-superpowers-plugin · 43 tokens

b2b-pipeline-review

B2B lead pipeline review — CPL trends, lead quality scoring, and MQL-to-SQL conversion analysis across LinkedIn and Google Ads.

Ad-Superpowers/ad-superpowers-plugin · 28 tokens

creative-fatigue-scanner

Proactively detect ad creative fatigue before performance tanks. Uses platform-specific evidence-based thresholds: TikTok fatigues 4x faster (3-7 days) than Meta (14 days). Google Ads uses asset ratings (4-8 weeks). LinkedIn has longest cycles (4-6 weeks). (requires Pro subscription).

Ad-Superpowers/ad-superpowers-plugin · 64 tokens

incrementality-test-designer

Design rigorous incrementality tests to measure true advertising impact. Includes geo lift test planning, holdout/control group design, statistical power calculations, test duration recommendations, and cost-benefit analysis. Essential for understanding true incremental ROAS in a privacy-first measurement landscape.…

Ad-Superpowers/ad-superpowers-plugin · 56 tokens

channel-strategy-advisor

AI-powered channel selection advisor that matches campaign objectives with optimal platform mix. Analyzes audience fit, platform strengths, funnel stage requirements, and budget constraints to recommend the ideal channel strategy. Includes budget allocation suggestions and expected performance benchmarks per channel.…

Ad-Superpowers/ad-superpowers-plugin · 53 tokens