Optimize skill files for AI agent use with progressive disclosure

- Fix marketplace.json: add 2 missing skills (content-strategy, product-marketing-context)
- Refactor 10 skills over 500 lines to use references/ folders:
  - email-sequence: 926 → 291 lines
  - social-content: 809 → 276 lines
  - competitor-alternatives: 750 → 253 lines
  - pricing-strategy: 712 → 226 lines
  - programmatic-seo: 628 → 235 lines
  - referral-program: 604 → 239 lines
  - schema-markup: 598 → 175 lines
  - free-tool-strategy: 576 → 176 lines
  - paywall-upgrade-cro: 572 → 224 lines
  - marketing-ideas: 566 → 165 lines

Each skill now has core workflow in SKILL.md (<500 lines) with detailed
content in references/ folder for progressive disclosure.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Corey Haines
2026-01-26 16:39:45 -08:00
parent becdd54cf9
commit c29ee7e6db
28 changed files with 4381 additions and 5100 deletions

View File

@@ -14,21 +14,11 @@ If `.claude/product-marketing-context.md` exists, read it before asking question
Before designing a tool strategy, understand:
1. **Business Context**
- What's the core product/service?
- Who is the target audience?
- What problems do they have?
1. **Business Context** - What's the core product? Who is the target audience? What problems do they have?
2. **Goals**
- Lead generation primary goal?
- SEO/traffic acquisition?
- Brand awareness?
- Product education?
2. **Goals** - Lead generation? SEO/traffic? Brand awareness? Product education?
3. **Resources**
- Technical capacity to build?
- Ongoing maintenance bandwidth?
- Budget for promotion?
3. **Resources** - Technical capacity to build? Ongoing maintenance bandwidth? Budget for promotion?
---
@@ -51,114 +41,21 @@ Before designing a tool strategy, understand:
### 4. Worth the Investment
- Lead value × expected leads > build cost + maintenance
- Consider SEO value
- Consider brand halo effect
---
## Tool Types
## Tool Types Overview
### Calculators
| Type | Examples | Best For |
|------|----------|----------|
| Calculators | ROI, savings, pricing estimators | Decisions involving numbers |
| Generators | Templates, policies, names | Creating something quickly |
| Analyzers | Website graders, SEO auditors | Evaluating existing work |
| Testers | Meta tag preview, speed tests | Checking if something works |
| Libraries | Icon sets, templates, snippets | Reference material |
| Interactive | Tutorials, playgrounds, quizzes | Learning/understanding |
**Best for**: Decisions involving numbers, comparisons, estimates
**Examples**:
- ROI calculator
- Savings calculator
- Cost comparison tool
- Salary calculator
- Tax estimator
**Why they work**:
- Personalized output
- High perceived value
- Share-worthy results
- Clear problem → solution
### Generators
**Best for**: Creating something useful quickly
**Examples**:
- Policy generator
- Template generator
- Name/tagline generator
- Email subject line generator
- Resume builder
**Why they work**:
- Tangible output
- Saves time
- Easily shared
- Repeat usage
### Analyzers/Auditors
**Best for**: Evaluating existing work or assets
**Examples**:
- Website grader
- SEO analyzer
- Email subject tester
- Headline analyzer
- Security checker
**Why they work**:
- Curiosity-driven
- Personalized insights
- Creates awareness of problems
- Natural lead to solution
### Testers/Validators
**Best for**: Checking if something works
**Examples**:
- Meta tag preview
- Email rendering test
- Accessibility checker
- Mobile-friendly test
- Speed test
**Why they work**:
- Immediate utility
- Bookmark-worthy
- Repeat usage
- Professional necessity
### Libraries/Resources
**Best for**: Reference material
**Examples**:
- Icon library
- Template library
- Code snippet library
- Example gallery
- Directory
**Why they work**:
- High SEO value
- Ongoing traffic
- Establishes authority
- Linkable asset
### Interactive Educational
**Best for**: Learning/understanding
**Examples**:
- Interactive tutorials
- Code playgrounds
- Visual explainers
- Quizzes/assessments
- Simulators
**Why they work**:
- Engages deeply
- Demonstrates expertise
- Shareable
- Memory-creating
**For detailed tool types and examples**: See [references/tool-types.md](references/tool-types.md)
---
@@ -166,277 +63,84 @@ Before designing a tool strategy, understand:
### Start with Pain Points
1. **What problems does your audience Google?**
- Search query research
- Common questions
- "How to" searches
1. **What problems does your audience Google?** - Search query research, common questions
2. **What manual processes are tedious?**
- Tasks done in spreadsheets
- Repetitive calculations
- Copy-paste workflows
2. **What manual processes are tedious?** - Spreadsheet tasks, repetitive calculations
3. **What do they need before buying your product?**
- Assessments of current state
- Planning/scoping
- Comparisons
3. **What do they need before buying your product?** - Assessments, planning, comparisons
4. **What information do they wish they had?**
- Data they can't easily access
- Personalized insights
- Industry benchmarks
4. **What information do they wish they had?** - Data they can't easily access, benchmarks
### Validate the Idea
**Search demand:**
- Is there search volume for this problem?
- What keywords would rank?
- How competitive?
- **Search demand**: Is there search volume? How competitive?
- **Uniqueness**: What exists? How can you be 10x better?
- **Lead quality**: Does this audience match buyers?
- **Build feasibility**: How complex? Can you scope an MVP?
**Uniqueness:**
- What exists already?
- How can you be 10x better or different?
- What's your unique angle?
---
**Lead quality:**
- Does this problem-audience match buyers?
- Will users be your target customers?
- Is there a natural path to your product?
## Lead Capture Strategy
**Build feasibility:**
- How complex to build?
- Can you scope an MVP?
- Ongoing maintenance burden?
### Gating Options
| Approach | Pros | Cons |
|----------|------|------|
| Fully gated | Maximum capture | Lower usage |
| Partially gated | Balance of both | Common pattern |
| Ungated + optional | Maximum reach | Lower capture |
| Ungated entirely | Pure SEO/brand | No direct leads |
### Lead Capture Best Practices
- Value exchange clear: "Get your full report"
- Minimal friction: Email only
- Show preview of what they'll get
- Optional: Segment by asking one qualifying question
---
## SEO Considerations
### Keyword Strategy
**Tool landing page**: "[thing] calculator", "[thing] generator", "free [tool type]"
**Tool landing page:**
- "[thing] calculator"
- "[thing] generator"
- "free [tool type]"
- "[industry] [tool type]"
**Supporting content:**
- "How to [use case]"
- "What is [concept tool helps with]"
- Blog posts that link to tool
**Supporting content**: "How to [use case]", "What is [concept]"
### Link Building
Free tools attract links because:
- Genuinely useful (people reference them)
- Unique (can't link to just any page)
- Shareable (social amplification)
**Outreach opportunities:**
- Roundup posts ("best free tools for X")
- Resource pages
- Industry publications
- Blogs writing about the problem
### Technical SEO
- Fast load time critical
- Mobile-friendly essential
- Crawlable content (not just JS app)
- Proper meta tags
- Schema markup if applicable
---
## Lead Capture Strategy
### When to Gate
**Fully gated (email required to use):**
- High-value, unique tools
- Personalized reports
- Risk: Lower usage
**Partially gated (email for full results):**
- Show preview, gate details
- Better balance
- Most common pattern
**Ungated with optional capture:**
- Tool is free to use
- Email to save/share results
- Highest usage, lower capture
**Ungated entirely:**
- Pure SEO/brand play
- No direct leads
- Maximum reach
### Lead Capture Best Practices
- Value exchange clear: "Get your full report"
- Minimal friction: Email only
- Show preview of what they'll get
- Optional: Segment by asking one qualifying question
### Post-Capture
- Immediate email with results/link
- Nurture sequence relevant to tool topic
- Clear path to main product
- Don't spam—provide value
---
## Build vs. Buy vs. Embed
## Build vs. Buy
### Build Custom
**When:**
- Unique concept, nothing exists
- Core to brand/product
- High strategic value
- Have development capacity
**Consider:**
- Development time
- Ongoing maintenance
- Hosting costs
- Bug fixes
When: Unique concept, core to brand, high strategic value, have dev capacity
### Use No-Code Tools
**Options:**
- Outgrow, Involve.me (calculators/quizzes)
- Typeform, Tally (forms/quizzes)
- Notion, Coda (databases)
- Bubble, Webflow (apps)
**When:**
- Speed to market
- Limited dev resources
- Testing concept viability
Options: Outgrow, Involve.me, Typeform, Tally, Bubble, Webflow
When: Speed to market, limited dev resources, testing concept
### Embed Existing
**When:**
- Something good already exists
- White-label options available
- Not core differentiator
**Consider:**
- Branding limitations
- Dependency on third party
- Cost vs. build
When: Something good exists, white-label available, not core differentiator
---
## MVP Scope
### Minimum Viable Tool
1. **Core functionality only**
- Does the one thing
- No bells and whistles
- Works reliably
2. **Essential UX**
- Clear input
- Obvious output
- Mobile works
3. **Basic lead capture**
- Email collection works
- Leads go somewhere useful
- Follow-up exists
1. Core functionality only—does the one thing, works reliably
2. Essential UX—clear input, obvious output, mobile works
3. Basic lead capture—email collection, leads go somewhere useful
### What to Skip Initially
- Account creation
- Saving results
- Advanced features
- Perfect design
- Every edge case
### Iterate Based on Use
- Track where users drop off
- See what questions they have
- Add features that get requested
- Improve based on data
Account creation, saving results, advanced features, perfect design, every edge case
---
## Promotion Strategy
### Launch
**Owned channels:**
- Email list announcement
- Blog post / landing page
- Social media
- Product hunt (if applicable)
**Outreach:**
- Relevant newsletters
- Industry publications
- Bloggers in space
- Social influencers
### Ongoing
**SEO:**
- Target tool-related keywords
- Supporting content
- Link building
**Social:**
- Share interesting results (anonymized)
- Use case examples
- Tips for using the tool
**Product integration:**
- Mention in sales process
- Link from related product features
- Include in email sequences
---
## Measurement
### Metrics to Track
**Acquisition:**
- Traffic to tool
- Traffic sources
- Keyword rankings
- Backlinks acquired
**Engagement:**
- Tool usage/completions
- Time spent
- Return visitors
- Shares
**Conversion:**
- Email captures
- Lead quality score
- MQLs generated
- Pipeline influenced
- Customers attributed
### Attribution
- UTM parameters for paid promotion
- Separate landing page for organic
- Track lead source through funnel
- Survey new customers
---
## Evaluation Framework
### Tool Idea Scorecard
## Evaluation Scorecard
Rate each factor 1-5:
@@ -444,123 +148,20 @@ Rate each factor 1-5:
|--------|-------|
| Search demand exists | ___ |
| Audience match to buyers | ___ |
| Uniqueness vs. existing tools | ___ |
| Uniqueness vs. existing | ___ |
| Natural path to product | ___ |
| Build feasibility | ___ |
| Maintenance burden (inverse) | ___ |
| Link-building potential | ___ |
| Share-worthiness | ___ |
**25+**: Strong candidate
**15-24**: Promising, needs refinement
**<15**: Reconsider or scope differently
### ROI Projection
```
Estimated monthly leads: [X]
Lead-to-customer rate: [Y%]
Average customer value: [$Z]
Monthly value: X × Y% × $Z = $___
Build cost: $___
Monthly maintenance: $___
Payback period: Build cost / (Monthly value - Monthly maintenance)
```
---
## Output Format
### Tool Strategy Document
```
# Free Tool Strategy: [Tool Name]
## Concept
[What it does in one paragraph]
## Target Audience
[Who uses it, what problem it solves]
## Lead Generation Fit
[How this connects to your product/sales]
## SEO Opportunity
- Target keywords: [list]
- Search volume: [estimate]
- Competition: [assessment]
## Build Approach
- Custom / No-code / Embed
- MVP scope: [core features]
- Estimated effort: [time/cost]
## Lead Capture Strategy
- Gating approach: [Full/Partial/Ungated]
- Capture mechanism: [description]
- Follow-up sequence: [outline]
## Success Metrics
- [Metric 1]: [Target]
- [Metric 2]: [Target]
## Promotion Plan
- Launch: [channels]
- Ongoing: [strategy]
## Timeline
- Phase 1: [scope] - [timeframe]
- Phase 2: [scope] - [timeframe]
```
### Implementation Spec
If moving forward with build
### Promotion Plan
Detailed launch and ongoing strategy
---
## Example Tool Concepts by Business Type
### SaaS Product
- Product ROI calculator
- Competitor comparison tool
- Readiness assessment quiz
- Template library for use case
### Agency/Services
- Industry benchmark tool
- Project scoping calculator
- Portfolio review tool
- Cost estimator
### E-commerce
- Product finder quiz
- Comparison tool
- Size/fit calculator
- Savings calculator
### Developer Tools
- Code snippet library
- Testing/preview tool
- Documentation generator
- Interactive tutorials
### Finance
- Financial calculators
- Investment comparison
- Budget planner
- Tax estimator
**25+**: Strong candidate | **15-24**: Promising | **<15**: Reconsider
---
## Task-Specific Questions
1. What existing tools do they use for workarounds?
1. What existing tools does your audience use for workarounds?
2. How do you currently generate leads?
3. What technical resources are available?
4. What's the timeline and budget?
@@ -573,4 +174,3 @@ Detailed launch and ongoing strategy
- **seo-audit**: For SEO-optimizing the tool
- **analytics-tracking**: For measuring tool usage
- **email-sequence**: For nurturing leads from the tool
- **programmatic-seo**: For building tool-based pages at scale

View File

@@ -0,0 +1,208 @@
# Free Tool Types Reference
Detailed guide to each type of marketing tool you can build.
## Calculators
**Best for**: Decisions involving numbers, comparisons, estimates
**Examples**:
- ROI calculator
- Savings calculator
- Cost comparison tool
- Salary calculator
- Tax estimator
- Pricing estimator
- Compound interest calculator
- Break-even calculator
**Why they work**:
- Personalized output
- High perceived value
- Share-worthy results
- Clear problem → solution
**Implementation tips**:
- Keep inputs simple
- Show calculations transparently
- Make results shareable
- Add "powered by" branding
---
## Generators
**Best for**: Creating something useful quickly
**Examples**:
- Policy generator (privacy, terms)
- Template generator
- Name/tagline generator
- Email subject line generator
- Resume builder
- Color palette generator
- Logo maker
- Contract generator
**Why they work**:
- Tangible output
- Saves time
- Easily shared
- Repeat usage
**Implementation tips**:
- Output should be immediately usable
- Allow customization
- Offer download/export options
- Include email gating for premium outputs
---
## Analyzers/Auditors
**Best for**: Evaluating existing work or assets
**Examples**:
- Website grader
- SEO analyzer
- Email subject tester
- Headline analyzer
- Security checker
- Performance auditor
- Accessibility checker
- Code quality analyzer
**Why they work**:
- Curiosity-driven
- Personalized insights
- Creates awareness of problems
- Natural lead to solution
**Implementation tips**:
- Score or grade for gamification
- Benchmark against averages
- Provide actionable recommendations
- Follow up with improvement offers
---
## Testers/Validators
**Best for**: Checking if something works
**Examples**:
- Meta tag preview
- Email rendering test
- Mobile-friendly test
- Speed test
- DNS checker
- SSL certificate checker
- Redirect checker
- Broken link finder
**Why they work**:
- Immediate utility
- Bookmark-worthy
- Repeat usage
- Professional necessity
**Implementation tips**:
- Fast results are essential
- Show pass/fail clearly
- Provide fix instructions
- Integrate with your product where relevant
---
## Libraries/Resources
**Best for**: Reference material
**Examples**:
- Icon library
- Template library
- Code snippet library
- Example gallery
- Industry directory
- Resource list
- Swipe file collection
- Font pairing tool
**Why they work**:
- High SEO value
- Ongoing traffic
- Establishes authority
- Linkable asset
**Implementation tips**:
- Make searchable/filterable
- Allow easy copying/downloading
- Update regularly
- Accept community submissions
---
## Interactive Educational
**Best for**: Learning/understanding
**Examples**:
- Interactive tutorials
- Code playgrounds
- Visual explainers
- Quizzes/assessments
- Simulators
- Comparison tools
- Decision trees
- Configurators
**Why they work**:
- Engages deeply
- Demonstrates expertise
- Shareable
- Memory-creating
**Implementation tips**:
- Make it hands-on
- Show immediate feedback
- Lead to deeper resources
- Capture engaged users
---
## Tool Concept Examples by Industry
### SaaS Product
- Product ROI calculator
- Competitor comparison tool
- Readiness assessment quiz
- Template library for use case
- Feature configurator
### Agency/Services
- Industry benchmark tool
- Project scoping calculator
- Portfolio review tool
- Cost estimator
- Proposal generator
### E-commerce
- Product finder quiz
- Comparison tool
- Size/fit calculator
- Savings calculator
- Gift finder
### Developer Tools
- Code snippet library
- Testing/preview tool
- Documentation generator
- Interactive tutorials
- API playground
### Finance
- Financial calculators
- Investment comparison
- Budget planner
- Tax estimator
- Loan calculator