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 §robots
sitemap_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: >4 Full-stack SEO + AEO (Answer Engine Optimization) agent skill. Triggers when5 user mentions SEO, AEO, meta tags, schema markup, sitemap, robots.txt, Open6 Graph, structured data, keyword research, Google Search Console, Bing7 Webmaster, Google Business Profile, site indexing, search ranking, Core Web8 Vitals, or wants their website to appear in AI engine answers (ChatGPT,9 Perplexity, Gemini, Claude web search). Also triggers for: "optimize this10 page", "add schema", "create robots.txt", "generate sitemap", "what's my SEO11 score", "help me rank", "make this AI-readable", or any mention of12 crawlability, indexability, or discoverability.13allowed-tools: Read, Write, Edit, Glob, Grep, Bash14---1516# SEO + AEO Agent Skill — SERAPH1718> **Philosophy:** Research first. Deploy second. Validate always.19> **Core Principle:** Human-first content, machine-optimized structure.2021---2223## 🎯 Selective Reading Rule (MANDATORY)2425**Read REQUIRED files always, OPTIONAL only when needed:**2627| File | Status | When to Read |28| ------------------------------------------------------------- | --------------- | ------------------------------------ |29| [aeo-strategies.md](references/aeo-strategies.md) | 🔴 **REQUIRED** | Always read first! |30| [technical-seo.md](references/technical-seo.md) | ⚪ Optional | robots.txt, sitemaps, meta, IndexNow |31| [schema-library.md](references/schema-library.md) | ⚪ Optional | Any JSON-LD schema needed |32| [submission-checklist.md](references/submission-checklist.md) | ⚪ Optional | GSC, Bing, GBP submissions |3334> 🔴 **aeo-strategies.md = ALWAYS READ. Others = only if relevant to the task.**3536---3738## Memory System3940### Load Memory (Start of Every Task)4142```bash43cat memory/project-memory.json44```4546If file doesn't exist, run the intake flow and create it:4748```bash49cp .agent-os/skills/seo-aeo/memory/project-memory.template.json memory/project-memory.json50```5152### Save Memory (End of Every Task)5354Update `memory/project-memory.json` with:5556- Keywords researched and their intent classification57- Pages optimized and what schema was applied58- Submission status (GSC, Bing, GBP)59- Pending tasks60- Competitor insights discovered61- Core Web Vitals scores if measured6263---6465## Phase Flow — Follow This Order Every Time6667### PHASE 0: Intake (if project-memory.json is empty or new)6869Ask for or extract from existing files:7071- Business name, URL, industry, geo, language, primary goal72- Top 3 competitor URLs73- Target audience (ICP)74- Any existing GSC/Analytics data7576Then research:77781. Keyword universe (seed → LSI → long-tail → question-based → entity)792. Search intent per keyword (Info / Nav / Commercial / Transactional)803. Competitor schema audit — what types are they using?814. AEO question mapping — what AI engines should cite this site for?8283### PHASE 1: Technical Files8485Generate in this order:86871. `robots.txt` → see `references/technical-seo.md` §robots882. `sitemap_index.xml` → see `references/technical-seo.md` §sitemap893. Full `<head>` meta block → see `references/technical-seo.md` §meta904. Schema markup (JSON-LD) → see `references/schema-library.md`9192### PHASE 2: AEO Content9394Apply AEO rules from `references/aeo-strategies.md` to every page:9596- Inverted pyramid structure97- Question-based H2/H3 headers98- FAQ schema on every page99- Entity coverage map100- Direct answer blocks101102### PHASE 3: Submission & Verification103104Follow checklist in `references/submission-checklist.md`:105106- GSC property setup + sitemap submission107- Bing Webmaster + IndexNow API108- Google Business Profile109- Structured data validation commands110111### PHASE 4: Monitoring Plan112113Output weekly + monthly automation tasks.114For n8n workflows, generate the JSON trigger configs.115116---117118## Output Format119120Always structure output as:121122```text123## [ANALYST BRIEF]124## [KEYWORD STRATEGY]125## [TECHNICAL FILES] (ready to deploy)126## [CONTENT BLUEPRINT]127## [SUBMISSION CHECKLIST]128## [MONITORING PLAN]129## [MEMORY UPDATE] — show what was written to project-memory.json130```131132---133134## Absolute Rules135136```text137✗ Never leave YOURDOMAIN.com unfilled in output code138✗ Never generate schema without validating it against schema.org spec139✗ Never create thin content pages (<300 words if indexed)140✗ Never block CSS/JS in robots.txt141✗ Never skip canonical tags on paginated or filtered pages142✗ Never output duplicate meta descriptions across pages143✗ Never skip the memory read at session start144✗ Never skip the memory write at session end145```146147---148149## Reference Files150151| File | Use When |152| ------------------------------------- | ------------------------------------------------------- |153| `references/technical-seo.md` | Generating robots.txt, sitemaps, meta tags, head blocks |154| `references/schema-library.md` | Any JSON-LD schema markup needed |155| `references/aeo-strategies.md` | Optimizing content for AI engine citation |156| `references/submission-checklist.md` | GSC, Bing, GBP, IndexNow setup steps |157| `memory/project-memory.template.json` | Creating new project memory files |158159---160161## Activation162163To start a new project:164165```text166SERAPH INIT — [Project Name] — [URL or "new"] — [Industry] — [Goal]167```168169To continue existing project:170171```text172SERAPH CONTINUE — [what needs to be done]173```174175To audit an existing page:176177```text178SERAPH AUDIT — [URL or file path]179```180181---182183## Related Skills184185| Skill | When to Use |186| -------------------------------------------------------------- | ------------------------------------------------ |187| **seo-aeo** (this) | SEO strategy, schema, AEO content, submissions |188| **[frontend-design](../frontend-design/SKILL.md)** | Visual design decisions before coding |189| **[web-design-guidelines](../web-design-guidelines/SKILL.md)** | Accessibility, performance, best practices audit |190191---192193> **Remember:** SEO gets you ranked. AEO gets you cited. Both are required now. Research first, deploy second, validate always.