magnus919_agent-skills/seo-audit/SKILL.md

name, description, license, compatibility, metadata

name	description	license	compatibility	metadata
seo-audit	Audit websites and pages for technical SEO, on-page SEO, schema markup, content discoverability, and answer-engine readiness. Use when prioritizing search visibility improvements; route AEO-specific implementation and measurement to the dedicated aeo skill.	MIT	Requires access to the site or page being audited. Platform-specific references are optional and must be applied only when relevant.	source_repo source_commit https://github.com/magnus919/hermes-profiles 867a555

SEO Audit

Full-spectrum audit for sites, articles, and content strategies. Covers both traditional SEO and Answer Engine Optimization (AEO/GEO) — the practice of structuring content so LLMs and AI answer engines (ChatGPT, Perplexity, Gemini, Claude, Google AI Overviews) extract and cite it.

Use assets/audit-report-template.md for a portable audit deliverable. If the host workflow uses artifact pyramids, that structure can be an optional presentation format rather than a prerequisite.

SEO + AEO Audit: [Site/Page URL]

Overall Health: [Good / Fair / Poor] Score: [N/100]

SEO Priority Findings

1. [Critical] → [Action]

AEO Priority Findings

1. [Critical] → [Action]

Quick Wins

1. [Low effort, high impact] → [Action]

Verdict

[One paragraph summarizing the single most important thing to fix and expected impact.]

## Contents

| File | What it covers |
|------|----------------|
| `references/technical-seo.md` | Crawlability, indexability, robots.txt, sitemaps, page speed, Core Web Vitals, mobile-friendliness, HTTPS, canonical URLs, hreflang |
| `references/onpage-seo.md` | Title tags, meta descriptions, heading hierarchy, keyword placement, content quality, internal linking, image optimization |
| `references/schema-markup.md` | Schema.org types (TechArticle, FAQPage, HowTo, Article, BlogPosting, BreadcrumbList, Organization), JSON-LD format, Google rich results, validation |
| `references/content-strategy-seo.md` | Topic clusters, pillar pages, keyword research, gap analysis, SERP feature targeting, topical authority |
| `references/ghost-metadata.md` | Ghost CMS metadata fields (meta_title, meta_description, custom_excerpt), social media cards (OG, Twitter), code-injected schema (JSON-LD, FAQPage, TechArticle, @graph), per-post and site-wide injection, validation |
| `references/aeo-methodology.md` | Answer Engine Optimization — LLM RAG pipeline, answer-first content architecture, AEO-specific schema (FAQPage 3.2× boost), Ethan Smith/Graphite frameworks, question clusters, llms.txt, content negotiation, measurement |
| `assets/audit-report-template.md` | Blank report scaffold for new audits |

## When to Use

Load this skill when:
- Auditing a site for technical SEO issues
- Optimizing a new article for search and AI citation before publication
- Validating structured data on an existing page
- Completing Ghost CMS metadata (meta, social cards, schema injection) before publish
- Running an AEO readiness audit (llms.txt, content negotiation, question-cluster coverage)
- Developing a content strategy with SEO + AEO in parallel
- Diagnosing why a site or page isn't performing in search or AI citation

Do NOT load when:
- Only mechanical content fixes are needed; use the host agent's copy-editing workflow.
- Only writing is needed; use the host agent's writing workflow.

## When not to use

Do not use this skill alone for AEO-specific implementation, citation experiments, or provider crawler policy design; route those concerns to `aeo`. Do not use it for only mechanical copy-editing or only writing.

## Routing

Use the dedicated [`aeo`](../aeo/SKILL.md) skill for AEO-specific implementation, question clusters, answer architecture, citation measurement, provider crawler semantics, `llms.txt`, and AI-answer experiments. Return here for the broader technical SEO and site audit surface.

## Portability

This skill is intentionally host-neutral. Use your agent's normal mechanisms to load the references, templates, and scripts listed here. Do not assume a particular profile system, task orchestrator, memory service, or response-handoff format.