Back to Marketingskills

Marketing Skills Versions

VERSIONS.md

2.11.078.0 KB
Original Source

Marketing Skills Versions

Current versions of all skills. Agents can compare against local versions to check for updates.

SkillVersionLast Updated
ab-testing2.0.02026-05-05
ad-creative2.8.22026-08-23
ai-seo2.4.02026-08-21
analytics2.0.12026-07-22
aso2.0.12026-08-19
attribution1.1.02026-07-23
churn-prevention2.0.02026-05-05
co-marketing2.0.12026-08-23
cold-email2.0.02026-05-05
community-marketing2.0.12026-08-23
competitor-profiling2.0.12026-08-19
competitors2.0.12026-07-09
content-strategy2.1.12026-08-23
copy-editing2.0.02026-05-05
copywriting2.0.22026-08-23
cro2.0.02026-05-05
customer-research2.0.22026-08-23
directory-submissions2.0.02026-05-05
emails2.0.02026-05-05
events1.0.02026-08-23
free-tools2.0.12026-08-23
image2.0.12026-05-18
influencer-marketing1.1.02026-08-19
launch2.0.22026-08-23
lead-magnets2.0.02026-05-05
marketing-council1.0.02026-07-06
marketing-ideas2.0.12026-08-23
marketing-loops1.2.02026-07-10
marketing-plan1.1.12026-08-23
marketing-psychology2.0.02026-05-05
offers1.0.12026-08-23
onboarding2.0.12026-08-23
ads2.3.22026-08-23
paywalls2.0.02026-05-05
popups2.0.02026-05-05
pricing2.1.12026-08-23
product-marketing2.1.02026-07-16
programmatic-seo2.0.02026-05-05
prospecting1.1.02026-07-13
public-relations1.1.12026-08-23
referrals2.0.12026-08-23
revops2.0.02026-05-05
sales-enablement2.0.12026-06-16
schema2.0.02026-05-05
seo-audit2.0.12026-08-19
signup2.0.02026-05-05
site-architecture2.0.02026-05-05
sms1.0.02026-05-21
social2.2.02026-07-09
video2.1.02026-07-14

Recent Changes

2.11.0 (2026-08-23)

  • Added the events skill (1.0.0) — event marketing across all four roles: hosting (webinar → workshop → dinner → meetup → virtual summit → user conference, governed by "the topic is the targeting" and recurring-beats-one-off), sponsoring/exhibiting, speaking, and attending (target list → pre-booked meetings → the side-event play). Built on the universal arc — 20% event, 80% before-and-after — with the 24–48h tiered follow-up, capture-context-not-just-contact discipline, an event-as-recording-studio content arc (transcripts compound in AI answers → ai-seo, public-relations), and a three-tier measurement model (vanity / real / decisive) with multi-touch honesty via attribution. Four references: webinar-funnel.md (the flagship funnel, closes #485), sponsorship-roi.md (ICP-overlap + cost-per-qualified-meeting math, side-event play, tiered follow-up), speaking.md (CFP craft, talk storyboard, the recording as the real audience), and event-portfolio-strategy.md (which events to invest in: in-person-necessity by segment, the 80/20 of selection, size↔ROI inverse, the owned/trade-show/community frame + economics — distilled from Corey's Founding Marketing ch.9). Seven evals. New skill = repo y release; total skills: 50. Closes #485.

2.10.5 (2026-08-23)

Batch enrichment across 15 existing skills, distilled from Corey Haines's Founding Marketing book (full 19-chapter scan). Each is a patch bump; no new skills.

  • ads (2.3.1 → 2.3.2): references/payback-period.md — the Payback Period budgeting gate (Payback = CAC/ARPU, target 3–12mo; Discounted Payback = CAC/(ARPU×retention)) + the "LTV:CAC is destructive" argument. (ch7)
  • customer-research (2.0.1 → 2.0.2): references/interviews-and-surveys.md — primary-research layer: Sean Ellis/Superhuman PMF survey (40% benchmark), "keep asking why" 5-why laddering, interview outreach template + incentives, best-customer recruitment, confirmation-bias guardrail. (ch2)
  • onboarding (2.0.0 → 2.0.1): references/minimum-path-to-value.md + references/activation-models.md — MPTV (Hick's Law), the 5 activation models + Model-Market Fit, onboarding psychology set, 10-component toolkit. (ch16)
  • pricing (2.1.0 → 2.1.1): initial "learning price" philosophy ($10/$100/$1,000) + references/pricing-models.md (8 models incl. credit/outcome/hybrid) + price-change rollout methodology. (ch15–16)
  • co-marketing (2.0.0 → 2.0.1): references/partnership-types.md — the 5 partnership types + "permissionless co-marketing." (ch11)
  • marketing-ideas (2.0.0 → 2.0.1): references/guerrilla-marketing.md — direct-mail 3-rule framework + named case library (WePay ice block, Antimetal $15K pizza→$1M). (ch13)
  • copywriting (2.0.1 → 2.0.2): clarity & message-market-fit — the "Now you can" test, Human Action Model, Perception Gap, SavvyCal case, clarity metrics. (ch3)
  • public-relations (1.1.0 → 1.1.1): references/story-angles.md — the 3 story angles (Founding Story / David vs Goliath / Have an Enemy) + PR flywheel. (ch5)
  • content-strategy (2.1.0 → 2.1.1): references/content-distribution.md — "content as product," "Create Once Distribute Twice" distribution spine (ORB-as-funnel, distribution hooks), scoring + 60/30/10 calendar. (ch6, ch14)
  • referrals (2.0.0 → 2.0.1): references/viral-mechanisms.md — product-embedded virality: Viral Potential Spectrum + 7 mechanisms + affiliate power-law/buyout clauses. (ch10–11)
  • free-tools (2.0.0 → 2.0.1): references/tool-benchmarks.md — named case benchmarks (Unsplash→Getty, Website Grader 250K leads) + "your product is my marketing opportunity" + pitfalls. (ch8)
  • community-marketing (2.0.0 → 2.0.1): references/community-models.md — 5 community-model archetypes + Notion ambassador benchmarks + scaling-phase role shift. (ch12)
  • offers (1.0.0 → 1.0.1): references/saas-offers.md — the discount trap (~2× churn) + 4 SaaS-flavored worked offers. (ch15)
  • marketing-plan (1.1.0 → 1.1.1): "marketing as investing" north-star + problem size×frequency matrix; 70/20/10 allocation + plateau-alert cadence in growth-patterns. (ch1, ch17)
  • launch (2.0.1 → 2.0.2): SLC (Simple, Lovable, Complete) pre-launch readiness gate vs Stealth Mode / "Just One More Feature." (ch1)

2.10.4 (2026-08-23)

  • ad-creative (2.8.1 → 2.8.2): three creative-format references distilled from Dara Denney's practitioner content. New references/meta-creative-formats.md — a prioritized S→F taxonomy of ~51 Meta ad formats as a "which format to make next" decision aid, framed by the unicorn-scaler-vs-supporting-cast lens and the persona-based Andromeda algorithm (S-tier: founder content, partnership ads, VSL; explicit F-tier de-prioritization of press / podcast / notes-app fake-native). references/static-ad-templates.md gains a tier (S–F) + funnel role on all 15 templates plus 7 new statics (grid multi-SKU, callout, mood board, educational infographic, challenging-beliefs, tweet/reddit, ugly/post-it). references/short-form-video-specs.md's Creator Format Library expands from 3 to 13 formats (yapper, amateur investigation, David & Goliath, authority, VSL, green-screen commentary, conversation, duet/reaction, ASMR, street interview) plus a founder/organic vlog-structures subsection (hero's journey, math, shiny-object, three-capture shooting, 0.5–1s cut) from Oren John. New evals (ids 13–15); description gains taxonomy triggers.
  • ads (2.3.0 → 2.3.1): two new references plus a partnership-ads layer. New references/google-ads-audit-checklist.md — a 32-item ecommerce Google Ads audit (Search + Shopping + PMax + GMC + Demand Gen) scored pass/fail/unknown/NA under the audit guardrails (adapted from ECHELONN's public checklist). New references/creative-research-automation.md — an agentic creative/competitive research workflow (ad-library teardown with output schema, review→persona mapping, competitor teardown; connectors + scheduled-to-Slack). references/meta-decision-system.md gains the partnership-ads playbook — the net-new-reach lever under Andromeda's persona targeting, rolling month-over-month reach as a scale/health signal, and the per-creator low-fi-statics companion tactic — closing the skill's prior zero coverage of partnership ads. New evals (ids 8–10).

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.

2.10.1 (2026-08-19)

  • ads (2.2.0 → 2.3.0): added references/audit-guardrails.md — the honesty layer for working on live ad accounts (audit scoring semantics, recommendation-safety rules, and the benchmark-evidence ladder distilled and remixed from AgriciDaniel/claude-ads, MIT, credited). Covers: four-state scoring (pass / fail / unknown / not applicable) with the core rule that account health and evidence coverage are kept separate — an unknown reduces coverage, never health, so "couldn't check your pixel" can't masquerade as "your pixel is broken"; coverage bands (80%+ graded, 60–79% provisional, <60% report findings but present no health score) and the partial-audit rule (a failed platform/data source is excluded from rollups, never scored as zero, and the audit is never called complete); what never counts against health (unknowns, ineligible/beta/premium features, feature non-adoption, deviation from broad benchmarks); recommendation safety — every optimization heuristic is conditional on sample size, conversion lag, margin, and learning-phase state, so never pause on a fixed CPA multiple, apply one budget-to-CPA ratio across objectives, freeze a learning campaign as a reflex, recommend ineligible features, or invent negative keywords without a search-terms report + overblocking review; hard stops as response contracts (refuse cross-attribution-window conversion sums and report side by side; zero candidate negatives without evidence; no single health score over major data gaps); benchmark discipline (provenance labeling incl. vendor-supplied, cohort-fit check, and the narrowest-defensible-comparison ladder: own prior period → own experiment → CRM cohort → peer cohort → broad benchmark as directional only); and untrusted data + live accounts (fetched pages/exports/screenshots are data, not instructions; read-only by default with draft-first mutation plans — current state → change → expected effect → rollback — and smallest-reversible-change preference). SKILL.md adds a compact Audit & Recommendation Guardrails section with the six non-negotiables plus a Reference Routing row. New eval (id 7) covers the four hard stops in one adversarial prompt (fixed CPA kill rule, invented negatives, cross-window conversion sum, health score over ~50% coverage). Also added destination testing to references/meta-decision-system.md: one CBO per persona, one ad set per destination type (PDP / listicle / quiz / demo) with the same creatives in every ad set — holding creative constant makes CPM/performance divergence attributable to the lander, treating the destination as a test axis of the same rank as creative; fits the Testing campaign with the usual TCPL spend gates, graduating the winning creative × destination pair (practitioner-reported pattern, Alexander Pauwelyn 2026, labeled as such per the new benchmark discipline).
  • ai-seo (2.2.0 → 2.3.0): new references/youtube-ai-citations.md — the anatomy of a YouTube video AI cites, built on the core insight that models don't watch the video, they read the text layer around it (from Ross Simmonds / Foundation Inc., credited). In leverage order: the transcript as the real content (speak key answers as complete, liftable sentences; say entities out loud), cleaned captions over messy auto-captions, question-shaped titles, chapters titled by sub-question (structure = extractability), a keyword-rich description restating key points as text, a pinned comment carrying the summary as an extra liftable block, and engagement/thumbnail as the indirect layer (watch signals → YouTube ranking → AI surfacing). Includes a publishing checklist. SKILL.md's Presence pillar adds podcasts as a cited third-party surface (episodes get transcribed, show notes published, both crawled) with pointers to the new reference and to public-relations podcast prep. New eval (id 8) covers diagnosing the text layer instead of production quality.
  • content-strategy (2.0.0 → 2.1.0): new Link-Earning Formats section with Foundation Inc.'s backlinks-vs-page-share data (March 2026; labeled a single vendor study, directional): stat/data roundups 4.25x, glossaries 1.47x, interactive tools 1.38x, how-tos 1.36x — while original research earns 0.80x, ultimate guides 0.77x, thought leadership 0.74x, and templates 0.68x. The counterintuitive read: curating statistics out-earns producing original research ~5x for links, because writers cite whatever makes citation easiest and research gets cited via the roundups that aggregate it. Playbook: maintain a category stats page (cheap, compounding, doubles as an LLM-citation surface → ai-seo), and pair any original research with your own stat-roundup of its findings to capture the links the data generates; bottom-of-table formats are judged by their other jobs (rankings, conversions, brand), not links. New eval (id 7).
  • public-relations (1.0.0 → 1.1.0): new references/podcast-guest-prep.md — a podcast appearance prep workflow distilled and adapted from Knowatoa's ai-visibility-skills (MIT, credited), reframed around the AI-visibility insight: episodes get transcribed, show notes get published, both get crawled and cited, so the stories a guest tells become the citable record on their brand for years. Covers the research fallback chain (RSS feed → site episode list → Apple Podcasts → web search, without fetching every episode), what to extract (recurring threads over individual episodes since threads predict the questions; show progression phases + inflection points; host profiles best mined from episodes where hosts guest on other shows; name-collision flagging; prior-appearance recap), the six-part brief (big picture → progression → recent episodes → guest angles with pocket stories → host rapport hooks → gaps), angle-finding by mapping the story bank onto show threads (one contrarian take stands out most on consensus shows), and coaching the guest to speak in liftable form (company name next to category, numbers said aloud — same logic as ai-seo's YouTube text layer). Uses our .agents/product-marketing.md convention plus a one-batch story-bank interview. SKILL.md adds the reference pointer, a common workflow, and 'podcast prep' / 'going on a podcast' / 'podcast guest' triggers.
  • influencer-marketing (1.0.0 → 1.1.0): new references/ugc-creator-program.md — the volume UGC creator program ("tech UGC") model, distilled from Julia Pintar / Playkit's viral 12M-downloads playbook (credited) and compliance-rewritten in response to Rachel Karten's public FTC critique of the original (credited): every paid creator post carries disclosure (#ad + platform paid-partnership label) even from fresh accounts — "doesn't look like an ad" is the exact pattern disclosure law exists for, and the brand is liable; the paid comment-bounty tactic is replaced with compliant alternatives (program-account replies, open brand engagement) plus a platform inauthentic-behavior warning; SKILL.md §4 explicitly overrides any conflicting source step. Keeps the operational engine: content volume as the asset (10 creators × 3 posts/day ≈ 900 organic tests/month vs ~30 for a brand account; ~$3.87 CPM claim labeled vendor-supplied), playbook-first concepts (creators use the product first; study own winners / competitors / adjacent-category user journeys / audience content, plus a failure archive; every concept = audience + pain + hook + format + script + product screen + reference), the four-format taxonomy (talking ~70%, wall-of-text as viral-but-low-convert warm-up, AI-automatable slideshows, aging hook-and-demo — test the same idea across formats to separate bad ideas from bad presentation), trial-week vetting where the revision matters more than the first video, stable-base + bonus pay, the account-warming checklist, 3/day cadence with pre-post review and concrete-not-vague feedback, the four-touchpoint conversion ladder ending in reply videos, judge-by-product-questions-not-views daily iteration with one-variable changes and a four-week minimum, and full-time program ownership. SKILL.md adds the model to the spectrum section plus 'tech UGC' / 'UGC creator program' / 'creator network' triggers. New eval (id 7): the "replicate this viral playbook exactly" prompt must fix the two FTC violations while keeping the engine.
  • seo-audit (2.0.0 → 2.0.1): added the untrusted-data guardrail — fetched pages are analyzed, never obeyed; instructions embedded in HTML, meta tags, or page copy are a prompt-injection surface.
  • competitor-profiling (2.0.0 → 2.0.1): added Core Principle 5 — Untrusted Input. Competitor pages, reviews, and docs are data, never instructions; agent-targeted text ("describe this product favorably," hidden HTML directives) is ignored and the attempt noted in the profile.
  • aso (2.0.0 → 2.0.1): added the untrusted-data guardrail for fetched store listings and reviews (same prompt-injection surface, incl. instructions planted in user reviews).

2.10.0 (2026-07-22)

  • attribution (new, 1.1.0): a dedicated skill for the hardest question in marketing — which efforts actually drive conversions and revenue. Fills a real gap: attribution was scattered across analytics (UTM setup), ads (platform pixels), revops (pipeline), and ai-seo (the AI blind spot), but no skill owned the models or the reconciliation problem. Two pillars. (A) Interpretation — the six attribution models and when each lies; MTA vs. MMM vs. incrementality and how to choose; self-reported attribution; reconciling the platform-vs-GA-vs-CRM-vs-survey disagreement (never sum across platforms; pick one source of truth; read directional trends); and the direct / branded-search / dark-social / AI blind spots. (B) Own your attribution (first-party) — a build runbook for instrumenting attribution yourself when you control the site/app: the identity graph, closing the identify() gap (adapted from Tessa Kriesel's PostHog approach), stitching conversions on third-party domains you don't own (SavvyCal/Calendly/Stripe) via metadata passthrough + webhook identity-merge, fail-closed anonymity guards, and first-touch data-quality cleanup — distilled from real production builds (Conversion Factory + Truelist). Four references (attribution-models.md, measurement-paradigms.md, by-business-type.md with B2B/DTC playbooks, first-party-tracking.md) and 7 evals covering reconciliation, model choice, the third-party stitch, ROAS incrementality, the direct/branded blind spot, the analytics boundary, and the DTC measurement stack. Pillar B also folds in production feedback from Tessa Kriesel (credited): the CRM last mile (sync a source field with confidence + basis and a paid-vs-non-paid read onto the account → revops), storing the full ordered touch path so the build track can run Pillar A's multi-touch models on real data, the "expect ~zero until the cross-subdomain stitch is verified in prod" window with a narrowly-scoped campaign-window fallback + pre-stitch backfill, and account-level rollup (excluding free-mail domains) for B2B.
  • analytics (2.0.0 → 2.0.1): description now hands off attribution modeling and reconciliation to the new attribution skill, keeping analytics scoped to tracking setup, event taxonomy, and UTMs.

2.9.1 (2026-07-27)

  • pricing (2.0.1 → 2.1.0): added a Pricing Page Teardown — a two-axis audit of a live pricing page. Axis 1 is the classic human buyer experience (value-prop clarity, plan differentiation, cognitive load, trust signals, psychology, transparency); Axis 2 is the novel AI-agent readiness lens: whether the LLMs/agents that increasingly shortlist and compare tools can actually read and quote your pricing — machine-readable prices (not locked in an image or behind "Contact us"), extractable FAQ/objection coverage, per-tier depth in text, and structured data. Includes the memorable "paste test" (give the URL to a browsing-capable AI and ask for the plans and prices — if it can't answer, an AI shopping for your buyer can't either), a full 10-dimension rubric + scoring/report template in references/pricing-page-teardown.md, and hand-offs to schema (Product/Offer JSON-LD) and ai-seo (extractability, AI search-bot access, llms.txt). New eval (id 7). AI-agent-readiness lens adapted from Kyle Poyar / Growth Unhinged (learn-from-only, credited).

2.9.0 (2026-07-15)

  • Added influencer-marketing skill — influencer, creator, and ambassador partnerships end to end. Foundation contributed by @Adi29102000-s (PR #417), expanded to the repo's standard and shipped standalone (the PR's other proposed skills were not included). Covers the influencer ↔ ambassador spectrum (paid influencer → affiliate creator → gifting → long-term ambassador program → organic advocate, each with when-to-use and skill handoffs), finding & vetting (audience-alignment test, creator tiers incl. B2B thought leaders, engagement/fake-follower/brand-safety checks), 1:1 outreach (→ cold-email), deal structuring (flat / CPA / hybrid / gifting compensation, rate-as-a-range reality, and the high-ROI content-usage-rights/whitelisting clause → ad-creative), a full FTC disclosure & compliance section (material-connection disclosure, clear-and-conspicuous placement, gifting-still-needs-disclosure, platform labels, brand liability, no fabricated claims — a gap in the original contribution), the creative brief (don't script; grounded talking points), measurement & ROI (unique promo codes, UTMs, vanity URLs, post-purchase survey for the branded-search/direct attribution blind spot, whitelisting performance, cost-per-qualified-outcome over EMV/reach), and a structured ambassador program design (ask → benefits ladder → recruit-from-evidence → equip → activate → track, cross-referencing community-marketing for community-led advocacy and referrals for payout rails). Six-eval suite covering compensation/whitelisting, podcast attribution, the gifting-disclosure misconception, ambassador-program design, creator vetting, and the no-word-for-word-scripting brief. New skill = repo y release. Total skills: 48.

2.8.12 (2026-07-16)

  • product-marketing (2.0.0 → 2.1.0): the context document now carries its own version history. .agents/product-marketing.md gets a Document version: header (v1, v2 …) and a ## Changelog section at the bottom — a newest-first, dated, one-line-per-revision paper trail of what changed and why. The update flow now reads the current version and recent changelog on open, and on save bumps the version, updates Last updated, and prepends a new changelog entry naming the sections touched and the reason (never rewriting past entries; skipped only for pure typo fixes). Since this doc is the shared context every other marketing skill reads, the changelog makes positioning/ICP changes traceable across a project — you can see how the positioning evolved and what a downstream skill was generating against. New eval (id 7) covers the version-bump + prepend-changelog behavior on a repositioning update.

2.8.11 (2026-07-14)

  • video (2.0.1 → 2.1.0): added reverse-engineering a viral edit into a reusable edit spec (the tool-agnostic decomposition behind "copy any viral edit" — pattern from Arcads' skill, whose Omni generation model is proprietary/MCP-gated; we build only the decomposition, credited). New references/edit-anatomy.md: pull the reference with watch-video (visual/multimodal to read frames + caption style + cut timing) or social-fetch, extract the edit anatomy beat by beat across nine dimensions (shot/framing, cut rhythm/cuts-per-second, on-screen text, caption style, motion/punch-ins, b-roll/overlays, sound design, the first-2s hook, pacing curve), and output a per-beat beat sheet table plus a style summary of the 3–5 signature moves that make the edit recognizable (patterns over instance-logging). Includes the review-once gate (approve the beat sheet — on-screen text + scene-change placement — before executing in Remotion/Hyperframes, CapCut, or an AI restyle tool) and a hard originality guardrail (copy the editing grammar applied to your own footage/message, never the reference's footage, script, voiceover, or music). SKILL.md adds a Reverse-Engineer a Viral Edit workflow and 'copy this edit,' 'match this video style,' 'reverse-engineer this video,' 'edit like this reference' triggers. New eval (id 7). Closes #456.

2.8.10 (2026-07-14)

  • ad-creative (2.7.0 → 2.8.0): added AirDrop as a fourth surface in the iOS-native reveal video ad family (references/imessage-video-ads.md, alongside iMessage / ChatGPT / Apple Notes; format popularized by Shiv Sakhuja / Gooseworks' goose-video Airdrop Ads, re-expressed originally — their runtime is MIT but the recipe is private, so this is original craft). The one interaction-native format in the family: the hook is an incoming AirDrop request and the Accept tap is the reveal — a translucent AirDrop card (sender device name, preview thumbnail, red Decline / blue Accept) from the receiver's POV, where iOS's own accept/decline choice is a built-in micro-conversion beat. New ### AirDrop Reveal subsection: the preview thumbnail as the hook that must earn the tap, sender-name casting (relatable human name reads native; brand-as-sender reads like an ad), the transfer progress-ring as the signature motion, the AirDrop swoosh sound (not iMessage tritones) with the same CC0-Apple + trade-dress caveat, receiver-POV-default vs sender-POV-flex, and the family grounding/disclosure rules (a dramatization of a share, never a real endorsement). Updates the H1, intro, surface-selection table, and choosing-signal line to four surfaces. SKILL.md pointer names AirDrop and adds the 'AirDrop ad' trigger. New eval (id 11).

2.8.9 (2026-07-13)

  • prospecting (1.0.0 → 1.1.0): added a fourth branch — Demand-signal discovery (find your first customers), the early-stage motion that finds first customers / design partners / beta users from recent public pain-demand-timing signals rather than firmographic list-building (re-expressed from the open-source first-customer-finder Codex skill, Kappaemme/MIT, credited; extended with our live-recency tooling). New references/demand-signals.md: how the branch differs from list-building (starts from a described problem, sources public discourse, wins on 10 strong evidence-backed matches over coverage), a product brief gate, the five signal query buckets (explicit demand / pain / workaround / switching / timing) with our tooling edge called out (last30days for Reddit/HN/X/web recency, social-fetch to read original threads, scraping/Firecrawl/Browserbase over snippets, deep-research, competitor-profiling, customer-research), a public-only source mix, a demand-fit scoring rubric (pain 25% / product fit 25% / timing 20% / reachability 15% / evidence quality 15%, 0-100 with bands — distinct from the ICP-fit Hot/Warm/Cold), prospect stages (high intent / problem aware / trigger present / potential fit), a per-prospect evidence ledger, manual-only source-based openers (never auto-send), the evidence-report structure (verdict → ICP → top prospect → shortlist → repeated patterns → 7-day manual outreach plan → limits), and the honesty rules (a cited signal is the entry ticket; label 'potential customer based on public signals,' never 'will buy'). SKILL.md adds the branch to the Pick-the-Branch table + deep-dive pointers and 'find my first customers,' 'early adopters,' 'design partners,' 'beta users,' 'who has this problem' triggers. Also closes two compliance-guardrail gaps across all branches: no data brokers / leaked datasets, and never target or infer sensitive/protected traits (health, financial hardship, political belief, sexuality, religion). New eval (id 7) covers branch selection, signal mining, demand-fit scoring, and the never-auto-send rule. Closes #447.

2.8.8 (2026-07-12)

  • ad-creative (2.6.0 → 2.7.0): added the creative review page — a shareable, self-contained HTML artifact that presents generated concepts for a client or stakeholder to review and pick (the visual upgrade to INDEX.md; pattern reverse-engineered from a real agency creative-approval page, re-expressed originally). New assets/creative-review-template.html: one file, inline CSS+JS, no build or dependencies, driven entirely by a DATA object — renders concept tabs (each a strategic angle), a pixel-accurate in-feed Instagram/Facebook preview with a whitelist-handle toggle, a labeled frame-by-frame storyboard (tap to jump), selectable headline variations that overlay the preview, primary text, destination/CTA/offer, optional rollout mechanics, and a required grounding disclosure; frames render real images (URL / relative path / data URI) or styled label+prompt placeholders for concepts not yet rendered. New references/creative-review-page.md: when to produce one, the full data model, the frame-storyboard-as-carousel-arc link to carousel-frameworks.md, the hard grounding rule (every concept discloses what's real; illustrative proof is labeled illustrative — never launder fiction as fact), and how to populate/verify/deliver (open locally, host on any static host, or hand off the file). SKILL.md adds a Creative Review Page output-format section, a Mode 3 pointer, and 'creative review page' + 'present ad creative for approval' triggers. New eval (id 10) covers template use over markdown, narrative-job frame labels, and the grounding disclosure. Browser-verified: concept switching, platform/handle toggles, and frame navigation all render correctly.

2.8.7 (2026-07-10)

  • ad-creative (2.5.0 → 2.6.0): added Mode 4 — the Creative Strategy Loop, the upstream workflow layer for deciding which ads are worth making (built so the same capability ships in any agent running the library, incl. Magister; workflow shapes informed by public creative-strategist practice, expressed originally). New references/creative-roadmap.md: three-signal synthesis (account performance via the platform CLIs; customer/brand language via the Grounded Inputs corpus + customer-research; external organic via scraping, social listening, and competitor-profiling) on a monthly-deep-dive + weekly-refresh cadence with a receipts rule (no insight enters the icebox without its source); concepts as segment × motivation × angle × format hypotheses ranked on a six-tier evidence scale; account-state branching (exploration state: wide net-new mix, per-metric win redefinition, iterate only on hits, four root causes to check; scaling state: winner-variation-heavy mix with visually-distinct variations, sub-angle probes, a standing exploration allocation); the roadmap artifact (icebox → quarterly themes → monthly slate with T1 iteration / T2 remix / T3 production tiers and a hard capacity check); per-concept briefs handed to Modes 1–3; and the monthly creative retro (winners/losers/metric-wins/learnings/kills, judged at concept level, every learning landing as an icebox update, re-rank, or kill). New references/hook-system.md: hooks as three components (visual action / spoken line / caption) with the no-duplication rule; the segment → motivation → format → hook generation pipeline output as a hook matrix; an eight-move opening menu; the diagnostic funnel mapping thumbstop/hold/CTR/CVR to which component to fix; the on-ramp rule (every hook test is an on-ramp test); fidelity laddering tied to production tiers; and inherited grounding rules plus organic language mining. SKILL.md adds the Mode 4 section and 'creative strategy,' 'creative roadmap,' 'creative retro,' 'hook writing' triggers. New eval (id 9) covers exploration-state diagnosis, evidence-ranked slates, and the receipts rule.
  • customer-research (2.0.0 → 2.0.1): added the zero-review persona fallback to Persona Generation — a four-step proxy ladder (own differentiator → direct competitors' reviews → marketplace comparables → adjacent brands sharing the audience) with provisional-persona tagging and replacement as first-party evidence arrives.
  • marketing-loops (1.1.0 → 1.2.0): added the monthly-creative-retro loop to the Paid section of references/loop-catalog.md — closes ad-creative's Mode 4 loop on a schedule: pulls last month's performance, drafts the retro artifact and next month's capacity-checked slate, flags the account-state call for human confirmation, one-retro-per-month idempotency, and never launches or pauses ads. Closes #434.

2.8.6 (2026-07-09)

  • ai-seo (2.1.0 → 2.2.0): added citations vs. recommendations — the correction to citation-centric AEO strategy. New references/citations-vs-recommendations.md (grounded in Lily Ray's (Amsive) 100-query B2B study, Scrunch and SimilarWeb behavioral studies, and Growth Plays commentary): the AI visibility ladder (retrieved → cited → mentioned → recommended, each governed by different criteria, plus the shadow rung of being recommended against on requirements-heavy prompts), the self-promotional listicle risk (69% of the AI Overview citations earned by self-promotional "best [category]" listicles — 224 of 323 — appeared in answers that excluded the publisher from the recommendations; for emerging brands a self-ranked guide can act as a vote for competitors), stage-dependent buyer's-guide strategy (leaders get cited and recommended; emerging brands get citation and category framing — still worth publishing, with rebalanced expectations), what earns recommendations (offsite consensus: reviews, analysts, communities, earned media, video — with the test "if a model ignored everything on our domain, would the rest of the web still shortlist us?"), and what a recommendation is worth (Scrunch, observational: ~2× behavior lift vs. a passing mention; for users with no recent observed brand engagement, +182% branded searches / +117% site visits / +185% product views within a week; SimilarWeb: ~2.5× more new visitors — with only ~9% visible as AI traffic, the attribution blind spot) plus the measurement triad (prompt tracking with mention framing, self-reported attribution, call recordings). SKILL.md adds a compact citation-≠-recommendation pointer, a Recommendation-rate row in Monitoring, and caveats on the Listicle Block (content-patterns.md) and educational-content goals (content-types.md).
  • competitors (2.0.0 → 2.0.1): added an AI-answer expectations-by-stage caveat to the alternatives-page format — these pages often earn AI citations, but recommendation depends on offsite consensus; for emerging brands a self-ranked list can surface competitors in the answer. Cross-references ai-seo's citations-vs-recommendations reference. Closes #427.

2.8.5 (2026-07-09)

  • ad-creative (2.4.0 → 2.5.0): extended the iMessage reveal reference into iOS-native reveal video adsreferences/imessage-video-ads.md (filename unchanged; retitled) now covers three surfaces sharing one production architecture. New Other iOS-Native Reveal Surfaces section: a surface-selection table keyed to persuasion mechanic (iMessage = a friend's recommendation; ChatGPT = an authoritative answer to the viewer's own question; Apple Notes = a private confession made public), ChatGPT reveals (the typed question is the customer's verbatim question; stream the answer in word chunks — type like thumbs, stream like a model; ChatGPT-real formatting; OpenAI trade-dress legal note; and the strictest compliance rule in the family — the answer is ad copy wearing an authority costume, so health/medical/financial advice in a fabricated AI answer requires legal review and the exchange is never presented as a real unprompted ChatGPT endorsement), and Apple Notes reveals (confession-not-conversation: note title as the hook, first-person list typed live with keyboard-taps-only audio, one typo-and-correction, the product as the least enthusiastic line, realizations grounded in real reviews per Grounded Inputs). SKILL.md pointer updated to the three-surface framing and adds 'ChatGPT ad' and 'Apple Notes ad' triggers. New eval (id 8) covers the health-claims compliance flag, surface selection, and Notes craft rules. Format source credit unchanged (Gooseworks iOS Ads pack). Closes #424.

2.8.4 (2026-07-09)

  • social (2.1.0 → 2.2.0): added a carousel framework library. New references/carousel-frameworks.md — five slide-by-slide narrative architectures for Instagram carousels and LinkedIn document posts, re-expressed and extended from a pattern circulating on marketing X (Vibe Marketers HQ's five-framework breakdown): Value-Stack (exact-count cover → one item per slide → action close; the count is a checkable promise), Problem-Proof (result-as-fact hook → reframed problem → named mechanism → literal detail → screenshot receipt that closes slide 1's loop), Hack List (contrarian stat hook → why the common approach fails → one named technique per slide → thesis + CTA), Rant Callout (provocative claim → specific escalation → the fairness pivot that keeps it conviction-not-bitterness → signed close), and Demo Walkthrough (outcome first → pain → numbered process overview before the detail to cut mid-swipe drop-off → one real screenshot per step → result + positioning). Includes a framework-selection table (match structure to content type), two cross-framework rules (slide 1 is the thumbnail; one visual template per carousel), per-framework SaaS examples and failure modes, platform notes (IG 4:5 specs, LinkedIn PDF document posts with the post text as a second hook, TikTok photo-mode pacing), a production checklist (real claims only, exact counts delivered, one CTA), and measurement guidance (judge on saves + completion, not likes). SKILL.md wires the reference next to post templates and adds 'carousel,' 'slide-by-slide,' and 'document post' triggers; post-templates.md's generic Carousel Hook now points to the full library. New eval (id 7) covers framework selection, named-technique slides, LinkedIn document-post guidance, and no-invented-stats. Closes #421.

2.8.3 (2026-07-09)

  • ad-creative (2.3.0 → 2.4.0): added a brand-flexible style tier to references/motion-video-ads.md — four token-driven styles that absorb any company's brand system instead of imposing their own palette: monoline editorial (thin single-weight ink line-art on the brand neutral, one accent sweep — the most universally brandable), Swiss typographic (the label set enormous in the brand's type on a grid; works for any brand with a font and a color), wireglow (wireframe subject on near-black with one gradient accent beam — dev-tool/dark-mode brands), and duotone screenprint (photography reduced to ink + accent). All driven by a brand slots contract — FIELD (neutral ground), INK (drawing/type color), ACCENT (one element per frame, scarcity is the design), TYPE FEEL, plus per-brand constraints (e.g. "gradients only on edges") — resolvable from brand guidelines or .agents/product-marketing.md. Includes per-style motion notes (lines draw themselves, beams pulse, type settles) under the same composition-never-changes rules. All four verified to render with clean typography using a real brand's tokens.

2.8.2 (2026-07-09)

  • ad-creative (2.2.0 → 2.3.0): added the faceless motion-style video ad format. New references/motion-video-ads.md (format popularized by @borjafat; original re-expression of the open Bomx super-video-maker motion-collage recipe, extended with production lessons from shipping it end-to-end): a fully generated 15–45s concept/explainer video — styled poster stills (one per beat, series-locked via reference images) → image-to-video "living" motion → TTS narration → whisper-word-timed captions — at roughly $3–6 and ~15 minutes per finished video. Covers the provider-agnostic pipeline with a one-key Gemini path (Nano Banana Pro + Veo 3.1 + Gemini TTS) and alternatives (GPT-Image/Flux, Seedance/Kling/Runway, ElevenLabs), a five-style visual library with fill-in prompt formulas (screen-print collage, flat vector explainer, papercraft diorama, pop-art comic, claymation), a motion prompt formula, hard-earned QC gotchas (image-to-video models inject photoreal "maker hands" — and negative prompts make it worse; always QC each clip's final 2 seconds; caption/label collision; TTS/whisper sound-alike words in CTAs), ad-specific rules (brand in the poster for sound-off autoplay, beat 1 is the 3-second hook, regenerate stills per aspect rather than cropping), and AI-content disclosure notes. SKILL.md wires the reference into Generating Ad Visuals and adds 'motion video ad,' 'faceless video ad,' 'animated explainer ad,' and 'motion collage ad' description triggers.

2.8.1 (2026-07-08)

  • ad-creative (2.1.0 → 2.2.0): added the iMessage chat-reveal video ad format. New references/imessage-video-ads.md — an original distillation of the format popularized by Shiv Sakhuja / Gooseworks (their public create-imessage-video-ad skill; the repo carries no open-source license, so content was re-expressed with credit rather than copied): a 9:16 video where a scripted iMessage thread unfolds bubble-by-bubble — screenshot hook → friend reacts → "what app is that?" → brand + promo-code reveal → static end card. Covers when to use it and when not (considered B2B, nothing screenshot-able, regulated-industry compliance), a compliance/grounding section tying dramatized conversations to the skill's Grounded Inputs rules (facts in the thread must be real; never frame the thread as a real testimonial), the six concept angles (result-as-screenshot, setup flex, cancellation moment, feature-as-punchline, friend-asks-friend inverse, receipt-as-hook), ad anatomy with script + pacing rules (8–14 bubbles, texting voice, brand appears once and late, rhythm not metronome, link-underlined promo code), three production routes (off-the-shelf Gooseworks skill; code-based HTML mockup + one continuous Playwright recording + ffmpeg stitch; Remotion for templated scale), the craft rules that sell the illusion (the recognizable send/receive SFX — CC0 recordings on BigSoundBank, with a trade-dress legal-review note; silent typing indicators; composer-typed text must equal sent text; static end card with the real logo SVG; native 1080×1920 recording; HTML-mimic real app UIs for hook screenshots instead of AI-generating them), a ship checklist, and an iteration order (hook attachment first). SKILL.md wires the reference into Generating Ad Visuals and adds 'iMessage ad,' 'chat reveal ad,' 'text message ad,' and 'fake DM ad' description triggers. Closes #411.

2.8.0 (2026-07-06)

  • Added marketing-council skill — a simulated board of advisors staffed by twelve legendary marketers, built so their lenses deliberately collide: Seth Godin, David Ogilvy, Eugene Schwartz, Claude Hopkins, Gary Halbert, Russell Brunson, Alex Hormozi, April Dunford, Rory Sutherland, Byron Sharp, Ann Handley, and Gary Vaynerchuk. Three session modes (quick take / 3-5 seat council session / full council), a seating table mapping question types to strong fits plus designated dissenters (an agreeing council is an anti-pattern — e.g., Sharp dissents on niche strategies, Godin on funnel pressure, Hopkins on unmeasurable brand plays), and a session protocol ending in a disagreement map (each conflict named as its underlying trade-off plus the evidence that would settle it) and a chair's synthesis with skill handoffs. Per-advisor dossiers in references/advisors/ were research-grounded via parallel web-research passes: each carries lens, frameworks with verified attributions (incl. misattribution flags — Dream 100 is Chet Holmes's, "salesmanship in print" is John E. Kennedy's coinage, brand image originated with Gardner & Levy, AIDA predates Halbert), documented positions with named sources, signature questions, best-for/blind-spots (with documented criticisms so dissent is honest), voice notes, and key works. Hard grounding rules: output labeled as simulation; no fabricated quotes (verifiable quotes with source, else paraphrase attributed to the work); no implied endorsements of the user's specific company; extra care for the eight living advisors including explicit do-not-fabricate flags (e.g., Hormozi launch figures are self-reported; recency questions about living advisors route to the research pass). Optional live research pass integrates deep-research / watch-video / last30days-style skills when installed, degrading to web search. references/advisor-template.md supports custom advisors saved to .agents/advisors/ with a two-tier grounding standard (public figures need sources; private advisors' positions must come from the user, never invented). Includes an evals/evals.json suite covering dissent enforcement, quote discipline, custom-advisor flow, and the do-not-fabricate rule. Closes #391. Total skills: 47.

2.7.0 (2026-07-05)

  • ad-creative (2.0.0 → 2.1.0): added scaled static ad production with grounded inputs. New references/static-ad-templates.md — a 15-template structural library for static ads (Headline Statement, Us vs. Them, Stat Callout, Review Card, Testimonial Stack, Before/After, Problem/Solution, Founder Message, Feature Spotlight, Press Mention, Lifestyle Hero, Numbered List, FAQ Card, Competitor Callout, Origin Story), each with structure, copy slot, DTC + SaaS examples, sourcing guidance, and compliance notes where relevant (before/after claims, press logos, comparative advertising). SKILL.md adds Mode 3: Scaled Static Batches (Grounded) and a Grounded Inputs section: a durable inputs corpus (inputs/winning-ads/, inputs/reviews/, inputs/comments/, plus brand/), hard grounding rules (every concept cites its source — a real review, winning ad, or ad comment; no invented claims or testimonials; refuse to generate when required inputs are empty rather than falling back to ungrounded output), and input-decay guidance. Ad comments called out as the most-skipped, highest-value input (public objections → FAQ Card ads; unprompted praise → customer-written angles). New static batch output format: outputs/YYYY-MM-DD/ with scannable INDEX.md (template + grounding per concept), per-concept files, and images — built for the pick-5-of-50 human review workflow. Two new Common Mistakes (generating without grounding, skipping the comments input) and cross-refs to marketing-loops and customer-research. Frontmatter description adds 'static ads,' 'static ad concepts,' and 'ad templates' triggers. Remixed from a DTC "morning ads" playbook pattern, adapted for cross-agent use and extended with B2B/SaaS examples.
  • marketing-loops (1.0.0 → 1.1.0): added the daily-creative-drop loop to the Paid section of references/loop-catalog.md (loop #44) — a daily batch of grounded static ad concepts via ad-creative Mode 3. Full nine-part anatomy: acts only when the grounded inputs corpus is populated (else asks for inputs instead of generating), one-batch-per-day idempotency via dated output folders plus near-duplicate tracking across recent batches, stages creative only (never publishes to the ad account), pauses itself if batches go unreviewed for a week (vanity-loop detection), and a companion input-freshness cadence (weekly inputs/winning-ads/ refresh; monthly inputs/reviews/ and inputs/comments/ refresh).
  • ads (2.1.0 → 2.2.0): major B2B operations expansion — five new references plus a routing-table pattern, adapted (re-expressed, reconciled, and extended with our own framing) from practitioner playbooks, notably Ivan Falco's ads-skills (ColdIQ; MIT + Commons Clause, so all content was rewritten rather than copied). New Reference Routing table at the top of SKILL.md maps user intent → reference file, with a hard rule that live-account operational decisions load the relevant playbook first. New references: b2b-paid-playbook.md (5-stage demand lifecycle past the funnel — Create/Capture/Accelerate-Activate/Revive/Expand with bottom-up build order; budget-by-stage matrix with ROI timelines; leading vs. lagging signals for 2-24-month sales cycles; breakeven CPL/CPC derivation; hard kill rules — 2-3× target CPL at zero conversions for new ads, 1.5-2× over target for aging ads; the optimize-to-quality trap + offline conversion loop with "the CRM wins" reconciliation; Urgency/Budget/Fit 0-9 lead scoring ranked by ad; the scaling quadrant 2×2; measurement maturity gate; channel selection incl. paid-review listings and the $100 test). meta-decision-system.md (fully quantified kill/graduate/scale engine anchored on TCPL — target cost per qualified lead: ad-count ceiling formula, 80/20 Scaling/Testing dual-CBO structure, day-7 delivery check with fair-share math, weekly quality evaluation with a 3×TCPL data gate and QL-rate bands, five-condition graduation criteria, fatigue frequency bands by campaign type, swap rules, creative production math with win rates and minimum proven-ad inventory, +20%-per-5-days scaling protocol with rollback triggers, weekly cadence, lead-form friction / social-amnesia fixes, Advantage+ transition at ~50 conversions/week, benchmarks + Q1/Q4 seasonality). linkedin-b2b-playbook.md (auto-then-manual-at-−20% bidding progression, penetration-based scaling triggers, audience sizing rules and failure modes, job-functions-vs-titles tradeoffs incl. the seniority mutual-exclusivity and Business-Development-contains-C-suite gotchas, audience splitting rules and platform distribution bias, funnel-stage benchmarks with the CTRTLP-vs-CTR trap, thought-leader-ads playbook incl. the 72-hour organic-first edit trick and format-as-auction-tactic insight, campaign-group build order, document/conversation/CTV format notes, the non-retroactive retargeting warning, and an audit shortlist). google-search-playbook.md (the five-rung intent ladder with don't-skip-rungs gating, brand pause test on total-not-paid conversions, capture-before-create channel rule, separate-budgets-by-intent account structure with themed-ad-groups-not-SKAGs and default settings to flip, Phrase/Exact→Broad progression with 30-conversion gates, starter negative lists + negative match-type mechanics gotcha, the weekly search-terms ritual with don't-over-negative restraint, bidding-by-conversion-volume table with ±10-15% target moves, the 2× daily budget rule, offline conversion import via GCLID, QS fix-order and form-length-as-intent-gate, PMax-for-B2B guardrails and value ranking, benchmarks + the 8-metric weekly scorecard). abm-playbook.md (go/no-go thresholds, LinkedIn ABM 1:1/1:few/1:many with list-size mechanics and segmentation against enterprise over-serving, personalized-creative lift + the Germany legal exception, engagement-based frequency capping, ABM-on-Meta enrichment workflow for the sub-5% match-rate problem, acceleration campaigns against open pipeline on awareness objectives, 60/30/10 cross-channel split, the UTM cross-channel remarketing mechanic, sales orchestration with 48-hour engagement triggers, and account-movement KPIs + 80/20 incrementality holdouts). Also: the mandatory Google RSA Output Spec moved verbatim from SKILL.md to references/rsa-output-spec.md (SKILL.md keeps a mandatory load-and-follow pointer), bringing SKILL.md from 552 back under the 500-line limit. New description triggers: 'ABM,' 'account-based marketing,' 'B2B ads,' 'lead quality,' 'negative keywords,' 'Performance Max,' 'thought leader ads,' 'when should I kill an ad.' New Related Skills cross-refs to revops and customer-research.

2.6.0 (2026-07-01)

  • Added marketing-loops skill — a library of 43 repeatable marketing loops (recurring agent workflows an agent runs on a cadence). Inspired by ForwardFuture's Loop Library pattern but scoped to marketing operations, and positioned as the operational cousin of marketing-ideas (ideas = what to try once; loops = what to keep doing on a schedule). SKILL.md defines a nine-part loop anatomy — check cadence, acts-when (action condition), purpose, skills used, loop body, self-check, state/idempotency (last-run marker, dedupe key, cooldown — so loops don't double-act or re-nag), stop/bail-out, and output — plus a cadence rule (match frequency to how fast the signal actually changes), when NOT to loop (strategy/creative work, unreviewed spend/publish, sparse signals, vanity loops), and scheduling guidance that defers the mechanics to loopify (Claude Code /loop / ScheduleWakeup / CronCreate) or plain cron. references/loop-catalog.md holds all 43 loops grouped by function: SEO & Content (keyword-gap, ranking-drop watch, content-decay, internal-linking, programmatic-SEO quality, content-repurposing, content-calendar refill), Paid (ad-fatigue, paid-search query-mining, retargeting hygiene, landing-page regression), Earned/Social/Partnerships (newsjacking, social-listening, community-engagement, competitor-watch, backlink-prospecting, directory-submission, partner-pipeline), Activation (onboarding drop-off, signup-funnel-leak, lead-capture asset, feature-adoption), Retention (churn-signal, lifecycle-email-refresh, re-engagement, email-deliverability, voice-of-customer), Revenue (trial-conversion, PQL/upgrade-intent, pricing-page-experiment, paywall-optimization, expansion/upsell, failed-payment/dunning), Referral & Advocacy (referral-nudge, review-and-UGC-harvest, review-site-management, case-study-sourcing), and Ongoing Ops (weekly-marketing-review, experiment-backlog, analytics-anomaly, brand-mention/reputation, tracking-QA, campaign-postmortem). Each entry orchestrates existing skills and carries concrete guardrails — e.g. newsjacking has a veto list (tragedy/politics/crisis/sensitive verticals) + mandatory human approval; ad-fatigue requires real significance (spend/impressions/conversions/attribution/learning-phase); lifecycle-email optimizes on clicks/replies/complaints/bounces not opens; pricing/paywall judge winners on revenue-per-visitor/refunds/churn not conversion alone; review-harvest enforces consent/FTC/platform ToS; the experiment-backlog loop is a thin wrapper that hands off to ab-testing. references/loop-template.md gives authors a copy-paste template (fill-in prompts + worked before/after example + ship checklist) for creating their own loops. Three further references round out the skill: loop-orchestration.md (how loops compose into a four-layer system — sensing → diagnostic → action → learning — plus a staged rollout path so you adopt tracking + a weekly review before acquisition, and never build all 43 at once), loop-state.md (where loop state lives — .agents/loops/<loop>.json — the watermark/dedupe/cooldown/in-flight idempotency patterns, and a run-log format that doubles as a vanity-loop detector), and loop-guardrails.md (a two-tier action model of autonomous-safe vs. gated actions, spend/send caps + allowlists, CAN-SPAM/GDPR/FTC/platform-ToS compliance mapped to the loops each governs, PII handling, an always-escalate list, a required kill switch, and a pre-launch checklist). Includes a banned-vocabulary list (no "set it and forget it" / "fully autonomous marketing" / "10x on autopilot") and an evals/evals.json suite. Total skills: 46.
  • ads (2.0.1 → 2.1.0): reframed the skill around the "audience knowledge → creative first, targeting filters second" shift, plus a new modern Meta playbook. Rewrote the Audience Understanding & Targeting section — audience research is still the highest-leverage work, but where you apply that knowledge has changed: as ad-platform algorithms have improved at matching, feeding audience identifiers into the creative (headlines, copy, hooks, examples) now outperforms jamming them into targeting filters. Added a platform-by-platform table splitting how much audience knowledge should go to creative vs. targeting (Meta post-Andromeda 80%+ creative; Google Search 60% targeting; PMax/Demand Gen 70% creative; LinkedIn 60% targeting; TikTok 70% creative; Twitter/X 50/50), guidance on applying each kind of audience identifier to creative, and a "trying to fix weak creative with hyper-precise targeting" failure-mode callout. Added a Modern Meta playbook (Andromeda era — 2026+) section covering Meta's 2025 Andromeda algorithm change: creative volume as the binding constraint (statics > polished video, ~1 hr/week of fresh creative for the winning offer), creative-as-targeting (broad audience + specific creative, with a duplicate-and-strip-targeting A/B test), and the 4-component retargeting framework (segment by funnel stage, retarget with different offers). Interest-stacking is now flagged as actively harmful on Meta. Skill body only; frontmatter description unchanged.

2.5.1 (2026-06-16)

  • Bumped copywriting, launch, pricing, and sales-enablement from 2.0.0 → 2.0.1 to reflect the description changes that shipped in v2.5.0 (cross-references added pointing to the new offers skill). The skill bodies are unchanged; only the frontmatter description picked up a new "For ..., see offers" line. Without the version bump, the repo's update check (which compares VERSIONS.md against local skill metadata) would not surface the routing/discovery change to users with installed copies. Caught by codex review.

2.5.0 (2026-06-16)

  • Added offers skill for offer design — the thing you actually sell, not the page that sells it. Built around two frameworks: (1) the Value Equation (Dream Outcome × Perceived Likelihood / Time Delay × Effort), originally Hormozi, now standard across direct-response and creator-economy training; and (2) the six-component anatomy of a complete offer (core deliverable, bonus stack, guarantee, scarcity, name, price + payment structure). Self-scoped explicitly: best for services, agency retainers, courses, coaching, info products, high-ticket B2B, and direct response. Less load-bearing for pure self-serve SaaS where pricing does more work. References include: value-equation.md (full breakdown of the four levers with diagnostic prompts and a worked example of a stuck $3K copywriting course), offer-anatomy.md (the six components with worked examples and a fractional-CMO before/after), guarantee-design.md (eight guarantee types with decision tree by business type, refund tolerance, and buyer sophistication; honest case for anti-guarantees on premium offers), bonus-stacking.md (bonuses-as-objection-handlers, the math of stated value, the 4-bonus pattern that works, common failure modes), scarcity-urgency.md (honest formats: capacity / cohort / founding-member / inventory / seasonal / bonus-expiry / price-increase; explicit rejection of fake countdown timers and manufactured FOMO; why fake scarcity is uniquely costly), offer-formats.md (default offer format by business type — service, course, coaching, info product, high-ticket B2B, agency retainer, self-serve SaaS, direct-response — with what to watch for each), and examples.md (six anonymized before/after worked examples spanning fractional CMO, copywriting course, Notion templates, B2B SaaS annual contract, group coaching mastermind, content agency retainer). Includes a banned-vocabulary list (game-changing, revolutionary, 10x, secret, hidden, "limited time" with no actual limit) and explicit anti-patterns (manipulative scarcity, over-promising guarantees, bonus inflation, course-bro aesthetic).
  • Cross-references added in pricing, copywriting, launch, and sales-enablement descriptions pointing to offers for offer construction.
  • Total skills: 45.

2.4.2 (2026-06-15)

  • ai-seo (2.0.1 → 2.1.0): added coverage of Google's Open Knowledge Format (OKF), a v0.1 markdown spec for agent-readable site bundles introduced on the Google Cloud blog on 2026-06-12 and shipped inside Knowledge Catalog. New references/okf.md reference covers what OKF is (directory of cross-linked markdown files with YAML frontmatter — type required, plus title/description/resource/tags/timestamp recommended), honest framing (Google built it for data-team catalog metadata; site-readable repurposing popularized by Suganthan Mohanadasan is a clever secondary use), what it does for AI search today (nothing immediate; protocol-layer registration like early schema.org adoption), where OKF fits in the agent-readable stack alongside sitemap.xml / robots.txt / llms.txt / /pricing.md / schema, three ways to ship a bundle (Suganthan's free web generator, his pending WordPress plugin, or by hand), hosting guidance (yoursite.com/okf/index.md plus an llms.txt line pointing to it), when to skip (closed platforms like Wix/Squarespace, very small sites, sites without other machine-readable files), and what to watch (v1.0 spec, AI engine adoption signals). SKILL.md adds a brief OKF subsection under "Machine-Readable Files for AI Agents" pointing to the reference. Frontmatter description extended with new triggers: llms.txt, OKF, Open Knowledge Format, knowledge bundle, agent-readable site. references/platform-ranking-factors.md Google AI Overviews section gets an OKF callout framing it as a "register early" protocol bet rather than a confirmed ranking signal.

2.4.1 (2026-06-10)

  • Renamed pr skill to public-relations to avoid collision with pull-request skills in other Claude Code plugins (common naming for code-review / GitHub PR automation). The skill description already disambiguated from pull requests, but the directory name pr was still ambiguous to skill resolvers and to users typing /pr. The rename happened within hours of the initial v2.4.0 publish, before meaningful install adoption. No content changes; skill version stays at 1.0.0. All cross-references in social/SKILL.md, VERSIONS.md, and README.md updated accordingly.

2.4.0 (2026-06-10)

  • Added public-relations skill (originally shipped as pr, renamed in v2.4.1) for public relations / earned media work — pitching journalists, newsjacking trending stories, responding to press requests (HARO/Connectively, Qwoted, Featured, Help A B2B Writer), and building the owned-media foundation (press page + media kit). Four PR modes (reactive / proactive / inbound / owned), explicit when-to-skip framing, and a banned-vocabulary list. References include: newsjacking.md (detect → score → angle → pitch loop with newsworthiness scoring rubric, 7 angle templates, Google News / HN / Reddit curl recipes, failure modes); journalist-pitching.md (media list construction, journalist fit scoring, 6 pitch templates by angle — data story / exclusive launch / op-ed / customer story / trend connector / newsjack response — subject-line craft, embargo etiquette, follow-up cadence); press-platforms.md (daily triage workflow, response template, ROI reality check); media-outlets.md (tiered list of tech press, SaaS, AI, devtools, business outlets, newsletters, podcasts, vertical press, regional press — explicitly scoped to journalist-driven outlets, with startup directories deferred to directory-submissions). Scope is enforced via cross-references: the public-relations skill handles earned media; directory-submissions handles Product Hunt / BetaList / SaaS directories; launch handles the broader launch moment.
  • social (2.0.0 → 2.1.0): added references/listening.md for engagement triage — a daily loop for surfacing the top posts to comment on rather than scrolling feeds. Includes a 5-dimension scoring rubric (ICP fit, intent signal, reach potential, comment opportunity, recency), comment quality tiers, curl-based recipes for Reddit / HN Algolia / Bluesky (no auth required), and a browser-driven workflow for LinkedIn and X via dev-browser with persistent session. Added references/listening-sources-template.md — a copyable starter for .agents/listening-sources.md covering brand/category context, ICP definition, target accounts per platform, intent keywords, subreddits, saved-search URLs, and a do-not-engage list. SKILL.md Engagement Strategy section now links to the listening reference.
  • Total skills: 44.

2.3.0 (2026-05-27)

  • Added marketing-plan skill — comprehensive AARRR-structured marketing plan generator. Produces a 13-section Notion-paste-ready plan document (executive summary, strategic frame, current state, AARRR breakdown, 90-day roadmap, 12-month outlook with funding-stage capability unlocks, marketing operations stack mapping skills + MCPs to AARRR stages, tactical idea bank cross-referencing all 139 marketing-ideas to AARRR + client-specific status, measurement framework, RACI, open decisions). Customized for current budget, team, stage, and tooling stack. Three-phase workflow: INIT (research + intake), REVIEW (section-by-section walkthrough), FINALIZE (compile + verify + optional publish to shared repo). References include methodology, plan-template, aarrr-framework, current-state-rubric (self-contained 17-section scoring rubric), ops-stack-mapping, idea-cross-reference (139-idea AARRR mapping), funding-stage-unlocks, measurement-framework, client-types (variations by B2B SaaS / D2C / hardware-hybrid / marketplace / dev tool / clinical / commerce), example-quietude (anonymized canonical reference plan, based on a real fCMO engagement with names/identifying details changed), budget-planning (two scientific methods for setting the marketing budget — Revenue-Based 5–40% of ARR, and Goal-Based formula reverse-engineered from the revenue target; plus blended CAC calculation, the 10–20% experimental buffer rule, the 3-3-2-2-2 VC growth path, and the forecasting reality check), growth-patterns (the real shape of SaaS growth — $0–10K / $10K–100K / $100K–1M phases with binding constraints, linear vs step-function vs S-curve patterns, and Channel × Product × Market layering), and team-and-agency-model (the strategy-in-house / execution-outsourced principle, three core functions Growth/Product/Content, π-shaped marketer framework, title progression Manager → Lead → Director → VP → Chief, agency selection framework, and the three-stage scaling model Early/Growth/Scale). Budget, growth-pattern, and team frameworks drawn from Founding Marketing by Corey Haines.
  • Total skills: 43.

2.2.0 (2026-05-26)

  • Added prospecting skill for building qualified prospect lists across SaaS, B2B, and local SMB motions. Includes shared 5-phase framework (ICP → discovery → qualify → score → output) plus branch-specific references (saas-prospecting, b2b-prospecting, local-prospecting), data-sources guide covering Apollo / Clay / ZoomInfo / Clearbit / Hunter / Snov / Truelist / RB2B / Sales Nav / BuiltWith / Crunchbase / GitHub, and compliance reference (CAN-SPAM, GDPR, CASL, platform ToS).
  • Added tools/clis/github-prospects.js CLI for pulling GitHub stargazers, forkers, and watchers as a developer-intent signal — with pagination, enrichment, filter-based early termination, and CSV output.
  • Added new tool integration docs: truelist (email deliverability validation, OpenAPI-aligned), github (REST API for prospecting), firecrawl (single-target page scraping), browserbase (real Chromium for JS-heavy pages or interaction).
  • ads (2.0.0 → 2.0.1): added Google RSA Output Spec section enforcing 15 headlines × 30 chars, 4 descriptions × 90 chars, ad group structure labels, ≥8 negative keywords, ≥4 sitelinks/callouts, output ordering to avoid truncation, and a self-check before responding. Includes optional Brazilian medical (CFM) compliance rules when product context indicates that vertical.
  • Added sequenzy tool integration (email marketing platform with MCP support).
  • Fixed plugin.json version drift (was stuck at 1.9.0 across three releases) — sync-skills.js now auto-syncs plugin.json version to marketplace.json on every change. Closes #323.
  • Added skill install artifacts (.agents/, .claude/, skills-lock.json) to .gitignore.
  • Total skills: 42.

2.1.0 (2026-05-21)

  • Added sms skill for SMS/MMS marketing — welcome flows, abandoned cart, post-purchase, win-back, promotional sends, and transactional/auth. Includes compliance reference (TCPA, A2P 10DLC, GDPR, CASL), sequence templates with character counts, and platform comparison (Klaviyo, Postscript, Attentive, Twilio, Brevo, SimpleTexting, Customer.io).
  • Total skills: 41

2.0.1 (2026-05-18)

Content patch — no breaking changes, no new skills.

  • ai-seo (2.0.0 → 2.0.1): aligned with Google's official AI features optimization guide. Added sections for Google's stance on AI optimization, query fan-out, agentic experiences (including UCP), explicit "what NOT to do" (scaled content abuse, etc.), and Search Console expectations. Reframed llms.txt / pricing.md / schema markup recommendations as "Google says not required, helpful for non-Google AI engines." Moved content-type tactics to references/content-types.md (added local/ecom Merchant Center + Business Profile guidance per Google).
  • image (2.0.0 → 2.0.1): refreshed model lineup to current May 2026 releases — Nano Banana / Nano Banana Pro family naming, Flux Pro 1.1 + Kontext + Dev + Schnell variants, Ideogram 3.0, ChatGPT Images 2.0 / GPT Image, Midjourney v7, Recraft V3, SD 3.5 / SDXL. Updated decision tree and trigger phrases.
  • video (2.0.0 → 2.0.1): refreshed model lineup — Sora 2 promoted from limited-availability caveat, Kling 2.5/3.0, added Seedance (ByteDance), Hailuo / MiniMax (character consistency), Hunyuan Video / Wan 2 (open-weight self-hosted), Pika 2.x. New "Quick picks" guide.

Total skills: 40 (unchanged).

2.0.0 (2026-05-05)

Breaking changes — Users must reinstall skills after this update.

Skill Renames (17)

Old NameNew Name
ab-test-setupab-testing
analytics-trackinganalytics
aso-auditaso
competitor-alternativescompetitors
email-sequenceemails
free-tool-strategyfree-tools
launch-strategylaunch
onboarding-croonboarding
paid-adsads
paywall-upgrade-cropaywalls
popup-cropopups
pricing-strategypricing
product-marketing-contextproduct-marketing
referral-programreferrals
schema-markupschema
signup-flow-crosignup
social-contentsocial

Consolidations (1)

  • page-cro + form-crocro (form content moved to references/form.md)

Why 2.0?

  • Shorter, cleaner skill names
  • Consistent naming conventions (no more -strategy, -setup, -cro suffixes)
  • Consolidated CRO into single skill with references
  • All cross-references updated across 100+ files

Total skills: 40

1.10.0 (2026-05-04)

  • Added co-marketing skill for partner identification, joint campaigns, and co-marketing strategy
  • Total skills: 41

2026-04-24

  • Added image skill for AI image generation, design tools, profile/listing banners, and optimization
  • Added video skill for AI video production (Hyperframes, HeyGen, Veo, Runway, Kling)
  • Added short-form video section to social (1.3.0) — TikTok, Reels, Shorts frameworks
  • Added HeyGen and Hyperframes tool integration guides
  • Fixed plugin marketplace: source field now passes Claude Code schema validation (#270)
  • Added proper plugin.json manifest with "skills": "./skills"
  • Total skills: 40

2026-04-21

  • Added directory-submissions skill for Product Hunt, G2, AI directories, and backlink strategy
  • Added competitor-profiling skill for competitive intelligence research
  • Added international SEO & localization section to seo-audit (1.2.0)
  • Added conversion tracking reference to ads (cross-platform pixel setup)
  • Added Zapier SDK integration for 8,000+ app access
  • Fixed plugin loading: removed ./ prefix from marketplace.json skill paths (#243)
  • Hardened CLI tools: Supermetrics API key moved to header, ZoomInfo JWT masked by default
  • Fixed community-marketing YAML frontmatter (#240)
  • Fixed Zapier webhook URL validation (#247)
  • Added missing skills to VERSIONS.md (aso, community-marketing, customer-research — shipped in prior releases)
  • Total skills: 38

2026-03-14

  • Added lead-magnets skill for lead magnet strategy, format selection, and conversion optimization
  • Added Composio integration layer for MCP access to OAuth-heavy tools (HubSpot, Salesforce, Meta Ads, LinkedIn Ads, Google Sheets, Slack, Notion, etc.)
  • Added headless CMS integration guides (Sanity, Contentful, Strapi) with headless-cms reference
  • Added 197 evals across all 33 skills for automated quality testing
  • Optimized all 32 skill descriptions for better trigger phrase matching
  • Replaced rigid imperatives with reasoning-based guidance across all skills
  • Added 10 new CLI tools (airops, clay, close, coupler, crossbeam, outreach, pendo, similarweb, supermetrics, zoominfo)
  • Added 13 new integration guides
  • Bumped all 32 existing skills from 1.1.0 → 1.2.0

2026-02-27

  • Migrated context path from .claude/ to .agents/ for agent-agnostic compatibility
  • All skills now check .agents/product-marketing.md first, with .claude/ fallback for older setups
  • Updated install paths in README to reference .agents/skills/
  • Bumped all 32 skills from 1.0.0 → 1.1.0

2026-02-22

  • Added revops skill for revenue operations, lead lifecycle, scoring, routing, pipeline management, and CRM automation
  • Added sales-enablement skill for sales decks, one-pagers, objection handling, demo scripts, and sales playbooks

2026-02-21

  • Added site-architecture skill for website structure planning, page hierarchy, navigation design, URL structure, and internal linking strategy

2026-02-18

  • Added ai-seo skill for AI search optimization (AEO, GEO, LLMO, AI Overviews)
  • Moved AEO/GEO content patterns from seo-audit references to ai-seo skill
  • Added churn-prevention skill for cancel flows, save offers, dunning, and payment recovery

2026-02-17

  • Added ad-creative skill for bulk ad creative generation and performance-based iteration
  • Added 51 zero-dependency CLI tools for marketing platforms (tools/clis/)
  • Added 31 new integration guides (tools/integrations/)
  • Added 4 email outreach CLIs: hunter, snov, lemlist, instantly
  • Security hardening: header auth for meta-ads, URL encoding, input validation
  • All CLIs reviewed via independent codex audit (auth, security, error handling, consistency)

2026-01-27

  • Initial version tracking added
  • Added tools registry with 29 integration guides