Skip to content

VERSIONS.md

Latest commit

 

History

History
210 lines (172 loc) · 19.2 KB

VERSIONS.md

File metadata and controls

210 lines (172 loc) · 19.2 KB

Marketing Skills Versions

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

Skill Version Last Updated
ab-testing 2.0.0 2026-05-05
ad-creative 2.0.0 2026-05-05
ai-seo 2.1.0 2026-06-15
analytics 2.0.0 2026-05-05
aso 2.0.0 2026-05-05
churn-prevention 2.0.0 2026-05-05
co-marketing 2.0.0 2026-05-05
cold-email 2.0.0 2026-05-05
community-marketing 2.0.0 2026-05-05
competitor-profiling 2.0.0 2026-05-05
competitors 2.0.0 2026-05-05
content-strategy 2.0.0 2026-05-05
copy-editing 2.0.0 2026-05-05
copywriting 2.0.1 2026-06-16
cro 2.0.0 2026-05-05
customer-research 2.0.0 2026-05-05
directory-submissions 2.0.0 2026-05-05
emails 2.0.0 2026-05-05
free-tools 2.0.0 2026-05-05
image 2.0.1 2026-05-18
launch 2.0.1 2026-06-16
lead-magnets 2.0.0 2026-05-05
marketing-ideas 2.0.0 2026-05-05
marketing-plan 1.1.0 2026-05-29
marketing-psychology 2.0.0 2026-05-05
offers 1.0.0 2026-06-16
onboarding 2.0.0 2026-05-05
ads 2.0.1 2026-05-26
paywalls 2.0.0 2026-05-05
popups 2.0.0 2026-05-05
pricing 2.0.1 2026-06-16
product-marketing 2.0.0 2026-05-05
programmatic-seo 2.0.0 2026-05-05
prospecting 1.0.0 2026-05-26
public-relations 1.0.0 2026-06-10
referrals 2.0.0 2026-05-05
revops 2.0.0 2026-05-05
sales-enablement 2.0.1 2026-06-16
schema 2.0.0 2026-05-05
seo-audit 2.0.0 2026-05-05
signup 2.0.0 2026-05-05
site-architecture 2.0.0 2026-05-05
sms 1.0.0 2026-05-21
social 2.1.0 2026-06-10
video 2.0.1 2026-05-18

Recent Changes

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 Name New Name
ab-test-setup ab-testing
analytics-tracking analytics
aso-audit aso
competitor-alternatives competitors
email-sequence emails
free-tool-strategy free-tools
launch-strategy launch
onboarding-cro onboarding
paid-ads ads
paywall-upgrade-cro paywalls
popup-cro popups
pricing-strategy pricing
product-marketing-context product-marketing
referral-program referrals
schema-markup schema
signup-flow-cro signup
social-content social

Consolidations (1)

  • page-cro + form-cro → cro (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