SEO + GEO for SaaS

A battle-tested SEO system built by a bootstrapped SaaS founder who grew from 0 to 30k+ organic sessions/month. This isn't theory — it's the exact methodology, templates, and checklists used to rank a real SaaS product.

This skill covers two modes:

1. Setup — onboard a new SaaS, analyze existing SEO, build a strategy, create a content calendar
2. Publish — write, optimize, and ship SEO+GEO articles using proven templates

First-time setup

If the user has never used this skill before (no seo/ directory in their project), run the onboarding flow. Read references/onboarding.md for the full step-by-step process.

Onboarding creates these files in the user's project:

seo/
├── overview.md        # Site architecture, clusters, competitor landscape — context for spawning new agents
├── keywords.md        # Master keyword table — local cache, avoids repeat API calls
├── opportunities.md   # Prioritized gaps, CTR fixes, quick wins
├── published.md       # Log of every published article — avoids needing a database
├── calendar.md        # 5-month content calendar with progress tracking
├── positioning.md     # Current rankings snapshot — updated during audits
├── templates.md       # Article templates adapted for the user's SaaS
└── screenshots/       # Product screenshots to use as article images
├── positioning.md     # Current rankings snapshot
└── templates.md       # Article templates adapted for their SaaS

Choosing your SEO data source

This skill works with two data providers. During onboarding, ask the user which they have access to:

Option A: SemRush (preferred if available)

• More accurate keyword data, better competitor intelligence
• If the user has the semrush-research skill installed, use it directly
• Otherwise, ask the user to export data from SemRush web UI (CSV exports)

Option B: DataForSEO (recommended if no SemRush)

• Cheaper, API-first, good enough for most SaaS
• If the user has the dataforseo skill installed, use it directly
• If the user has an account, help them configure credentials

Option C: Manual data

• User pastes data from Google Search Console, exports, or screenshots
• Works but slower — encourage API setup for ongoing use

Always check which skills are available before asking the user to install anything.

Two operating modes

Mode 1: Strategy & Analysis

Use when the user asks to analyze their SEO, find opportunities, audit performance, or plan content.

Workflow:

1. Read the user's seo/ files to understand current state
2. Pull fresh data (via SemRush, DataForSEO, or user-provided exports)
3. Update the relevant files (keywords.md, opportunities.md, positioning.md)
4. Recommend next actions based on the data