From 1999e8f8b39259faa05b3ded6f0b1e3218262dbe Mon Sep 17 00:00:00 2001 From: Corey Haines <34802794+coreyhaines31@users.noreply.github.com> Date: Tue, 27 Jan 2026 11:30:07 -0800 Subject: [PATCH] feat: add skill version tracking system - Add version: 1.0.0 to all 25 skill YAML frontmatters - Create VERSIONS.md manifest listing all skill versions - Add update check instructions to AGENTS.md This enables users to be notified of skill updates and easily pull the latest changes when 2+ skills are updated or there is a major version bump. Co-Authored-By: Claude Opus 4.5 --- AGENTS.md | 23 ++++++++++++++ VERSIONS.md | 37 +++++++++++++++++++++++ skills/ab-test-setup/SKILL.md | 1 + skills/analytics-tracking/SKILL.md | 1 + skills/competitor-alternatives/SKILL.md | 1 + skills/content-strategy/SKILL.md | 1 + skills/copy-editing/SKILL.md | 1 + skills/copywriting/SKILL.md | 1 + skills/email-sequence/SKILL.md | 1 + skills/form-cro/SKILL.md | 1 + skills/free-tool-strategy/SKILL.md | 1 + skills/launch-strategy/SKILL.md | 1 + skills/marketing-ideas/SKILL.md | 1 + skills/marketing-psychology/SKILL.md | 1 + skills/onboarding-cro/SKILL.md | 1 + skills/page-cro/SKILL.md | 1 + skills/paid-ads/SKILL.md | 1 + skills/paywall-upgrade-cro/SKILL.md | 1 + skills/popup-cro/SKILL.md | 1 + skills/pricing-strategy/SKILL.md | 1 + skills/product-marketing-context/SKILL.md | 1 + skills/programmatic-seo/SKILL.md | 1 + skills/referral-program/SKILL.md | 1 + skills/schema-markup/SKILL.md | 1 + skills/seo-audit/SKILL.md | 1 + skills/signup-flow-cro/SKILL.md | 1 + skills/social-content/SKILL.md | 1 + 27 files changed, 85 insertions(+) create mode 100644 VERSIONS.md diff --git a/AGENTS.md b/AGENTS.md index a5bb382..f75797c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -180,6 +180,29 @@ Skills reference relevant tools for implementation. For example: - `email-sequence` skill → customer-io, mailchimp, resend guides - `paid-ads` skill → google-ads, meta-ads, linkedin-ads guides +## Checking for Updates + +When using any skill from this repository: + +1. **Once per session**, on first skill use, check for updates: + - Fetch `VERSIONS.md` from GitHub: https://raw.githubusercontent.com/coreyhaines31/marketingskills/main/VERSIONS.md + - Compare versions against local skill files + +2. **Only prompt if meaningful**: + - 2 or more skills have updates, OR + - Any skill has a major version bump (e.g., 1.x to 2.x) + +3. **Non-blocking notification** at end of response: + ``` + --- + Skills update available: X marketing skills have updates. + Say "update skills" to update automatically, or run `git pull` in your marketingskills folder. + ``` + +4. **If user says "update skills"**: + - Run `git pull` in the marketingskills directory + - Confirm what was updated + ## Skill Categories See `README.md` for the current list of skills organized by category. When adding new skills, follow the naming patterns of existing skills in that category. diff --git a/VERSIONS.md b/VERSIONS.md new file mode 100644 index 0000000..3134fda --- /dev/null +++ b/VERSIONS.md @@ -0,0 +1,37 @@ +# Marketing Skills Versions + +Current versions of all skills. Agents can compare against local versions to check for updates. + +| Skill | Version | Last Updated | +|-------|---------|--------------| +| ab-test-setup | 1.0.0 | 2026-01-27 | +| analytics-tracking | 1.0.0 | 2026-01-27 | +| competitor-alternatives | 1.0.0 | 2026-01-27 | +| content-strategy | 1.0.0 | 2026-01-27 | +| copy-editing | 1.0.0 | 2026-01-27 | +| copywriting | 1.0.0 | 2026-01-27 | +| email-sequence | 1.0.0 | 2026-01-27 | +| form-cro | 1.0.0 | 2026-01-27 | +| free-tool-strategy | 1.0.0 | 2026-01-27 | +| launch-strategy | 1.0.0 | 2026-01-27 | +| marketing-ideas | 1.0.0 | 2026-01-27 | +| marketing-psychology | 1.0.0 | 2026-01-27 | +| onboarding-cro | 1.0.0 | 2026-01-27 | +| page-cro | 1.0.0 | 2026-01-27 | +| paid-ads | 1.0.0 | 2026-01-27 | +| paywall-upgrade-cro | 1.0.0 | 2026-01-27 | +| popup-cro | 1.0.0 | 2026-01-27 | +| pricing-strategy | 1.0.0 | 2026-01-27 | +| product-marketing-context | 1.0.0 | 2026-01-27 | +| programmatic-seo | 1.0.0 | 2026-01-27 | +| referral-program | 1.0.0 | 2026-01-27 | +| schema-markup | 1.0.0 | 2026-01-27 | +| seo-audit | 1.0.0 | 2026-01-27 | +| signup-flow-cro | 1.0.0 | 2026-01-27 | +| social-content | 1.0.0 | 2026-01-27 | + +## Recent Changes + +### 2026-01-27 +- Initial version tracking added +- Added tools registry with 29 integration guides diff --git a/skills/ab-test-setup/SKILL.md b/skills/ab-test-setup/SKILL.md index a3cd076..b0bc652 100644 --- a/skills/ab-test-setup/SKILL.md +++ b/skills/ab-test-setup/SKILL.md @@ -1,5 +1,6 @@ --- name: ab-test-setup +version: 1.0.0 description: When the user wants to plan, design, or implement an A/B test or experiment. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," or "hypothesis." For tracking implementation, see analytics-tracking. --- diff --git a/skills/analytics-tracking/SKILL.md b/skills/analytics-tracking/SKILL.md index 63513d6..9d8e0a0 100644 --- a/skills/analytics-tracking/SKILL.md +++ b/skills/analytics-tracking/SKILL.md @@ -1,5 +1,6 @@ --- name: analytics-tracking +version: 1.0.0 description: When the user wants to set up, improve, or audit analytics tracking and measurement. Also use when the user mentions "set up tracking," "GA4," "Google Analytics," "conversion tracking," "event tracking," "UTM parameters," "tag manager," "GTM," "analytics implementation," or "tracking plan." For A/B test measurement, see ab-test-setup. --- diff --git a/skills/competitor-alternatives/SKILL.md b/skills/competitor-alternatives/SKILL.md index 4bdfaa0..4515161 100644 --- a/skills/competitor-alternatives/SKILL.md +++ b/skills/competitor-alternatives/SKILL.md @@ -1,5 +1,6 @@ --- name: competitor-alternatives +version: 1.0.0 description: "When the user wants to create competitor comparison or alternative pages for SEO and sales enablement. Also use when the user mentions 'alternative page,' 'vs page,' 'competitor comparison,' 'comparison page,' '[Product] vs [Product],' '[Product] alternative,' or 'competitive landing pages.' Covers four formats: singular alternative, plural alternatives, you vs competitor, and competitor vs competitor. Emphasizes deep research, modular content architecture, and varied section types beyond feature tables." --- diff --git a/skills/content-strategy/SKILL.md b/skills/content-strategy/SKILL.md index efad87a..fc64f06 100644 --- a/skills/content-strategy/SKILL.md +++ b/skills/content-strategy/SKILL.md @@ -1,5 +1,6 @@ --- name: content-strategy +version: 1.0.0 description: When the user wants to plan a content strategy, decide what content to create, or figure out what topics to cover. Also use when the user mentions "content strategy," "what should I write about," "content ideas," "blog strategy," "topic clusters," or "content planning." For writing individual pieces, see copywriting. For SEO-specific audits, see seo-audit. --- diff --git a/skills/copy-editing/SKILL.md b/skills/copy-editing/SKILL.md index 9c232dc..6d6227f 100644 --- a/skills/copy-editing/SKILL.md +++ b/skills/copy-editing/SKILL.md @@ -1,5 +1,6 @@ --- name: copy-editing +version: 1.0.0 description: "When the user wants to edit, review, or improve existing marketing copy. Also use when the user mentions 'edit this copy,' 'review my copy,' 'copy feedback,' 'proofread,' 'polish this,' 'make this better,' or 'copy sweep.' This skill provides a systematic approach to editing marketing copy through multiple focused passes." --- diff --git a/skills/copywriting/SKILL.md b/skills/copywriting/SKILL.md index e34277b..d49f6e3 100644 --- a/skills/copywriting/SKILL.md +++ b/skills/copywriting/SKILL.md @@ -1,5 +1,6 @@ --- name: copywriting +version: 1.0.0 description: When the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages, pricing pages, feature pages, about pages, or product pages. Also use when the user says "write copy for," "improve this copy," "rewrite this page," "marketing copy," "headline help," or "CTA copy." For email copy, see email-sequence. For popup copy, see popup-cro. --- diff --git a/skills/email-sequence/SKILL.md b/skills/email-sequence/SKILL.md index 93007b7..6b50546 100644 --- a/skills/email-sequence/SKILL.md +++ b/skills/email-sequence/SKILL.md @@ -1,5 +1,6 @@ --- name: email-sequence +version: 1.0.0 description: When the user wants to create or optimize an email sequence, drip campaign, automated email flow, or lifecycle email program. Also use when the user mentions "email sequence," "drip campaign," "nurture sequence," "onboarding emails," "welcome sequence," "re-engagement emails," "email automation," or "lifecycle emails." For in-app onboarding, see onboarding-cro. --- diff --git a/skills/form-cro/SKILL.md b/skills/form-cro/SKILL.md index b502ed3..31cd48e 100644 --- a/skills/form-cro/SKILL.md +++ b/skills/form-cro/SKILL.md @@ -1,5 +1,6 @@ --- name: form-cro +version: 1.0.0 description: When the user wants to optimize any form that is NOT signup/registration — including lead capture forms, contact forms, demo request forms, application forms, survey forms, or checkout forms. Also use when the user mentions "form optimization," "lead form conversions," "form friction," "form fields," "form completion rate," or "contact form." For signup/registration forms, see signup-flow-cro. For popups containing forms, see popup-cro. --- diff --git a/skills/free-tool-strategy/SKILL.md b/skills/free-tool-strategy/SKILL.md index f7f873f..ec78ca6 100644 --- a/skills/free-tool-strategy/SKILL.md +++ b/skills/free-tool-strategy/SKILL.md @@ -1,5 +1,6 @@ --- name: free-tool-strategy +version: 1.0.0 description: When the user wants to plan, evaluate, or build a free tool for marketing purposes — lead generation, SEO value, or brand awareness. Also use when the user mentions "engineering as marketing," "free tool," "marketing tool," "calculator," "generator," "interactive tool," "lead gen tool," "build a tool for leads," or "free resource." This skill bridges engineering and marketing — useful for founders and technical marketers. --- diff --git a/skills/launch-strategy/SKILL.md b/skills/launch-strategy/SKILL.md index bb1a7bb..e974418 100644 --- a/skills/launch-strategy/SKILL.md +++ b/skills/launch-strategy/SKILL.md @@ -1,5 +1,6 @@ --- name: launch-strategy +version: 1.0.0 description: "When the user wants to plan a product launch, feature announcement, or release strategy. Also use when the user mentions 'launch,' 'Product Hunt,' 'feature release,' 'announcement,' 'go-to-market,' 'beta launch,' 'early access,' 'waitlist,' or 'product update.' This skill covers phased launches, channel strategy, and ongoing launch momentum." --- diff --git a/skills/marketing-ideas/SKILL.md b/skills/marketing-ideas/SKILL.md index 0b72bd3..4a066c5 100644 --- a/skills/marketing-ideas/SKILL.md +++ b/skills/marketing-ideas/SKILL.md @@ -1,5 +1,6 @@ --- name: marketing-ideas +version: 1.0.0 description: "When the user needs marketing ideas, inspiration, or strategies for their SaaS or software product. Also use when the user asks for 'marketing ideas,' 'growth ideas,' 'how to market,' 'marketing strategies,' 'marketing tactics,' 'ways to promote,' or 'ideas to grow.' This skill provides 139 proven marketing approaches organized by category." --- diff --git a/skills/marketing-psychology/SKILL.md b/skills/marketing-psychology/SKILL.md index 9e11927..65226ff 100644 --- a/skills/marketing-psychology/SKILL.md +++ b/skills/marketing-psychology/SKILL.md @@ -1,5 +1,6 @@ --- name: marketing-psychology +version: 1.0.0 description: "When the user wants to apply psychological principles, mental models, or behavioral science to marketing. Also use when the user mentions 'psychology,' 'mental models,' 'cognitive bias,' 'persuasion,' 'behavioral science,' 'why people buy,' 'decision-making,' or 'consumer behavior.' This skill provides 70+ mental models organized for marketing application." --- diff --git a/skills/onboarding-cro/SKILL.md b/skills/onboarding-cro/SKILL.md index d9d3264..dadc7ea 100644 --- a/skills/onboarding-cro/SKILL.md +++ b/skills/onboarding-cro/SKILL.md @@ -1,5 +1,6 @@ --- name: onboarding-cro +version: 1.0.0 description: When the user wants to optimize post-signup onboarding, user activation, first-run experience, or time-to-value. Also use when the user mentions "onboarding flow," "activation rate," "user activation," "first-run experience," "empty states," "onboarding checklist," "aha moment," or "new user experience." For signup/registration optimization, see signup-flow-cro. For ongoing email sequences, see email-sequence. --- diff --git a/skills/page-cro/SKILL.md b/skills/page-cro/SKILL.md index 3068750..437761a 100644 --- a/skills/page-cro/SKILL.md +++ b/skills/page-cro/SKILL.md @@ -1,5 +1,6 @@ --- name: page-cro +version: 1.0.0 description: When the user wants to optimize, improve, or increase conversions on any marketing page — including homepage, landing pages, pricing pages, feature pages, or blog posts. Also use when the user says "CRO," "conversion rate optimization," "this page isn't converting," "improve conversions," or "why isn't this page working." For signup/registration flows, see signup-flow-cro. For post-signup activation, see onboarding-cro. For forms outside of signup, see form-cro. For popups/modals, see popup-cro. --- diff --git a/skills/paid-ads/SKILL.md b/skills/paid-ads/SKILL.md index 0264ff4..95010ed 100644 --- a/skills/paid-ads/SKILL.md +++ b/skills/paid-ads/SKILL.md @@ -1,5 +1,6 @@ --- name: paid-ads +version: 1.0.0 description: "When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms. Also use when the user mentions 'PPC,' 'paid media,' 'ad copy,' 'ad creative,' 'ROAS,' 'CPA,' 'ad campaign,' 'retargeting,' or 'audience targeting.' This skill covers campaign strategy, ad creation, audience targeting, and optimization." --- diff --git a/skills/paywall-upgrade-cro/SKILL.md b/skills/paywall-upgrade-cro/SKILL.md index eb608fc..2b18911 100644 --- a/skills/paywall-upgrade-cro/SKILL.md +++ b/skills/paywall-upgrade-cro/SKILL.md @@ -1,5 +1,6 @@ --- name: paywall-upgrade-cro +version: 1.0.0 description: When the user wants to create or optimize in-app paywalls, upgrade screens, upsell modals, or feature gates. Also use when the user mentions "paywall," "upgrade screen," "upgrade modal," "upsell," "feature gate," "convert free to paid," "freemium conversion," "trial expiration screen," "limit reached screen," "plan upgrade prompt," or "in-app pricing." Distinct from public pricing pages (see page-cro) — this skill focuses on in-product upgrade moments where the user has already experienced value. --- diff --git a/skills/popup-cro/SKILL.md b/skills/popup-cro/SKILL.md index 27b7eba..0e37123 100644 --- a/skills/popup-cro/SKILL.md +++ b/skills/popup-cro/SKILL.md @@ -1,5 +1,6 @@ --- name: popup-cro +version: 1.0.0 description: When the user wants to create or optimize popups, modals, overlays, slide-ins, or banners for conversion purposes. Also use when the user mentions "exit intent," "popup conversions," "modal optimization," "lead capture popup," "email popup," "announcement banner," or "overlay." For forms outside of popups, see form-cro. For general page conversion optimization, see page-cro. --- diff --git a/skills/pricing-strategy/SKILL.md b/skills/pricing-strategy/SKILL.md index 01ab0cc..6d7f8fd 100644 --- a/skills/pricing-strategy/SKILL.md +++ b/skills/pricing-strategy/SKILL.md @@ -1,5 +1,6 @@ --- name: pricing-strategy +version: 1.0.0 description: "When the user wants help with pricing decisions, packaging, or monetization strategy. Also use when the user mentions 'pricing,' 'pricing tiers,' 'freemium,' 'free trial,' 'packaging,' 'price increase,' 'value metric,' 'Van Westendorp,' 'willingness to pay,' or 'monetization.' This skill covers pricing research, tier structure, and packaging strategy." --- diff --git a/skills/product-marketing-context/SKILL.md b/skills/product-marketing-context/SKILL.md index 5b590ea..e72d882 100644 --- a/skills/product-marketing-context/SKILL.md +++ b/skills/product-marketing-context/SKILL.md @@ -1,5 +1,6 @@ --- name: product-marketing-context +version: 1.0.0 description: "When the user wants to create or update their product marketing context document. Also use when the user mentions 'product context,' 'marketing context,' 'set up context,' 'positioning,' or wants to avoid repeating foundational information across marketing tasks. Creates `.claude/product-marketing-context.md` that other marketing skills reference." --- diff --git a/skills/programmatic-seo/SKILL.md b/skills/programmatic-seo/SKILL.md index 02ae75e..ee562e8 100644 --- a/skills/programmatic-seo/SKILL.md +++ b/skills/programmatic-seo/SKILL.md @@ -1,5 +1,6 @@ --- name: programmatic-seo +version: 1.0.0 description: When the user wants to create SEO-driven pages at scale using templates and data. Also use when the user mentions "programmatic SEO," "template pages," "pages at scale," "directory pages," "location pages," "[keyword] + [city] pages," "comparison pages," "integration pages," or "building many pages for SEO." For auditing existing SEO issues, see seo-audit. --- diff --git a/skills/referral-program/SKILL.md b/skills/referral-program/SKILL.md index b1bc23b..1e540f8 100644 --- a/skills/referral-program/SKILL.md +++ b/skills/referral-program/SKILL.md @@ -1,5 +1,6 @@ --- name: referral-program +version: 1.0.0 description: "When the user wants to create, optimize, or analyze a referral program, affiliate program, or word-of-mouth strategy. Also use when the user mentions 'referral,' 'affiliate,' 'ambassador,' 'word of mouth,' 'viral loop,' 'refer a friend,' or 'partner program.' This skill covers program design, incentive structure, and growth optimization." --- diff --git a/skills/schema-markup/SKILL.md b/skills/schema-markup/SKILL.md index d3c8ecd..04434ec 100644 --- a/skills/schema-markup/SKILL.md +++ b/skills/schema-markup/SKILL.md @@ -1,5 +1,6 @@ --- name: schema-markup +version: 1.0.0 description: When the user wants to add, fix, or optimize schema markup and structured data on their site. Also use when the user mentions "schema markup," "structured data," "JSON-LD," "rich snippets," "schema.org," "FAQ schema," "product schema," "review schema," or "breadcrumb schema." For broader SEO issues, see seo-audit. --- diff --git a/skills/seo-audit/SKILL.md b/skills/seo-audit/SKILL.md index 474910d..0e5b372 100644 --- a/skills/seo-audit/SKILL.md +++ b/skills/seo-audit/SKILL.md @@ -1,5 +1,6 @@ --- name: seo-audit +version: 1.0.0 description: When the user wants to audit, review, or diagnose SEO issues on their site. Also use when the user mentions "SEO audit," "technical SEO," "why am I not ranking," "SEO issues," "on-page SEO," "meta tags review," or "SEO health check." For building pages at scale to target keywords, see programmatic-seo. For adding structured data, see schema-markup. --- diff --git a/skills/signup-flow-cro/SKILL.md b/skills/signup-flow-cro/SKILL.md index aca5e1e..5071107 100644 --- a/skills/signup-flow-cro/SKILL.md +++ b/skills/signup-flow-cro/SKILL.md @@ -1,5 +1,6 @@ --- name: signup-flow-cro +version: 1.0.0 description: When the user wants to optimize signup, registration, account creation, or trial activation flows. Also use when the user mentions "signup conversions," "registration friction," "signup form optimization," "free trial signup," "reduce signup dropoff," or "account creation flow." For post-signup onboarding, see onboarding-cro. For lead capture forms (not account creation), see form-cro. --- diff --git a/skills/social-content/SKILL.md b/skills/social-content/SKILL.md index 42088d4..ef019c4 100644 --- a/skills/social-content/SKILL.md +++ b/skills/social-content/SKILL.md @@ -1,5 +1,6 @@ --- name: social-content +version: 1.0.0 description: "When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, Facebook, or other platforms. Also use when the user mentions 'LinkedIn post,' 'Twitter thread,' 'social media,' 'content calendar,' 'social scheduling,' 'engagement,' or 'viral content.' This skill covers content creation, repurposing, and platform-specific strategies." ---