Skill Tracer
Skills › Marketing Skills › competitors › content-architecture.md

content-architecture.md

277 lines · skills/competitors/references/content-architecture.md at 88c79f6

Open on GitHub
1# Content Architecture for Competitor Pages
2
3How to structure and maintain competitor data for scalable comparison pages.
4

Content Architecture for Competitor Pages

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

Raw lines 1 to 4
5## Contents
6- Centralized Competitor Data
7- Competitor Data Template
8- Your Product Data
9- Page Generation
10- Index Page Structure (alternatives index, vs comparisons index, index page best practices)
11- Footer Navigation

Contents

  • Centralized Competitor Data
  • Competitor Data Template
  • Your Product Data
  • Page Generation
  • Index Page Structure (alternatives index, vs comparisons index, index page best practices)
  • Footer Navigation
Raw lines 5 to 12
13## Centralized Competitor Data
15Create a single source of truth for each competitor:
17```
18competitor_data/
19├── notion.md
20├── airtable.md
21├── monday.md
22└── ...
23```
25---

Centralized Competitor Data

Create a single source of truth for each competitor:

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

Raw lines 13 to 26
27## Competitor Data Template
29Per competitor, document:
31```yaml
32name: Notion
33website: notion.so
34tagline: "The all-in-one workspace"
35founded: 2016
36headquarters: San Francisco
38# Positioning
39primary_use_case: "docs + light databases"
40target_audience: "teams wanting flexible workspace"
41market_position: "premium, feature-rich"
43# Provenance (re-verify before republishing)
44last_verified: 2026-03-14
45sources:
46 pricing: notion.so/pricing
47 features: notion.so/help + hands-on trial
49# Pricing
50pricing_model: per-seat
51free_tier: true
52free_tier_limits: "limited blocks, 1 user"
53starter_price: $8/user/month
54business_price: $15/user/month
55enterprise: custom
57# Features (rate 1-5 or describe)
58features:
59 documents: 5
60 databases: 4
61 project_management: 3
62 collaboration: 4
63 integrations: 3
64 mobile_app: 3
65 offline_mode: 2
66 api: 4
68# Strengths (be honest)
69strengths:
70 - Extremely flexible and customizable
71 - Beautiful, modern interface
72 - Strong template ecosystem
73 - Active community
75# Weaknesses (be fair)
76weaknesses:
77 - Can be slow with large databases
78 - Learning curve for advanced features
79 - Limited automations compared to dedicated tools
80 - Offline mode is limited
82# Best for
83best_for:
84 - Teams wanting all-in-one workspace
85 - Content-heavy workflows
86 - Documentation-first teams
87 - Startups and small teams
89# Not ideal for
90not_ideal_for:
91 - Complex project management needs
92 - Large databases (1000s of rows)
93 - Teams needing robust offline
94 - Enterprise with strict compliance
96# Common complaints (from reviews)
97common_complaints:
98 - "Gets slow with lots of content"
99 - "Hard to find things as workspace grows"
100 - "Mobile app is clunky"
102# Migration notes
103migration_from:
104 difficulty: medium
105 data_export: "Markdown, CSV, HTML"
106 what_transfers: "Pages, databases"
107 what_doesnt: "Automations, integrations setup"
108 time_estimate: "1-3 days for small team"
109```
111---

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"

# Provenance (re-verify before republishing)
last_verified: 2026-03-14
sources:
  pricing: notion.so/pricing
  features: notion.so/help + hands-on trial

# 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"

Raw lines 27 to 112
113## Your Product Data
115Same structure for yourself—be honest:
117```yaml
118name: [Your Product]
119# ... same fields
121strengths:
122 - [Your real strengths]
124weaknesses:
125 - [Your honest weaknesses]
127best_for:
128 - [Your ideal customers]
130not_ideal_for:
131 - [Who should use something else]
132```
134---

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]

Raw lines 113 to 135
136## Page Generation
138Each page pulls from centralized data:
140- **[Competitor] Alternative page**: Pulls competitor data + your data
141- **[Competitor] Alternatives page**: Pulls competitor data + your data + other alternatives
142- **You vs [Competitor] page**: Pulls your data + competitor data
143- **[A] vs [B] page**: Pulls both competitor data + your data
145**Benefits**:
146- Update competitor pricing once, updates everywhere
147- Add new feature comparison once, appears on all pages
148- Consistent accuracy across pages
149- Easier to maintain at scale
151---

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

Raw lines 136 to 152
153## Index Page Structure

Index Page Structure

Raw lines 153 to 154
155### Alternatives Index
157**URL**: `/alternatives` or `/alternatives/index`
159**Purpose**: Lists all "[Competitor] Alternative" pages
161**Page structure**:
1621. Headline: "[Your Product] as an Alternative"
1632. Brief intro on why people switch to you
1643. List of all alternative pages with:
165 - Competitor name/logo
166 - One-line summary of key differentiator vs. that competitor
167 - Link to full comparison
1684. Common reasons people switch (aggregated)
1695. CTA
171**Example**:
172```markdown
173## Explore [Your Product] as an Alternative
175Looking to switch? See how [Your Product] compares to the tools you're evaluating:
177- **[Notion Alternative](/alternatives/notion)** — Better for teams who need [X]
178- **[Airtable Alternative](/alternatives/airtable)** — Better for teams who need [Y]
179- **[Monday Alternative](/alternatives/monday)** — Better for teams who need [Z]
180```
182---

Alternatives Index

URL: /alternatives or /alternatives/index

Purpose: Lists all "[Competitor] Alternative" pages

Page structure:

  1. Headline: "[Your Product] as an Alternative"
  2. Brief intro on why people switch to you
  3. List of all alternative pages with:
  4. Competitor name/logo
  5. One-line summary of key differentiator vs. that competitor
  6. Link to full comparison
  7. Common reasons people switch (aggregated)
  8. 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]

Raw lines 155 to 183
184### Vs Comparisons Index
186**URL**: `/vs` or `/compare`
188**Purpose**: Lists all "You vs [Competitor]" and "[A] vs [B]" pages
190**Page structure**:
1911. Headline: "Compare [Your Product]"
1922. Section: "[Your Product] vs Competitors" — list of direct comparisons
1933. Section: "Head-to-Head Comparisons" — list of [A] vs [B] pages
1944. Brief methodology note
1955. CTA
197---

Vs Comparisons Index

URL: /vs or /compare

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

Page structure:

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

Raw lines 184 to 198
199### Index Page Best Practices
201**Keep them updated**: When you add a new comparison page, add it to the relevant index.
203**Internal linking**:
204- Link from index → individual pages
205- Link from individual pages → back to index
206- Cross-link between related comparisons
208**SEO value**:
209- Index pages can rank for broad terms like "project management tool comparisons"
210- Pass link equity to individual comparison pages
211- Help search engines discover all comparison content
213**Sorting options**:
214- By popularity (search volume)
215- Alphabetically
216- By category/use case
217- By date added (show freshness)
219**Include on index pages**:
220- Last updated date for credibility
221- Number of pages/comparisons available
222- Quick filters if you have many comparisons
224---

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

Raw lines 199 to 225
226## Footer Navigation
228The site footer appears on all marketing pages, making it a powerful internal linking opportunity for competitor pages.

Footer Navigation

The site footer appears on all marketing pages, making it a powerful internal linking opportunity for competitor pages.

Raw lines 226 to 229
230### Option 1: Link to Index Pages (Minimum)
232At minimum, add links to your comparison index pages in the footer:
234```
235Footer
236├── Compare
237│ ├── Alternatives → /alternatives
238│ └── Comparisons → /vs
239```
241This ensures every marketing page passes link equity to your comparison content hub.

Option 1: Link to Index Pages (Minimum)

At minimum, add links to your comparison index pages in the footer:

Footer
├── Compare
│   ├── Alternatives →  /alternatives
│   └── Comparisons →  /vs

This ensures every marketing page passes link equity to your comparison content hub.

Raw lines 230 to 242
243### Option 2: Footer Columns by Format (Recommended for SEO)
245For stronger internal linking, create dedicated footer columns for each format you've built, linking directly to your top competitors:
247```
248Footer
249├── [Product] vs ├── Alternatives to ├── Compare
250│ ├── vs Notion │ ├── Notion Alternative │ ├── Notion vs Airtable
251│ ├── vs Airtable │ ├── Airtable Alternative │ ├── Monday vs Asana
252│ ├── vs Monday │ ├── Monday Alternative │ ├── Notion vs Monday
253│ ├── vs Asana │ ├── Asana Alternative │ ├── ...
254│ ├── vs Clickup │ ├── Clickup Alternative │ └── View all →
255│ ├── ... │ ├── ... │
256│ └── View all → │ └── View all → │
257```
259**Guidelines**:
260- Include up to 8 links per column (top competitors by search volume)
261- Add "View all" link to the full index page
262- Only create columns for formats you've actually built pages for
263- Prioritize competitors with highest search volume

Option 2: Footer Columns by Format (Recommended for SEO)

For stronger internal linking, create dedicated footer columns for each format you've built, linking directly to your top competitors:

Footer
├── [Product] vs               ├── Alternatives to            ├── Compare
│   ├── vs Notion              │   ├── Notion Alternative     │   ├── Notion vs Airtable
│   ├── vs Airtable            │   ├── Airtable Alternative   │   ├── Monday vs Asana
│   ├── vs Monday              │   ├── Monday Alternative     │   ├── Notion vs Monday
│   ├── vs Asana               │   ├── Asana Alternative      │   ├── ...
│   ├── vs Clickup             │   ├── Clickup Alternative    │   └── View all →
│   ├── ...                    │   ├── ...                    │
│   └── View all →             │   └── View all →             │

Guidelines:

  • Include up to 8 links per column (top competitors by search volume)
  • Add "View all" link to the full index page
  • Only create columns for formats you've actually built pages for
  • Prioritize competitors with highest search volume
Raw lines 243 to 264
265### Why Footer Links Matter
2671. **Sitewide distribution**: Footer links appear on every marketing page, passing link equity from your entire site to comparison content
2682. **Crawl efficiency**: Search engines discover all comparison pages quickly
2693. **User discovery**: Visitors evaluating your product can easily find comparisons
2704. **Competitive positioning**: Signals to search engines that you're a key player in the space

Why Footer Links Matter

  1. Sitewide distribution: Footer links appear on every marketing page, passing link equity from your entire site to comparison content
  2. Crawl efficiency: Search engines discover all comparison pages quickly
  3. User discovery: Visitors evaluating your product can easily find comparisons
  4. Competitive positioning: Signals to search engines that you're a key player in the space
Raw lines 265 to 271
272### Implementation Notes
274- Update footer when adding new high-priority comparison pages
275- Keep footer clean—don't list every comparison, just the top ones
276- Match column headers to your URL structure (e.g., "vs" column → `/vs/` URLs)
277- Consider mobile: columns may stack, so order by priority

Implementation Notes

  • Update footer when adding new high-priority comparison pages
  • Keep footer clean—don't list every comparison, just the top ones
  • Match column headers to your URL structure (e.g., "vs" column → /vs/ URLs)
  • Consider mobile: columns may stack, so order by priority
Raw lines 272 to 277