Skill: SEO/AEO Flow — The Entry Point

The decision map. Use this skill first whenever an SEO/AEO request comes in. It tells you which of the 22 specialized skills to call.

The five-phase flow

┌─────────────┐
   Idea/data    │   DISCOVER  │   What's worth doing?
                │             │
                └──────┬──────┘
                       │
                       ▼
                ┌─────────────┐
   Decision     │   PRODUCE   │   Build the page (or refresh existing).
                │             │
                └──────┬──────┘
                       │
                       ▼
                ┌─────────────┐
   Auto + skill │   AUDIT     │   Auto-runs on deploy. Doesn't block, but raises tasks.
                │             │
                └──────┬──────┘
                       │
                       ▼
                ┌─────────────┐
   Auto deploy  │   PUBLISH   │   Push main → Cloud Run. Tycoon's standard pipeline.
                │             │
                └──────┬──────┘
                       │
                       ▼
                ┌─────────────┐
   Cron + skill │   MONITOR   │   Track rank, traffic, citations. Loop back to DISCOVER.
                └─────────────┘

Per-phase skill map

DISCOVER (figure out what's worth doing)

PRODUCE (build pages)

AUDIT (verify before/after deploy)

PUBLISH (ship)

This phase is fully automated:

• git push main → Cloud Build → Cloud Run deploy
• Post-deploy GHA audit-seo.yml runs pnpm seo:audit --all → Lark notify if fails
• aeo-audit skill scheduled to run on Tier 2 sample pages weekly

No skill to invoke here unless something breaks. If audit fails → check Lark → invoke seo-postmortem.

MONITOR (ongoing tracking)

Daily/weekly cadence (auto-fired by scheduler)

Multi-source — supported from day 1

Every skill above is source-agnostic. The data layer (ts/src/lib/seo/sources/) abstracts the source. Currently implemented:

• ✅ GSC (search performance, indexing)
• ✅ GA4 (analytics)
• ⏳ Ahrefs (interface ready, adapter pending)
• ⏳ PostHog (interface ready, adapter pending)
• ⏳ Bing Webmaster (interface ready, adapter pending)
• ✅ ChatGPT / Claude / Perplexity / Gemini (citation engines, via aeo-citation-track)

When a new source needs to be added:

1. Implement the relevant interface in ts/src/lib/seo/sources/types.ts
2. Register in ts/src/lib/seo/sources/index.ts
3. No skill changes needed — they auto-pick up the new source

i18n — supported from day 1

Every page has hreflang URLs registered in all 3 locales (en, zh-CN, ja) at creation time, even if translations are empty placeholders. Translations land asynchronously via pnpm seo:translate without touching the URL space.

To add a 4th locale (e.g., ja → ko):

1. Add to ts/src/lib/i18n/locales.ts SUPPORTED_LOCALES
2. Add HREFLANG_TAG mapping in ts/src/lib/i18n/hreflang.ts
3. (TODO: pnpm seo:scaffold-locale ko to be implemented on first use) — until then, mkdir each -ko/ directly
4. Translations roll in over time

When NOT to invoke this skill

• User asks a single specific SEO question with a clear answer ("what's a good title length?") → answer directly, don't invoke flow.
• User is mid-flow (already in seo-create, asking a follow-up) → stay in that skill.
• Non-SEO request — flow is for SEO/AEO only.

Quick decision: which skill RIGHT NOW?

"new page"                      → seo-create
"new theme / new type"          → seo-create (Mode 2)
"keyword research"              → seo-discover
"AEO query intent"              → geo-query-finder
"competitive gap"               → content-gap-analysis
"set up AEO files"              → aeo-assets
"AI citation tracking"          → aeo-citation-track
"technical audit"               → seo-technical-audit
"AEO health check"              → aeo-audit
"weekly report"                 → seo-monitor
"why did X drop"                → seo-postmortem
"plan strategy"                 → aeo-playbook (high-level) OR seo-flow (you're already here)
"translate"                     → seo-i18n
"refresh existing pages"        → seo-optimize
"experiment log"                → seo-experiment-log (BEFORE shipping change)
"weekly retro"                  → seo-retro
"monthly learn"                 → seo-learn
"schema for page"               → schema-markup
"content brief for Casey"       → seo-content-brief
"new programmatic batch (50+)"  → seo-create (model page) → programmatic-seo (scale)
"generate markdown for crawlers"→ aeo-markdown-render
"baseline / first-time setup"   → seo-baseline (first ever) → seo-onboard (new property)
"general site SEO audit"        → seo-audit
"end-to-end autopilot"          → seo-autopilot (one ID → ship → monitor)
"standing SEO rules"            → seo-principles (auto-loaded; do not invoke directly)

Inventory — 25 SEO/AEO skills

If still ambiguous, ask the user one clarifying question. Don't run multiple skills speculatively.