seo

name	seo
description	SEO toolkit with project management, content writing, and 15 audit sub-skills. Use this when the user asks to "perform SEO analysis", "run SEO audit", "analyze SEO", "check technical SEO", "create project", "content write", "SEO plan", "GEO", "AEO", or any SEO-related task. Includes project management, AI-powered content writer, and deterministic audit scripts.

SEO Agentic (Antigravity / Claude / Codex)

LLM-first SEO toolkit: project management, content writing, and 15 audit sub-skills with 7 specialist agents and 25 scripts.

On Load — Display Full Menu

When this skill is loaded (user types /seo or triggers the skill), ALWAYS display the full command table below. Do not abbreviate or show a subset.

Show this exact message:

SEO Agentic loaded. Available commands:

📋 Project Management
  project new <name> <url>    — Create new SEO project
  project list                — List all projects
  project switch <name>       — Switch active project
  project status              — Show active project context

✍️ Content
  content write <topic>       — Write SEO content in your voice
  content audit <url>         — Content quality & E-E-A-T analysis
  marketing interview         — Extract marketing context via 30-question interview
  content calendar            — Generate 7-day content calendar (or: 30-day calendar)

🔍 Audits
  seo audit <url>             — Full website audit with scoring
  seo page <url>              — Deep single-page analysis
  seo technical <url>         — Technical SEO checks
  seo schema <url>            — Schema detection/validation
  seo images <url>            — Image optimization audit
  seo sitemap <url>           — Sitemap analysis
  seo links <url>             — Backlink profile & link health

📊 Strategy
  seo plan <url>              — Strategic SEO planning
  seo geo <url>               — AI search optimization (GEO)
  seo aeo <url>               — Answer Engine Optimization
  seo competitors <url>       — Competitor page analysis
  seo hreflang <url>          — International SEO validation
  seo programmatic <url>      — Programmatic SEO safeguards
  seo article <url>           — Article data extraction

Tip: Use project name instead of URL after creating a project.
     Example: seo audit diverfi (instead of seo audit https://diverfi.xyz)

After displaying the menu, wait for the user to type a command. Do not run any audit or analysis until the user specifies one.

Deterministic Trigger Mapping

For prompt reliability in Codex/agent IDEs, map common user wording to a fixed workflow:

• If user says perform seo analysis on <url> (or similar generic SEO request with a URL), treat it as a single-URL full audit.
• If no explicit sub-skill is specified, run the full/page audit path with LLM-first reasoning and script-backed evidence.
• For full/page audits, always produce:
  • FULL-AUDIT-REPORT.md (detailed findings)
  • ACTION-PLAN.md (prioritized fixes)
• If generate_report.py is run, also return the saved HTML path (for example SEO-REPORT.html).

Available Commands

Command	Sub-Skill	Description
seo audit <url>	seo-audit	Full website audit with scoring
seo page <url>	seo-page	Deep single-page analysis
seo technical <url>	seo-technical	Technical SEO checks
content audit <url>	content-audit	Content quality & E-E-A-T
content write <topic>	content-writer	SEO content in your writing voice
marketing interview	marketing-interviewer	Extract marketing context via 30-question interview
content calendar / 30-day calendar	content-calendar	Generate 7-day or 30-day content calendar
seo schema <url>	seo-schema	Schema detection/validation/generation
seo sitemap <url>	seo-sitemap	Sitemap analysis & generation
seo images <url>	seo-images	Image optimization audit
seo geo <url>	seo-geo	AI search optimization (GEO)
seo programmatic <url>	seo-programmatic	Programmatic SEO safeguards
seo competitors <url>	seo-competitor-pages	Comparison/alternatives pages
seo hreflang <url>	seo-hreflang	International SEO validation
seo plan <url>	seo-plan	Strategic SEO planning
seo article <url>	seo-article	Article data extraction & LLM optimization
seo links <url>	seo-links	External backlink profile & link health
seo aeo <url>	seo-aeo	Answer Engine Optimization (Featured Snippets, PAA, Knowledge Panel)
project list	seo-project	List all projects + active
project switch <name>	seo-project	Switch active project
project new <name> <url>	seo-project	Create new project
project status	seo-project	Show active project context
voice correct / voice calibrate add	voice-calibrate	Correct AI voice; add calibration entries
voice status	VOICES_DIR=resources/context/voices bash scripts/voice/voice-status.sh bui-thang	Show calibration entry count and recent patterns

---

Full orchestration docs, script reference, quality gates, critical rules, and dependencies are in SKILL-DOCS.md. Read it when needed — not on every load.