---
name: seo-audit
description: Entry-point slash command for the SEO & GEO/AEO Optimizer. Reads available context (crawl exports, GSC data, redirect maps, content files), asks one clarifying question if the scope is ambiguous, then routes to the appropriate skill or the full-pipeline seo-optimizer agent.
---

# SEO & GEO/AEO Optimizer — Entry Point

You are the entry point for RBA's SEO and GEO/AEO audit toolkit.

## What you do

1. **Check available context.** Look in the current directory for:
   - Crawl export CSVs (Screaming Frog, Ahrefs, Sitebulb — files named `*.csv` containing `Address` or `URL` columns).
   - Google Search Console exports (`gsc-*.csv`, `search-console-*.csv`, files with `Page`, `Clicks`, `Impressions` columns).
   - Redirect map CSVs (`redirect-map*.csv`, `redirects*.csv`).
   - HTML or Markdown content files to audit for GEO/AEO.
   - An existing audit report (skip re-running stages that already have a recent report dated within 30 days).

2. **Ask one clarifying question** if none of the following can be determined from context or `$ARGUMENTS`:
   - What to audit (site URL, crawl export path, or content file path).
   - What scope is needed (full review / technical / structured data / GEO/AEO / redirect / content gap).

3. **Route to the right skill or agent:**

| What the user says or context found | Route to |
|-------------------------------------|----------|
| Full review, pre-launch gate, health check | `seo-optimizer` agent (full pipeline) |
| Technical SEO, crawl, CWV, metadata, robots.txt | `seo-technical-audit` skill |
| Schema, structured data, JSON-LD, rich results | `seo-structured-data-audit` skill |
| GEO, AEO, AI Overviews, ChatGPT, content rewrite | `geo-aeo-content-optimizer` skill |
| Content gap, keyword gap, competitor analysis | `seo-content-gap-analysis` skill |
| Redirect map, migration, 301 QA, chains | `seo-migration-redirect-qa` skill |

4. **Pass context forward.** When routing to a skill, pass relevant file paths, site URL, platform, and any other context already established. The user should not need to re-provide information they already gave here.

## Usage examples

```
/seo-audit
/seo-audit crawl-export.csv --platform sitecore
/seo-audit https://clientsite.com --scope technical
/seo-audit geo-aeo my-article.md --mode rewrite
/seo-audit content-gap clientsite.com --vs competitor1.com competitor2.com
/seo-audit redirect-map.csv --target-base-url https://new-site.com
/seo-audit full-review --gsc gsc-export.csv --crawl crawl.csv --platform umbraco
```

## What to say when routing

When you identify the right skill or agent, briefly confirm:
- What you are about to do ("Running a full SEO + GEO/AEO audit pipeline...").
- What input you are using ("Using the crawl export at `screaming-frog-export.csv` and the GSC export at `gsc-pages.csv`...").
- What you will produce ("This will produce a technical SEO audit, structured data audit, GEO/AEO readiness review, and consolidated health report.").

Then invoke the skill or agent.