SEO + AEO Agent Skill — SERAPH
Philosophy: Research first. Deploy second. Validate always.
Core Principle: Human-first content, machine-optimized structure.
🎯 Selective Reading Rule (MANDATORY)
Read REQUIRED files always, OPTIONAL only when needed:
| File |
Status |
When to Read |
| aeo-strategies.md |
🔴 REQUIRED |
Always read first! |
| technical-seo.md |
⚪ Optional |
robots.txt, sitemaps, meta, IndexNow |
| schema-library.md |
⚪ Optional |
Any JSON-LD schema needed |
| submission-checklist.md |
⚪ Optional |
GSC, Bing, GBP submissions |
🔴 aeo-strategies.md = ALWAYS READ. Others = only if relevant to the task.
Memory System
Load Memory (Start of Every Task)
cat memory/project-memory.json
If file doesn't exist, run the intake flow and create it:
cp .agent-os/skills/seo-aeo/memory/project-memory.template.json memory/project-memory.json
Save Memory (End of Every Task)
Update memory/project-memory.json with:
- Keywords researched and their intent classification
- Pages optimized and what schema was applied
- Submission status (GSC, Bing, GBP)
- Pending tasks
- Competitor insights discovered
- Core Web Vitals scores if measured
Phase Flow — Follow This Order Every Time
PHASE 0: Intake (if project-memory.json is empty or new)
Ask for or extract from existing files:
- Business name, URL, industry, geo, language, primary goal
- Top 3 competitor URLs
- Target audience (ICP)
- Any existing GSC/Analytics data
Then research:
- Keyword universe (seed → LSI → long-tail → question-based → entity)
- Search intent per keyword (Info / Nav / Commercial / Transactional)
- Competitor schema audit — what types are they using?
- AEO question mapping — what AI engines should cite this site for?
PHASE 1: Technical Files
Generate in this order:
robots.txt → see references/technical-seo.md §robotssitemap_index.xml → see references/technical-seo.md §sitemap- Full
<head> meta block → see references/technical-seo.md §meta
- Schema markup (JSON-LD) → see
references/schema-library.md
PHASE 2: AEO Content
Apply AEO rules from references/aeo-strategies.md to every page:
- Inverted pyramid structure
- Question-based H2/H3 headers
- FAQ schema on every page
- Entity coverage map
- Direct answer blocks
PHASE 3: Submission & Verification
Follow checklist in references/submission-checklist.md:
- GSC property setup + sitemap submission
- Bing Webmaster + IndexNow API
- Google Business Profile
- Structured data validation commands
PHASE 4: Monitoring Plan
Output weekly + monthly automation tasks.
For n8n workflows, generate the JSON trigger configs.
Output Format
Always structure output as:
## [ANALYST BRIEF]
## [KEYWORD STRATEGY]
## [TECHNICAL FILES] (ready to deploy)
## [CONTENT BLUEPRINT]
## [SUBMISSION CHECKLIST]
## [MONITORING PLAN]
## [MEMORY UPDATE] — show what was written to project-memory.json
Absolute Rules
✗ Never leave YOURDOMAIN.com unfilled in output code
✗ Never generate schema without validating it against schema.org spec
✗ Never create thin content pages (<300 words if indexed)
✗ Never block CSS/JS in robots.txt
✗ Never skip canonical tags on paginated or filtered pages
✗ Never output duplicate meta descriptions across pages
✗ Never skip the memory read at session start
✗ Never skip the memory write at session end
Reference Files
| File |
Use When |
references/technical-seo.md |
Generating robots.txt, sitemaps, meta tags, head blocks |
references/schema-library.md |
Any JSON-LD schema markup needed |
references/aeo-strategies.md |
Optimizing content for AI engine citation |
references/submission-checklist.md |
GSC, Bing, GBP, IndexNow setup steps |
memory/project-memory.template.json |
Creating new project memory files |
Activation
To start a new project:
SERAPH INIT — [Project Name] — [URL or "new"] — [Industry] — [Goal]
To continue existing project:
SERAPH CONTINUE — [what needs to be done]
To audit an existing page:
SERAPH AUDIT — [URL or file path]
Related Skills
| Skill |
When to Use |
| seo-aeo (this) |
SEO strategy, schema, AEO content, submissions |
| frontend-design |
Visual design decisions before coding |
| web-design-guidelines |
Accessibility, performance, best practices audit |
Remember: SEO gets you ranked. AEO gets you cited. Both are required now. Research first, deploy second, validate always.
1---2name: seo-aeo3description: Full-stack SEO + AEO (Answer Engine Optimization) agent skill. Triggers when user mentions SEO, AEO, meta tags, schema markup, sitemap, robots.txt, Open Graph, structured data, keyword research, Google Search Console, Bing Webmaster, Google Business Profile, site indexing, search ranking, Core Web Vitals, or wants their website to appear in AI engine answers (ChatGPT, Perplexity, Gemini, Claude web search). Also triggers for: "optimize this page", "add schema", "create robots.txt", "generate sitemap", "what's my SEO score", "help me rank", "make this AI-readable", or any mention of crawlability, indexability, or discoverability.4---56# SEO + AEO Agent Skill — SERAPH78> **Philosophy:** Research first. Deploy second. Validate always.9> **Core Principle:** Human-first content, machine-optimized structure.1011---1213## 🎯 Selective Reading Rule (MANDATORY)1415**Read REQUIRED files always, OPTIONAL only when needed:**1617| File | Status | When to Read |18| ------------------------------------------------------------- | --------------- | ------------------------------------ |19| [aeo-strategies.md](references/aeo-strategies.md) | 🔴 **REQUIRED** | Always read first! |20| [technical-seo.md](references/technical-seo.md) | ⚪ Optional | robots.txt, sitemaps, meta, IndexNow |21| [schema-library.md](references/schema-library.md) | ⚪ Optional | Any JSON-LD schema needed |22| [submission-checklist.md](references/submission-checklist.md) | ⚪ Optional | GSC, Bing, GBP submissions |2324> 🔴 **aeo-strategies.md = ALWAYS READ. Others = only if relevant to the task.**2526---2728## Memory System2930### Load Memory (Start of Every Task)3132```bash33cat memory/project-memory.json34```3536If file doesn't exist, run the intake flow and create it:3738```bash39cp .agent-os/skills/seo-aeo/memory/project-memory.template.json memory/project-memory.json40```4142### Save Memory (End of Every Task)4344Update `memory/project-memory.json` with:4546- Keywords researched and their intent classification47- Pages optimized and what schema was applied48- Submission status (GSC, Bing, GBP)49- Pending tasks50- Competitor insights discovered51- Core Web Vitals scores if measured5253---5455## Phase Flow — Follow This Order Every Time5657### PHASE 0: Intake (if project-memory.json is empty or new)5859Ask for or extract from existing files:6061- Business name, URL, industry, geo, language, primary goal62- Top 3 competitor URLs63- Target audience (ICP)64- Any existing GSC/Analytics data6566Then research:67681. Keyword universe (seed → LSI → long-tail → question-based → entity)692. Search intent per keyword (Info / Nav / Commercial / Transactional)703. Competitor schema audit — what types are they using?714. AEO question mapping — what AI engines should cite this site for?7273### PHASE 1: Technical Files7475Generate in this order:76771. `robots.txt` → see `references/technical-seo.md` §robots782. `sitemap_index.xml` → see `references/technical-seo.md` §sitemap793. Full `<head>` meta block → see `references/technical-seo.md` §meta804. Schema markup (JSON-LD) → see `references/schema-library.md`8182### PHASE 2: AEO Content8384Apply AEO rules from `references/aeo-strategies.md` to every page:8586- Inverted pyramid structure87- Question-based H2/H3 headers88- FAQ schema on every page89- Entity coverage map90- Direct answer blocks9192### PHASE 3: Submission & Verification9394Follow checklist in `references/submission-checklist.md`:9596- GSC property setup + sitemap submission97- Bing Webmaster + IndexNow API98- Google Business Profile99- Structured data validation commands100101### PHASE 4: Monitoring Plan102103Output weekly + monthly automation tasks.104For n8n workflows, generate the JSON trigger configs.105106---107108## Output Format109110Always structure output as:111112```text113## [ANALYST BRIEF]114## [KEYWORD STRATEGY]115## [TECHNICAL FILES] (ready to deploy)116## [CONTENT BLUEPRINT]117## [SUBMISSION CHECKLIST]118## [MONITORING PLAN]119## [MEMORY UPDATE] — show what was written to project-memory.json120```121122---123124## Absolute Rules125126```text127✗ Never leave YOURDOMAIN.com unfilled in output code128✗ Never generate schema without validating it against schema.org spec129✗ Never create thin content pages (<300 words if indexed)130✗ Never block CSS/JS in robots.txt131✗ Never skip canonical tags on paginated or filtered pages132✗ Never output duplicate meta descriptions across pages133✗ Never skip the memory read at session start134✗ Never skip the memory write at session end135```136137---138139## Reference Files140141| File | Use When |142| ------------------------------------- | ------------------------------------------------------- |143| `references/technical-seo.md` | Generating robots.txt, sitemaps, meta tags, head blocks |144| `references/schema-library.md` | Any JSON-LD schema markup needed |145| `references/aeo-strategies.md` | Optimizing content for AI engine citation |146| `references/submission-checklist.md` | GSC, Bing, GBP, IndexNow setup steps |147| `memory/project-memory.template.json` | Creating new project memory files |148149---150151## Activation152153To start a new project:154155```text156SERAPH INIT — [Project Name] — [URL or "new"] — [Industry] — [Goal]157```158159To continue existing project:160161```text162SERAPH CONTINUE — [what needs to be done]163```164165To audit an existing page:166167```text168SERAPH AUDIT — [URL or file path]169```170171---172173## Related Skills174175| Skill | When to Use |176| -------------------------------------------------------------- | ------------------------------------------------ |177| **seo-aeo** (this) | SEO strategy, schema, AEO content, submissions |178| **[frontend-design](../frontend-design/SKILL.md)** | Visual design decisions before coding |179| **[web-design-guidelines](../web-design-guidelines/SKILL.md)** | Accessibility, performance, best practices audit |180181---182183> **Remember:** SEO gets you ranked. AEO gets you cited. Both are required now. Research first, deploy second, validate always.
Ab-aswini