feat: v2.0 skill renames and CRO consolidation (#291)
* feat: v2.0 skill renames and CRO consolidation BREAKING CHANGE: Users must reinstall skills after this update. ## Skill Renames (16) - 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 - 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 in references/form.md) ## Why 2.0? - Shorter, cleaner skill names - Consistent naming (no -strategy, -setup, -cro suffixes) - All cross-references updated across 100+ files Total skills: 40 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * fix(v2.0): update evals for renamed skills, fix validate script, clear warnings - Update 32 evals.json files to reference new skill names (page-cro → cro, product-marketing-context → product-marketing, etc.) — these were missed in the initial v2.0 rename pass since only SKILL.md and marketplace.json were updated. - Fix validate-skills.sh: replace GNU-only `head -n -1` with portable awk so frontmatter extraction works on macOS. - Move Copy Editing Checklist (56 lines) to references/checklist.md to bring copy-editing SKILL.md under the 500-line limit (508 → 457). - Add "see X" pointers to marketing-psychology description for skill discovery (cro, pricing, copywriting). - Update skill-request.yml issue template placeholder (page-cro → cro). All 40 skills now pass validation with zero warnings. * fix(v2.0): add evals for 8 missing skills, strip stale frontmatter from cro/form.md Adds 48 new eval cases (6 per skill) for skills that previously had no evals: aso, co-marketing, community-marketing, competitor-profiling, directory-submissions, image, lead-magnets, video. All 40 skills now have eval coverage (251 total cases). Strips leftover frontmatter from skills/cro/references/form.md — it was inherited from the old form-cro SKILL.md before consolidation. Reference files don't need frontmatter. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com> * fix(v2.0): rename paid-ads → ads One more v2.0 simplification — drops the redundant 'paid-' qualifier. Updates the skill directory, SKILL.md frontmatter, evals.json, README skill table, the v2.0 rename table in VERSIONS.md (now 17 renames), and all cross-references in related skills (ad-creative, aso, competitor-profiling, customer-research, lead-magnets, marketing-ideas) plus the tools/integrations guides. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com> * fix(v2.0): bump SKILL.md frontmatter version to 2.0.0 for all 40 skills VERSIONS.md was already updated to 2.0.0 but the metadata.version field inside each SKILL.md was still on 1.x. That mismatch would have caused the update-check flow to perpetually report 'update available' since it compares VERSIONS.md against local SKILL.md metadata versions. Caught by codex review (P1). Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com> * fix(v2.0): add legacy product-marketing-context.md filename fallback Before this fix, users upgrading from v1.x who had a `product-marketing-context.md` file would lose automatic context loading — every skill only checked the new `product-marketing.md` filename. Now all 40 skills also accept the legacy filename (in either `.agents/` or `.claude/`), and the README migration command covers both legacy and current filenames. Caught by codex review (P1 + P2). Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com> * fix(v2.0): re-sort README skills table alphabetically, fix ads box width The skills table had a few entries out of alphabetical order from the renames (co-marketing was after cold-email, ads was at the renamed position). Re-sorted alphabetically per sync-skills.js. Also padded the 'ads' cell in the ASCII flow diagram to keep the box width consistent. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com> * fix(v2.0): document folder cleanup on upgrade, stop sync-skills from re-adding skills array README upgrade guide now includes: - A clear cleanup step for stale v1.x skill folders (renamed + consolidated) so users don't end up with both old and new folders side-by-side after upgrading - The full v1 to v2 rename map for reference - Existing product-marketing-context.md migration steps (preserved) sync-skills.js no longer (re-)introduces a `skills` array on marketplace.json -- Claude Code's plugin schema discovers skills via the `skills/` directory, and the explicit array was failing validation. The script now refreshes the description count and strips the stale array if present. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Corey Haines
@@ -1,8 +1,8 @@
|
||||
---
|
||||
name: lead-magnets
|
||||
description: When the user wants to create, plan, or optimize a lead magnet for email capture or lead generation. Also use when the user mentions "lead magnet," "gated content," "content upgrade," "downloadable," "ebook," "cheat sheet," "checklist," "template download," "opt-in," "freebie," "PDF download," "resource library," "content offer," "email capture content," "Notion template," "spreadsheet template," or "what should I give away for emails." Use this for planning what to create and how to distribute it. For interactive tools as lead magnets, see free-tool-strategy. For writing the actual content, see copywriting. For the email sequence after capture, see email-sequence.
|
||||
description: When the user wants to create, plan, or optimize a lead magnet for email capture or lead generation. Also use when the user mentions "lead magnet," "gated content," "content upgrade," "downloadable," "ebook," "cheat sheet," "checklist," "template download," "opt-in," "freebie," "PDF download," "resource library," "content offer," "email capture content," "Notion template," "spreadsheet template," or "what should I give away for emails." Use this for planning what to create and how to distribute it. For interactive tools as lead magnets, see free-tools. For writing the actual content, see copywriting. For the email sequence after capture, see emails.
|
||||
metadata:
|
||||
version: 1.0.0
|
||||
version: 2.0.0
|
||||
---
|
||||
|
||||
# Lead Magnets
|
||||
@@ -12,7 +12,7 @@ You are an expert in lead magnet strategy. Your goal is to help plan lead magnet
|
||||
## Before Planning
|
||||
|
||||
**Check for product marketing context first:**
|
||||
If `.agents/product-marketing-context.md` exists (or `.claude/product-marketing-context.md` in older setups), read it before asking questions. Use that context and only ask for information not already covered or specific to this task.
|
||||
If `.agents/product-marketing.md` exists (or `.claude/product-marketing.md`, or the legacy `product-marketing-context.md` filename, in older setups), read it before asking questions. Use that context and only ask for information not already covered or specific to this task.
|
||||
|
||||
Gather this context (ask if not provided):
|
||||
|
||||
@@ -116,7 +116,7 @@ Goal: Help implement. Remove friction to purchase.
|
||||
| Template | "Ready-to-Use Sales Email Templates" |
|
||||
| Free trial | "14-Day Free Trial" |
|
||||
| Implementation guide | "Migration Checklist: Switch in 30 Minutes" |
|
||||
| ROI calculator | "Calculate Your Savings" (→ see **free-tool-strategy**) |
|
||||
| ROI calculator | "Calculate Your Savings" (→ see **free-tools**) |
|
||||
|
||||
---
|
||||
|
||||
@@ -147,8 +147,8 @@ Rule of thumb: Ask for the minimum needed. Every extra field reduces conversion
|
||||
- Add social proof: "Downloaded by 5,000+ marketers"
|
||||
- Reduce risk: "No spam. Unsubscribe anytime."
|
||||
|
||||
**For form optimization**: See **form-cro** skill
|
||||
**For popup implementation**: See **popup-cro** skill
|
||||
**For form optimization**: See **cro** skill
|
||||
**For popup implementation**: See **popups** skill
|
||||
|
||||
---
|
||||
|
||||
@@ -163,7 +163,7 @@ Rule of thumb: Ask for the minimum needed. Every extra field reduces conversion
|
||||
5. **Form** — Minimal fields, clear CTA button
|
||||
6. **FAQ** — Address hesitations (Is it really free? What format?)
|
||||
|
||||
**For landing page optimization**: See **page-cro** skill
|
||||
**For landing page optimization**: See **cro** skill
|
||||
|
||||
### Delivery Methods
|
||||
|
||||
@@ -196,14 +196,14 @@ Don't waste the thank you page. After they've converted:
|
||||
|
||||
- Trigger on exit intent or scroll depth
|
||||
- Match the popup offer to the page content
|
||||
- **See popup-cro** for implementation
|
||||
- **See popups** for implementation
|
||||
|
||||
### Social Media
|
||||
|
||||
- Share snippets and teasers from the lead magnet
|
||||
- Create carousel posts from key points
|
||||
- Use the lead magnet as the CTA in your bio/profile
|
||||
- **See social-content** for social strategy
|
||||
- **See social** for social strategy
|
||||
|
||||
### Paid Promotion
|
||||
|
||||
@@ -211,7 +211,7 @@ Don't waste the thank you page. After they've converted:
|
||||
- Google Ads for high-intent lead magnets (templates, tools)
|
||||
- LinkedIn for B2B lead magnets
|
||||
- Retarget blog visitors with lead magnet ads
|
||||
- **See paid-ads** for campaign strategy
|
||||
- **See ads** for campaign strategy
|
||||
|
||||
### Partner Co-Promotion
|
||||
|
||||
@@ -298,13 +298,13 @@ When creating a lead magnet strategy, provide:
|
||||
|
||||
## Related Skills
|
||||
|
||||
- **free-tool-strategy**: For interactive tools as lead magnets (calculators, graders, quizzes)
|
||||
- **free-tools**: For interactive tools as lead magnets (calculators, graders, quizzes)
|
||||
- **copywriting**: For writing the lead magnet content itself
|
||||
- **email-sequence**: For nurture sequences after lead capture
|
||||
- **page-cro**: For optimizing lead magnet landing pages
|
||||
- **popup-cro**: For popup-based lead capture
|
||||
- **form-cro**: For optimizing capture forms
|
||||
- **emails**: For nurture sequences after lead capture
|
||||
- **cro**: For optimizing lead magnet landing pages
|
||||
- **popups**: For popup-based lead capture
|
||||
- **cro**: For optimizing capture forms
|
||||
- **content-strategy**: For content planning and topic selection
|
||||
- **analytics-tracking**: For measuring lead magnet performance
|
||||
- **paid-ads**: For paid promotion of lead magnets
|
||||
- **social-content**: For social media promotion
|
||||
- **analytics**: For measuring lead magnet performance
|
||||
- **ads**: For paid promotion of lead magnets
|
||||
- **social**: For social media promotion
|
||||
|
||||
@@ -0,0 +1,87 @@
|
||||
{
|
||||
"skill_name": "lead-magnets",
|
||||
"evals": [
|
||||
{
|
||||
"id": 1,
|
||||
"prompt": "We're a B2B SaaS selling project management software to marketing agencies. What lead magnet should we create?",
|
||||
"expected_output": "Should check for product-marketing.md first. Should ask about current lead gen, existing content assets, and primary goal (list growth, lead quality, product education). Should apply Lead Magnet Principles: solve a specific problem (not 'agency marketing'), match buyer stage, high perceived value + low time investment, natural path to product. Should recommend a specific format suited to a busy agency audience — likely a template (Notion/spreadsheet) or checklist over an ebook. Examples: 'Agency Project Profitability Calculator' (decision stage, naturally leads to project management), 'Client Onboarding Checklist for Agencies' (consideration), 'The Agency Capacity Planning Template' (decision stage). Should justify the choice by matching buyer stage and effort/value ratio. Should outline content, gating, landing page, distribution, and measurement plan.",
|
||||
"assertions": [
|
||||
"Checks for product-marketing.md",
|
||||
"Asks about buyer stage and goal",
|
||||
"Applies the 5 principles",
|
||||
"Recommends specific format with rationale",
|
||||
"Examples match the audience and product",
|
||||
"Outlines all 5 output sections (recommendation, content, gating, distribution, measurement)"
|
||||
],
|
||||
"files": []
|
||||
},
|
||||
{
|
||||
"id": 2,
|
||||
"prompt": "We have a 50-page ebook we spent 3 months writing. Conversion on the landing page is only 4%. Should we keep iterating?",
|
||||
"expected_output": "Should diagnose this as a likely mismatch on Lead Magnet Principles, especially #3 (high perceived value, low time investment — consumable in under 30 minutes, ideally under 10). Should warn 50 pages may signal too much effort to consume — flag this as a possible cause. Should recommend A/B testing the format (chunking the ebook into a 5-part email mini-course, releasing as a checklist + ebook combo, or breaking into shorter topic-specific guides). Should review landing page structure: headline, preview/mockup, what's inside, social proof, form fields, FAQ. Should suggest testing partial gate (preview first 5 pages) vs full gate. Should ask about traffic source — 4% on cold traffic might be acceptable while 4% on warm traffic is low. Should reference cro skill for landing page optimization and ab-testing for test design.",
|
||||
"assertions": [
|
||||
"Diagnoses likely cause as length/effort mismatch",
|
||||
"Recommends format A/B test",
|
||||
"Suggests breaking into shorter formats",
|
||||
"Reviews landing page structure",
|
||||
"Asks about traffic source (cold vs warm)",
|
||||
"Cross-references cro or ab-testing skill"
|
||||
],
|
||||
"files": []
|
||||
},
|
||||
{
|
||||
"id": 3,
|
||||
"prompt": "Our lead form asks for name, email, company, role, company size, and phone. We're not getting enough signups. Could the form be the problem?",
|
||||
"expected_output": "Should immediately flag form length as a likely culprit. Should cite the rule of thumb: every extra field reduces conversion 5-10%. Should recommend reducing to the minimum needed: ideally email only (highest conversion), or email + name if personalization matters. Should explain when multi-field is justified (only for high-value offers like webinars or demos). Should ask what information is actually used in follow-up — fields that aren't used should be removed. Should suggest progressive profiling: capture email now, ask for more fields later via enrichment or follow-up forms. Should reference cro skill for form optimization specifically.",
|
||||
"assertions": [
|
||||
"Flags form length as likely culprit",
|
||||
"Cites 5-10% per field rule",
|
||||
"Recommends reducing to email or email + name",
|
||||
"Asks what fields are actually used",
|
||||
"Suggests progressive profiling",
|
||||
"Cross-references cro skill"
|
||||
],
|
||||
"files": []
|
||||
},
|
||||
{
|
||||
"id": 4,
|
||||
"prompt": "What's the difference between a lead magnet and a free tool? Should I build one or the other?",
|
||||
"expected_output": "Should explain the distinction: lead magnets are static content offers (ebooks, checklists, templates) while free tools are interactive (calculators, graders, quizzes). Should explain when to build which. Lead magnets: faster to ship (hours-days), works well for awareness/consideration education, lower ongoing maintenance, lead quality varies. Free tools: longer build time (weeks-months), higher engagement and shareability, naturally segment leads by tool usage, can rank for SEO ('X calculator', 'Y grader'), higher lead quality typically. Should recommend lead magnet first if speed matters, free tool if you can invest the build time and have repeatable user inputs that produce a meaningful output. Should defer to free-tools skill for tool strategy specifically.",
|
||||
"assertions": [
|
||||
"Distinguishes static content from interactive tool",
|
||||
"Compares effort to build",
|
||||
"Compares SEO and shareability characteristics",
|
||||
"Recommends based on speed vs investment trade-off",
|
||||
"Defers to free-tools skill"
|
||||
],
|
||||
"files": []
|
||||
},
|
||||
{
|
||||
"id": 5,
|
||||
"prompt": "We have a top-performing blog post on email subject lines. Can we use it as a lead magnet?",
|
||||
"expected_output": "Should recommend creating a content upgrade specific to the post rather than gating the post itself (post-specific content upgrades convert 2-5x better than generic sidebar CTAs). Should suggest specific upgrade ideas: '50 Email Subject Line Templates' (template format, decision stage), 'Subject Line Cheat Sheet PDF' (cheat sheet format, awareness/consideration), 'Subject Line Swipe File' (collection of high-performing examples with annotations). Should explain content upgrades convert better because they match what the reader is already engaged with — relevance + intent are higher than generic offers. Should recommend keeping the blog post ungated (preserve SEO) and offering the upgrade as an inline or end-of-post CTA. Should reference cro for placement and copywriting for the upgrade itself.",
|
||||
"assertions": [
|
||||
"Recommends content upgrade over gating the post",
|
||||
"Cites 2-5x improvement vs generic CTAs",
|
||||
"Suggests specific upgrade formats with rationale",
|
||||
"Keeps blog post ungated to preserve SEO",
|
||||
"Explains why upgrades convert better"
|
||||
],
|
||||
"files": []
|
||||
},
|
||||
{
|
||||
"id": 6,
|
||||
"prompt": "Our checklist gets a lot of downloads but very few of them ever sign up for a trial. Is the lead magnet broken?",
|
||||
"expected_output": "Should diagnose this as a lead quality / buyer stage mismatch problem. Should ask whether the checklist is awareness-stage content drawing people who aren't ready to buy. Should check Lead Quality Signals: higher-than-average email engagement, leads progress to trial/demo at expected rates, low unsubscribe rate, leads match ICP demographics. Should review the principle: lead magnets should create a natural path to product. If a checklist for total beginners attracts beginners, that's working as designed but they won't convert quickly — they need nurture. Should recommend reviewing the nurture sequence (cross-reference emails skill) and checking whether the offer matches the right buyer stage for the goal. May suggest creating a consideration- or decision-stage lead magnet (template, ROI calculator, comparison spreadsheet) that pulls higher-intent leads. Should track time to conversion by lead magnet source.",
|
||||
"assertions": [
|
||||
"Diagnoses as lead quality / buyer stage mismatch",
|
||||
"Asks about ICP fit of leads",
|
||||
"References Lead Quality Signals",
|
||||
"Cross-references emails skill for nurture",
|
||||
"Suggests a decision-stage lead magnet alternative",
|
||||
"Mentions tracking time to conversion by source"
|
||||
],
|
||||
"files": []
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -171,7 +171,7 @@ Detailed creation guidance for each lead magnet format.
|
||||
|
||||
**Implementation**: Gate results behind email capture. The quiz itself is ungated — the personalized results require an email.
|
||||
|
||||
**For building interactive quizzes**: See **free-tool-strategy** skill for technical implementation guidance.
|
||||
**For building interactive quizzes**: See **free-tools** skill for technical implementation guidance.
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user