Compare commits

...
5 Commits
Author SHA1 Message Date
Corey Haines f2512687a4 Merge pull request #532 from coreyhaines31/development
release: ad-creative short-form video spec + creator formats (2.10.3)
2026-08-23 09:22:24 -07:00
Corey Haines da351ea021 Merge pull request #523 from coreyhaines31/feature/ad-creative-short-form-specs
feat(ad-creative): short-form vertical video spec + creator formats (2.8.1)
2026-08-23 09:19:41 -07:00
Corey Haines ff06f45b3a Merge pull request #531 from coreyhaines31/main
chore: sync development up to main (catch up 7 merged commits)
2026-08-23 09:19:14 -07:00
Corey HainesandClaude Fable 5 ee0618ef2f feat(ad-creative): short-form vertical video spec + creator formats (2.8.1)
New references/short-form-video-specs.md distilled from reelclaw-templates
(Daniel Hangan, built on HeyGen HyperFrames; patterns credited, no code
vendored).

Part 1 — vertical video spec applying to ALL 9:16 output (iMessage/motion/
creator): cross-platform safe band (220 top / 500 bottom / 180 sides ->
720x1200 text-safe area), classic TikTok caption recipe (white fill +
black paint-order stroke, no pill), static-caption auto-sizing, audio
defaults + the organic-vs-baked-music reach decision, deterministic render.

Part 2 — three creator formats the skill lacked: reaction+demo hard cut,
'no yapping' silent split-screen tutorial, greenscreen reaction.

SKILL.md routes to it from Generating Ad Visuals; description gains UGC/
reaction/greenscreen/no-yapping/TikTok-Reels triggers (redundant ones
trimmed under 1024). New eval (id 12). Cross-links video skill.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-22 08:35:18 -07:00
Corey Haines e641a94087 Merge pull request #494 from coreyhaines31/main
sync: main -> development after 2.10.0 release
2026-07-27 12:00:31 -07:00
6 changed files with 114 additions and 5 deletions
+1 -1
View File
@@ -6,7 +6,7 @@
},
"metadata": {
"description": "Marketing skills for AI agents — conversion optimization, copywriting, SEO, paid ads, and growth",
"version": "2.10.2",
"version": "2.10.3",
"repository": "https://github.com/coreyhaines31/marketingskills"
},
"plugins": [
+1 -1
View File
@@ -1,7 +1,7 @@
{
"name": "marketing-skills",
"description": "Marketing skills for AI agents — conversion optimization, copywriting, SEO, paid ads, ad creative, and growth",
"version": "2.10.2",
"version": "2.10.3",
"author": {
"name": "Corey Haines"
},
+5 -1
View File
@@ -5,7 +5,7 @@ Current versions of all skills. Agents can compare against local versions to che
| Skill | Version | Last Updated |
|-------|---------|--------------|
| ab-testing | 2.0.0 | 2026-05-05 |
| ad-creative | 2.8.0 | 2026-07-14 |
| ad-creative | 2.8.1 | 2026-08-22 |
| ai-seo | 2.4.0 | 2026-08-21 |
| analytics | 2.0.1 | 2026-07-22 |
| aso | 2.0.1 | 2026-08-19 |
@@ -56,6 +56,10 @@ Current versions of all skills. Agents can compare against local versions to che
## Recent Changes
### 2.10.3 (2026-08-22)
- **ad-creative** (2.8.0 → 2.8.1): new `references/short-form-video-specs.md` — the vertical-video production spec + a creator-format library, distilled from Daniel Hangan's `reelclaw-templates` (built on HeyGen's HyperFrames; patterns credited, no code vendored). **Part 1, the spec, applies to every 9:16 video the skill makes** (iMessage reveals, motion ads, and the creator formats): the cross-platform safe-zone band (TikTok∩IG Reels worst case — 220px top / 500px bottom / 180px sides → a 720×1200 centered text-safe area, the single most-missed constraint), the classic TikTok caption recipe (white fill + black `paint-order` stroke, no background pill), static-caption auto-sizing (~58px shrinking in 2px steps to a 26px floor, re-fit after `document.fonts.ready`), audio defaults with the **organic-vs-baked-music decision** (attach the trending sound in-app for organic reach; bake music only for ads / where native sound can't attach; fade the last ~0.8s), and the deterministic-render contract. **Part 2 is three creator/UGC formats** the skill didn't document — Reaction + Demo (hard cut), "No Yapping" silent split-screen tutorial, and Greenscreen Reaction — each as a reusable structure with when-to-use and mechanics. SKILL.md's Generating Ad Visuals section routes to it (load before producing any vertical video) and the description gains 'UGC ad' / 'reaction ad' / 'greenscreen ad' / 'no yapping split-screen video' / 'TikTok/Reels ad format' triggers (older redundant triggers trimmed to stay within the 1024-char limit). New eval (id 12) covers the format + safe-zone + organic-music decision in one prompt. Cross-links to the `video` skill for framework/render choices.
### 2.10.2 (2026-08-21)
- **ai-seo** (2.3.0 → 2.4.0): new `references/agent-readiness.md` — the access/discovery/parseability layer beneath all content work: can an agent reach, navigate, and parse the site at all. Anchored on the two free scoring tools that shipped in Aug 2026 and made this measurable — **Is Agentic** (Vercel + Ora; `npx is-agentic`; 100+ checks with essential/recommended/bonus tiers, not-applicable excluded rather than failed, plus an observed agent journey) and **Frase's Agent Readiness Checker** (access/discovery/parseability triad with 80/60 score bands) — both credited, with the checks treated as the value rather than the vendor pitch. Covers the access essentials (core content in initial HTML — most agents never run JavaScript; no bot-challenge/firewall blocks on AI crawlers; correct HTTP behavior), the discovery file stack (robots.txt with an explicit AI-crawler stance, clean sitemap, llms.txt plus the newer **`llms-full.txt`** whole-site-in-one-request companion, robots content-usage statements), and the newest parseability technique: a **Markdown representation of every page**, served either by content negotiation (`Accept: text/markdown` at the same canonical URL with a `Vary` header) or an HTTP `Link` header pointing at a parallel Markdown version. Introduces the **agent-actionable** frontier (WebMCP — pages declaring forms/CTAs as callable tools; labeled emerging) with the practical-today floor (highest-intent actions work without JS-only flows). Adds a **citation-source volatility** section built on the Aug 2026 case study — ChatGPT's query fan-out changes nearly wiped Reddit as a citation source within days (practitioner-reported, Ashni of Hype Partners (@ashnichrist) and others), while business-owned sites dominate Gemini citations (~60%) — with the strategy consequences: portfolio over single-surface concentration, owned-site fundamentals as the volatility hedge, citation-share stats treated as dated snapshots verified against your own monitoring, and ~24-hour citation speed as the freshness upside. SKILL.md updates the Reddit lines in the Presence pillar with the volatility flag, points Machine-Readable Files at the new reference, and adds 'agent readiness' / 'is my site agent-ready' / 'llms-full.txt' / 'WebMCP' triggers. New eval (id 9) covers the two-sided prompt: an agent-readiness audit plus a Reddit-concentrated strategy that must get the volatility warning.
+4 -2
View File
@@ -1,8 +1,8 @@
---
name: ad-creative
description: "When the user wants to generate, iterate, or scale ad creative — headlines, descriptions, primary text, or full ad variations — for any paid advertising platform. Also use when the user mentions 'ad copy variations,' 'ad creative,' 'generate headlines,' 'RSA headlines,' 'bulk ad copy,' 'ad iterations,' 'creative testing,' 'ad performance optimization,' 'write me some ads,' 'Facebook ad copy,' 'Google ad headlines,' 'LinkedIn ad text,' 'static ads,' 'static ad concepts,' 'ad templates,' 'iMessage ad,' 'chat reveal ad,' 'fake DM ad,' 'ChatGPT ad,' 'Apple Notes ad,' 'AirDrop ad,' 'creative strategy,' 'creative roadmap,' 'creative retro,' 'hook writing,' 'creative review page,' 'present ad creative for approval,' 'motion video ad,' 'faceless video ad,' 'animated explainer ad,' 'motion collage ad,' or 'I need more ad variations.' Use this whenever someone needs to produce ad copy at scale or iterate on existing ads. For campaign strategy and targeting, see ads. For landing page copy, see copywriting."
description: "When the user wants to generate, iterate, or scale ad creative — headlines, descriptions, primary text, or full ad variations — for any paid advertising platform. Also use when the user mentions 'ad copy variations,' 'ad creative,' 'generate headlines,' 'RSA headlines,' 'bulk ad copy,' 'ad iterations,' 'creative testing,' 'write me some ads,' 'Facebook ad copy,' 'Google ad headlines,' 'LinkedIn ad text,' 'static ads,' 'ad templates,' 'iMessage ad,' 'chat reveal ad,' 'ChatGPT ad,' 'Apple Notes ad,' 'AirDrop ad,' 'creative strategy,' 'creative roadmap,' 'creative retro,' 'hook writing,' 'creative review page,' 'present ad creative for approval,' 'motion video ad,' 'faceless video ad,' 'UGC ad,' 'reaction ad,' 'greenscreen ad,' 'no yapping split-screen video,' 'TikTok/Reels ad format,' or 'I need more ad variations.' Use this whenever someone needs to produce ad copy at scale or iterate on existing ads. For campaign strategy and targeting, see ads. For landing page copy, see copywriting."
metadata:
version: 2.8.0
version: 2.8.1
---
# Ad Creative
@@ -157,6 +157,8 @@ For detailed specs and format variations, see [references/platform-specs.md](ref
**For faceless motion-style video ads** — fully generated 15–45s concept/explainer videos (styled poster stills → image-to-video "living" motion → TTS narration → word-timed captions; roughly $3–6 and ~15 minutes per finished video) — see [references/motion-video-ads.md](references/motion-video-ads.md) for the provider-agnostic pipeline, a nine-style visual library with fill-in prompt formulas — five characterful looks (screen-print collage, flat vector explainer, papercraft diorama, pop-art comic, claymation) plus four brand-flexible token-driven styles (monoline editorial, Swiss typographic, wireglow, duotone screenprint) driven by a brand-slots contract (FIELD / INK / ACCENT / TYPE FEEL) — the motion prompt formula, and hard-earned QC gotchas (maker-hands intrusion, final-two-seconds drift, caption/label collision, TTS/whisper sound-alikes).
**For creator/UGC short-form video** — reaction+demo hard cuts, "no yapping" silent split-screen tutorials, and greenscreen reactions for TikTok/Reels/Shorts growth content — see [references/short-form-video-specs.md](references/short-form-video-specs.md). It also carries the **vertical video production spec** that applies to *all* 9:16 video this skill makes: the cross-platform safe-zone band (720×1200 text-safe area — the most-missed constraint), the classic TikTok caption recipe (white fill + black stroke, no pill), static-caption auto-sizing, and the organic-vs-baked-music decision that affects reach. Load it before producing any vertical video.
For image and video generation tools, see [references/generative-tools.md](references/generative-tools.md) for the complete guide covering:
- **Image generation** — Nano Banana Pro (Gemini), Flux, Ideogram for static ad images
+12
View File
@@ -159,6 +159,18 @@
"Applies the family grounding/disclosure rules (dramatized share, substantiated claims, not a real endorsement)"
],
"files": []
},
{
"id": 12,
"prompt": "We're a mobile app and want to make TikTok/Reels ads. Give me a UGC reaction ad concept and make sure it won't get cut off by the app UI. Also — should we add music?",
"expected_output": "Should load references/short-form-video-specs.md and deliver both the format and the spec. Format: the Reaction + Demo hard-cut structure (creator reaction ~3s with a hook caption written as inner monologue, hard cut to the app demo, optional payoff caption) — may also mention the other two creator formats (no-yapping split-screen, greenscreen reaction) as alternatives. Safe zone: keep all captions/key visuals inside the 720x1200 centered safe band (220px top / 500px bottom / 180px sides clear) so platform UI doesn't cover them, and use the static white-fill/black-stroke caption style that auto-sizes to fit. Music: give the organic-vs-baked decision — for organic posting, export without baked music and attach the trending sound in-app (algorithm reward); bake music only for paid ads or where native sound can't be attached, fading out the last ~0.8s.",
"assertions": [
"Provides the reaction+demo hard-cut structure with the hook caption as the reaction's inner monologue",
"Specifies the cross-platform safe band (roughly 220 top / 500 bottom / 180 sides, or the 720x1200 text-safe area) so captions aren't covered by platform UI",
"Describes the static white-fill/black-stroke caption style with auto-sizing (no animated captions)",
"Gives the organic-vs-baked-music decision rather than a blanket yes/no (attach trending sound in-app for organic; bake for ads)"
],
"files": []
}
]
}
@@ -0,0 +1,91 @@
# Short-Form Vertical Video — Production Spec & Creator Formats
The platform-craft layer beneath any 9:16 video for TikTok, Reels, or Shorts — the constraints that decide whether a good idea survives contact with the feed — plus three creator/UGC format recipes that consistently perform for growth content.
Part 1 (the spec) applies to **every** vertical video this skill produces — the iMessage reveals in [imessage-video-ads.md](imessage-video-ads.md), the motion ads in [motion-video-ads.md](motion-video-ads.md), and the creator formats below. Part 2 is the format library.
---
## Part 1 — The Vertical Video Spec
### Canvas
- **1080×1920 (9:16), 30fps, MP4.** Footage of any resolution/orientation is center-cropped to fill (`object-fit: cover`) — mixed source resolutions are fine.
### Safe zones (the single most-missed constraint)
Platform UI covers the frame edges — the action rail, caption stack, music button, and account row all sit *on top of* your video. Text or key visuals in those bands get covered. Keep everything inside the **cross-platform safe band** — the worst case of TikTok and IG Reels margins on a 1080×1920 canvas:
| Edge | Keep clear | Why |
|---|---|---|
| **Top** | 220px | TikTok tabs + IG account row |
| **Bottom** | 500px | Caption / music / CTA stack (both platforms) |
| **Left** | 180px | Symmetry with right |
| **Right** | 180px | Action rail (like/comment/share/music) |
**Result: a 720×1200 centered text band, from y=220 to y=1420.** Compose all captions and load-bearing visuals inside it. Preview against a safe-zone overlay before a big push. (These numbers drift with app updates — re-verify occasionally; they're a well-sourced worst-case, not a permanent law.)
### Caption style (classic TikTok)
White fill, black outline, **no background pill** — the native look that reads as organic, not as an ad:
```css
color: #fff;
font-family: "TikTok Sans", sans-serif; /* or a close variable sans; embed it, don't assume it's installed */
font-weight: 700;
paint-order: stroke fill; /* stroke behind fill — keeps glyphs crisp */
-webkit-text-stroke: 8px #000;
text-shadow: 0 2px 10px rgba(0, 0, 0, 0.35);
```
- **Captions are static** — no entrance/exit transitions. A caption is at full visibility on the first frame of its window, and its window matches its video segment exactly (same start, same end). Animated captions read as "made by a brand."
- **Auto-size to fit the band.** Start at ~58px and shrink in ~2px steps until the text fits the safe band (fit box ~1150px tall), floor ~26px. Never overflow the band, never clip mid-glyph. Long wall-of-text hooks are a *supported* input, not a failure case — they just shrink. Re-measure after the font actually loads (`document.fonts.ready`) so sizing uses the real face, not a fallback.
### Audio defaults (and the organic-vs-baked decision)
- **Mute clip audio by default; let one music track carry the sound.** Per-clip audio is opt-in (e.g., keep a creator's voice at full, mute B-roll).
- **Fade music out over the final ~0.8s** — a hard cut to silence reads as broken.
- **The organic call:** for organic TikTok/Reels, often post **without baked-in music** and attach the trending sound *in-app* — the platform's algorithm rewards native/trending audio, and an in-app sound is discoverable/attachable by others. **Bake the music in** for paid ads and anywhere you can't attach a native sound (some cross-posting, some platforms). This one decision meaningfully affects organic reach.
### Determinism (if you generate programmatically)
Renders must be reproducible: no clocks (`Date.now()`), no `Math.random()`, no network fetches at render time. Same inputs → same MP4, every time. (Applies whether you're on Remotion, HyperFrames, or an ffmpeg pipeline — see the `video` skill for framework choice.)
---
## Part 2 — Creator Format Library
Three UGC-driven short-form formats that reliably perform for growth. Each is a *structure*, not a script — feed it your own footage and hook. All obey Part 1.
### Format 1 — Reaction + Demo (hard cut)
**Shape:** creator reaction clip with a hook caption → **hard cut** to an app/product demo screen recording. ~9–12s total.
```
[ reaction · ~3s · hook caption ] → [ demo · full length · optional payoff caption ]
```
- **When:** you have (or can get) a genuine-feeling creator reaction and a crisp demo. The workhorse UGC format for apps/tools.
- **The hook caption** rides the reaction segment and does all the selling — it's the ad. Write it as the reaction's inner monologue ("i was about to hit it and this app talked me out of it"), not a product claim.
- **The hard cut is the mechanic** — no transition. Reaction earns attention, cut delivers the payoff. Optional second caption on the demo lands the result ("12/12 cravings resisted").
- Sourcing: real UGC reactions are the input bottleneck; the format is only as good as the reaction's authenticity.
### Format 2 — "No Yapping" Split-Screen Tutorial
**Shape:** silent, fast tutorial. Fullscreen intro → **50/50 split** (typing/action on one half, live result on the other), step captions at the seam. The "…but no yapping" promise = pure value, no talking.
```
[ intro · fullscreen · hook ] → [ split: input | output · ordered step captions at the seam ]
```
- **When:** a how-to where *showing* beats *narrating* — setup flows, prompt walkthroughs, tool tutorials. The silence is the selling point (people watch muted; "no yapping" filters for high-intent).
- **Captions carry the steps** — ordered, static, one per beat, placed at the split seam so both halves stay visible. Auto-size per Part 1.
- No voiceover; music-only (see the organic-sound note). Pace tight — dead air kills retention.
### Format 3 — Greenscreen Reaction
**Shape:** one video plays fullscreen; the creator is **cut out of their background** (greenscreen/segmentation) and composited on top — reacting to or narrating over the underlying content. Optionally start centered, then shrink/drag into a corner so the underlying video takes over.
```
[ fullscreen video (e.g. a screen recording / another post) + creator cutout overlay · optional hook text ]
```
- **When:** reacting to a competitor's post, a trend, a screen recording, or your own product — the TikTok-native "let me react to this" format. Reads as commentary, which the algorithm and audience treat as organic.
- **Both soundtracks can coexist** (underlying video + creator), unlike the mute-by-default rule — the reaction voice is the point here.
- The corner-drag move (creator starts big to establish presence, then shrinks to let the content breathe) is the signature beat.
---
*Vertical-video spec (safe-zone band, caption recipe, auto-sizing, organic-vs-baked audio) and the three creator formats are distilled from Daniel Hangan's `reelclaw-templates` (built on HeyGen's HyperFrames; TikTok Sans redistributed under SIL OFL 1.1) — patterns credited, no code vendored. Safe-zone numbers are a cross-platform worst case; re-verify against current app UI. For framework/tooling choices to actually render these, see the `video` skill.*