Files

Corey Haines c29ee7e6db 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>

2026-01-26 16:39:45 -08:00

4.8 KiB

Raw Blame History

Content Architecture for Competitor Pages

How to structure and maintain competitor data for scalable comparison pages.

Centralized Competitor Data

Create a single source of truth for each competitor:

competitor_data/
├── notion.md
├── airtable.md
├── monday.md
└── ...

Competitor Data Template

Per competitor, document:

name: Notion
website: notion.so
tagline: "The all-in-one workspace"
founded: 2016
headquarters: San Francisco

# Positioning
primary_use_case: "docs + light databases"
target_audience: "teams wanting flexible workspace"
market_position: "premium, feature-rich"

# Pricing
pricing_model: per-seat
free_tier: true
free_tier_limits: "limited blocks, 1 user"
starter_price: $8/user/month
business_price: $15/user/month
enterprise: custom

# Features (rate 1-5 or describe)
features:
  documents: 5
  databases: 4
  project_management: 3
  collaboration: 4
  integrations: 3
  mobile_app: 3
  offline_mode: 2
  api: 4

# Strengths (be honest)
strengths:
  - Extremely flexible and customizable
  - Beautiful, modern interface
  - Strong template ecosystem
  - Active community

# Weaknesses (be fair)
weaknesses:
  - Can be slow with large databases
  - Learning curve for advanced features
  - Limited automations compared to dedicated tools
  - Offline mode is limited

# Best for
best_for:
  - Teams wanting all-in-one workspace
  - Content-heavy workflows
  - Documentation-first teams
  - Startups and small teams

# Not ideal for
not_ideal_for:
  - Complex project management needs
  - Large databases (1000s of rows)
  - Teams needing robust offline
  - Enterprise with strict compliance

# Common complaints (from reviews)
common_complaints:
  - "Gets slow with lots of content"
  - "Hard to find things as workspace grows"
  - "Mobile app is clunky"

# Migration notes
migration_from:
  difficulty: medium
  data_export: "Markdown, CSV, HTML"
  what_transfers: "Pages, databases"
  what_doesnt: "Automations, integrations setup"
  time_estimate: "1-3 days for small team"

Your Product Data

Same structure for yourself—be honest:

name: [Your Product]
# ... same fields

strengths:
  - [Your real strengths]

weaknesses:
  - [Your honest weaknesses]

best_for:
  - [Your ideal customers]

not_ideal_for:
  - [Who should use something else]

Page Generation

Each page pulls from centralized data:

[Competitor] Alternative page: Pulls competitor data + your data
[Competitor] Alternatives page: Pulls competitor data + your data + other alternatives
You vs [Competitor] page: Pulls your data + competitor data
[A] vs [B] page: Pulls both competitor data + your data

Benefits:

Update competitor pricing once, updates everywhere
Add new feature comparison once, appears on all pages
Consistent accuracy across pages
Easier to maintain at scale

Index Page Structure

Alternatives Index

URL: /alternatives or /alternatives/index

Purpose: Lists all "[Competitor] Alternative" pages

Page structure:

Headline: "[Your Product] as an Alternative"
Brief intro on why people switch to you
List of all alternative pages with:
- Competitor name/logo
- One-line summary of key differentiator vs. that competitor
- Link to full comparison
Common reasons people switch (aggregated)
CTA

Example:

## Explore [Your Product] as an Alternative

Looking to switch? See how [Your Product] compares to the tools you're evaluating:

- **[Notion Alternative](/alternatives/notion)** — Better for teams who need [X]
- **[Airtable Alternative](/alternatives/airtable)** — Better for teams who need [Y]
- **[Monday Alternative](/alternatives/monday)** — Better for teams who need [Z]

Vs Comparisons Index

URL: /vs or /compare

Purpose: Lists all "You vs [Competitor]" and "[A] vs [B]" pages

Page structure:

Headline: "Compare [Your Product]"
Section: "[Your Product] vs Competitors" — list of direct comparisons
Section: "Head-to-Head Comparisons" — list of [A] vs [B] pages
Brief methodology note
CTA

Index Page Best Practices

Keep them updated: When you add a new comparison page, add it to the relevant index.

Internal linking:

Link from index → individual pages
Link from individual pages → back to index
Cross-link between related comparisons

SEO value:

Index pages can rank for broad terms like "project management tool comparisons"
Pass link equity to individual comparison pages
Help search engines discover all comparison content

Sorting options:

By popularity (search volume)
Alphabetically
By category/use case
By date added (show freshness)

Include on index pages:

Last updated date for credibility
Number of pages/comparisons available
Quick filters if you have many comparisons

4.8 KiB Raw Blame History