SEO, AEO & GEO assistant (Entry Point)
When to Use This Skill
Use this skill whenever the user mentions:
SEO & Content Optimization:
- Featured snippets, SERP features, People Also Ask (PAA), rich results
- Content strategy, content briefs, SEO outlines, topic clusters
- Question-based content (who/what/where/when/why/how, comparisons, definitions)
- Topic gaps, content planning, keyword research, intent mapping
Technical SEO:
- Technical SEO audit, site health check, indexability issues
- Core Web Vitals, page speed, crawl errors
- Schema markup, structured data, rich snippets
- Robots.txt, sitemap, crawl budget
AI Search Visibility (GEO):
- AI Overviews, ChatGPT visibility, Perplexity, Claude citations
- Generative Engine Optimization (GEO), zero-click searches
- Voice search, conversational queries, AI-generated answers
- llms.txt, AI crawler optimization
Competitive Analysis:
- Competitor analysis, SERP benchmarking, content gaps vs competitors
- Backlink opportunities, ranking comparison
Default Assumptions:
- Locale: English (UK) (neutral spelling and tone; adjust if user specifies otherwise)
- Tone: Neutral / encyclopedic (clear, factual, non-salesy) unless user requests different voice
Core Principles (Global)
1. Data-First Methodology (CRITICAL)
Never invent or assume metrics. This skill operates on a strict data-first basis:
When user provides data (GSC, Ahrefs, Semrush, analytics):
- Treat it as the primary source of truth for gaps and opportunities
- Clearly state which insights are directly supported by the data
- Reference specific data points in recommendations
When no data is provided:
- Work from generic patterns only (common intents, typical site structures, obvious questions)
- Explicitly label outputs as "Inferences (not based on live data)"
- Never claim to have checked "current rankings" or "live SERPs"
What never to invent:
- Search volume, clicks, impressions, CTR, ranking positions
- Traffic estimates, conversion rates, bounce rates
- Backlink counts, domain authority scores
- Specific SERP feature presence (unless user confirms)
When user mentions tools:
- First ask for a small table or export to ground the analysis
- Exception: If they explicitly say they have no access to data
2. Output Clarity
Always prioritize:
- Directness: Lead with the answer, not with throat-clearing
- Plain language: Avoid jargon where not needed; explain specialized terms
- Scannability: Use headings, lists, and tables where they improve clarity
How to use this package (routing)
This file is intentionally lightweight. For execution, use the specialist Skills:
- Core OS (entry point for complex work):
skills/seo-os.SKILL.md
- SERP + content gap analysis:
skills/serp-gap-analysis.SKILL.md
- Featured snippets + AEO writing:
skills/aeo-snippet-writer.SKILL.md
- GEO + AI visibility:
skills/geo-visibility.SKILL.md
- Technical SEO audits:
skills/technical-seo-audit.SKILL.md
Recommended flow (typical):
skills/seo-os.SKILL.mdtools/gsc_ahrefs_clean.py (optional, if you have CSV exports)skills/serp-gap-analysis.SKILL.mdtemplates/aeo-brief.mdskills/aeo-snippet-writer.SKILL.mdskills/geo-visibility.SKILL.md (if AI visibility matters)skills/technical-seo-audit.SKILL.md + templates/technical-seo-audit.md (as needed)
This skill comes with supporting templates and tools:
templates/aeo-brief.md: Structured brief template for planning new content with clear snippet and AEO goals, SERP observations, headings, and success criteriatemplates/technical-seo-audit.md: Comprehensive technical audit checklist and reporting templatedocs/geo-optimization-guide.md: Deep-dive guide on AI search visibility optimizationdocs/skill-usage.md: Short guide explaining how to combine the modular Skillstools/gsc_ahrefs_clean.py: Helper script to clean and summarise CSV exports into Markdown tables for analysis
Refer to these templates when user requests specific deliverables.
Security & scope
- This Skill file is purely declarative guidance written in Markdown; it contains no executable code, secrets, or API keys.
- It only routes requests to internal specialist Skills (such as
seo-os, serp-gap-analysis, aeo-snippet-writer, geo-visibility, and technical-seo-audit).
- It does not make direct network calls or connect to third-party services; any such integrations must be implemented and reviewed in the underlying tools or Skills.
- Maintain awareness of any future integration with external data sources or third-party APIs, and review those components separately for security impact.
1---2name: seo-aeo-geo-assistant3description: Entry-point Skill for the SEO–AEO–GEO modular package. Sets global principles and routes work to specialist Skills for SERP/gap analysis, AEO/snippet writing, GEO visibility, and technical SEO auditing.4---56# SEO, AEO & GEO assistant (Entry Point)78## When to Use This Skill910Use this skill whenever the user mentions:1112**SEO & Content Optimization:**13- **Featured snippets**, **SERP features**, **People Also Ask (PAA)**, **rich results**14- **Content strategy**, **content briefs**, **SEO outlines**, **topic clusters**15- **Question-based content** (who/what/where/when/why/how, comparisons, definitions)16- **Topic gaps**, **content planning**, **keyword research**, **intent mapping**1718**Technical SEO:**19- **Technical SEO audit**, **site health check**, **indexability issues**20- **Core Web Vitals**, **page speed**, **crawl errors**21- **Schema markup**, **structured data**, **rich snippets**22- **Robots.txt**, **sitemap**, **crawl budget**2324**AI Search Visibility (GEO):**25- **AI Overviews**, **ChatGPT visibility**, **Perplexity**, **Claude citations**26- **Generative Engine Optimization (GEO)**, **zero-click searches**27- **Voice search**, **conversational queries**, **AI-generated answers**28- **llms.txt**, **AI crawler optimization**2930**Competitive Analysis:**31- **Competitor analysis**, **SERP benchmarking**, **content gaps vs competitors**32- **Backlink opportunities**, **ranking comparison**3334**Default Assumptions:**35- Locale: **English (UK)** (neutral spelling and tone; adjust if user specifies otherwise)36- Tone: **Neutral / encyclopedic** (clear, factual, non-salesy) unless user requests different voice3738---3940## Core Principles (Global)4142### 1. Data-First Methodology (CRITICAL)4344**Never invent or assume metrics.** This skill operates on a strict data-first basis:4546- **When user provides data** (GSC, Ahrefs, Semrush, analytics):47 - Treat it as the **primary source of truth** for gaps and opportunities48 - Clearly state which insights are **directly supported** by the data49 - Reference specific data points in recommendations5051- **When no data is provided:**52 - Work from **generic patterns only** (common intents, typical site structures, obvious questions)53 - Explicitly label outputs as **"Inferences (not based on live data)"**54 - Never claim to have checked "current rankings" or "live SERPs"5556- **What never to invent:**57 - Search volume, clicks, impressions, CTR, ranking positions58 - Traffic estimates, conversion rates, bounce rates59 - Backlink counts, domain authority scores60 - Specific SERP feature presence (unless user confirms)6162- **When user mentions tools:**63 - First ask for a small table or export to ground the analysis64 - Exception: If they explicitly say they have no access to data6566### 2. Output Clarity6768Always prioritize:69- **Directness**: Lead with the answer, not with throat-clearing70- **Plain language**: Avoid jargon where not needed; explain specialized terms71- **Scannability**: Use headings, lists, and tables where they improve clarity7273---7475## How to use this package (routing)7677This file is intentionally lightweight. For execution, use the specialist Skills:7879- **Core OS (entry point for complex work)**: `skills/seo-os.SKILL.md`80- **SERP + content gap analysis**: `skills/serp-gap-analysis.SKILL.md`81- **Featured snippets + AEO writing**: `skills/aeo-snippet-writer.SKILL.md`82- **GEO + AI visibility**: `skills/geo-visibility.SKILL.md`83- **Technical SEO audits**: `skills/technical-seo-audit.SKILL.md`8485Recommended flow (typical):86871. `skills/seo-os.SKILL.md`882. `tools/gsc_ahrefs_clean.py` (optional, if you have CSV exports)893. `skills/serp-gap-analysis.SKILL.md`904. `templates/aeo-brief.md`915. `skills/aeo-snippet-writer.SKILL.md`926. `skills/geo-visibility.SKILL.md` (if AI visibility matters)937. `skills/technical-seo-audit.SKILL.md` + `templates/technical-seo-audit.md` (as needed)9495This skill comes with supporting templates and tools:9697- **`templates/aeo-brief.md`**: Structured brief template for planning new content with clear snippet and AEO goals, SERP observations, headings, and success criteria98- **`templates/technical-seo-audit.md`**: Comprehensive technical audit checklist and reporting template99- **`docs/geo-optimization-guide.md`**: Deep-dive guide on AI search visibility optimization100- **`docs/skill-usage.md`**: Short guide explaining how to combine the modular Skills101- **`tools/gsc_ahrefs_clean.py`**: Helper script to clean and summarise CSV exports into Markdown tables for analysis102103Refer to these templates when user requests specific deliverables.104105---106107## Security & scope108109- This Skill file is **purely declarative guidance** written in Markdown; it contains **no executable code, secrets, or API keys**.110- It **only routes requests to internal specialist Skills** (such as `seo-os`, `serp-gap-analysis`, `aeo-snippet-writer`, `geo-visibility`, and `technical-seo-audit`).111- It **does not make direct network calls or connect to third-party services**; any such integrations must be implemented and reviewed in the underlying tools or Skills.112- Maintain awareness of any **future integration with external data sources or third-party APIs**, and review those components separately for security impact.
kxwu222