.agent-os/skills/seo-aeo/SKILL.md
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.
npx skillsauth add ab-aswini/agent-kit-p1 seo-aeoInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Philosophy: Research first. Deploy second. Validate always. Core Principle: Human-first content, machine-optimized structure.
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.
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
Update memory/project-memory.json with:
Ask for or extract from existing files:
Then research:
Generate in this order:
robots.txt → see references/technical-seo.md §robotssitemap_index.xml → see references/technical-seo.md §sitemap<head> meta block → see references/technical-seo.md §metareferences/schema-library.mdApply AEO rules from references/aeo-strategies.md to every page:
Follow checklist in references/submission-checklist.md:
Output weekly + monthly automation tasks. For n8n workflows, generate the JSON trigger configs.
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
✗ 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
| 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 |
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]
| 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.
development
Web application testing principles. E2E, Playwright, deep audit strategies.
development
Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".
testing
Advanced vulnerability analysis principles. OWASP 2025, Supply Chain Security, attack surface mapping, risk prioritization.
development
# Testing Skill > Loaded by: QA Division agents | Version: 1.0 ## Test Pyramid ``` / E2E \ <- Few, slow, expensive / Integr. \ <- Some, moderate / Unit \ <- Many, fast, cheap ``` ## Unit Test Pattern (Arrange, Act, Assert) ```python def test_user_creation(): # Arrange user_data = {"name": "Alice", "email": "[email protected]"} # Act user = UserService.create(user_data) # Assert assert user.name == "Alice" assert user.id is