v1.0.0 to git:20260518.6c410f0

200 added, 94 removed. Audit A to C.

- ---

- name: seo-aeo-amplifier

- description: Comprehensive on-page SEO and Answer Engine Optimization audit with automated duplicate creation and intelligent schema markup generation. Scans all content, detects issues (missing titles, weak meta, poor headings, missing alt text), generates schema (Article, FAQ, HowTo, Product, etc), creates optimized duplicates. Use when user says "amplify my seo and aeo", "optimize for search engines", "run seo audit", "improve search visibility", or "scan for seo opportunities".

- license: MIT

- metadata:

- author: Respira for WordPress

- author_url: https://respira.press

- version: 1.0.0

- mcp-server: respira-wordpress

- category: performance

- ---

# SEO & AEO Amplifier

- Comprehensive on-page SEO and Answer Engine Optimization (AEO) audit and auto-fix system. Scans all content, detects issues, generates intelligent schema markup, and creates optimized duplicates for review.

+ **Version:** 1.1.0

+ **Updated:** 2026-05-17

+ **Freshly updated:** v1.1.0 swaps deprecated wordpress_* tool names to respira_* throughout, references the canonical Respira analyzer family (respira_analyze_seo, respira_analyze_aeo, respira_analyze_readability, respira_analyze_rankmath, respira_check_structured_data), and notes the Elementor 4 atomic-write surface added in v7.1 for site-wide SEO fixes on v4 pages.

+ Comprehensive on-page SEO and Answer Engine Optimization (AEO) audit and auto-fix system for WordPress sites. Scans all content, detects issues, generates intelligent schema markup, and creates optimized duplicates for review.

## What This Skill Does

- **Detects on-page SEO issues:**

+ **Finds:**

- Missing or weak title tags and meta descriptions

- - Poor heading structure (multiple H1s, skipped levels)

- - Missing image alt text

+ - Poor heading structure (multiple H1s, skipped heading levels, non-descriptive headings)

+ - Missing image alt text across all media

- Thin content (pages under 300 words)

- Broken internal links

- - Orphaned pages (no internal links to them)

+ - Orphaned pages (no internal links pointing to them)

- Non-descriptive URL slugs

- **Identifies AEO opportunities:**

- - Content that answers questions but lacks FAQ schema

+ - Content that could answer questions but lacks FAQ schema

- Missing structured data (Article, HowTo, Product, Event, Video, Review)

- - Content not formatted for featured snippets

+ - Content not optimized for featured snippets

- Missing table of contents on long-form content

- - No clear Q&A structure for "People Also Ask"

+ - No clear Q&A structure for "People Also Ask" boxes

- **Generates schema markup:**

- - Article, FAQ, HowTo, Product, Event, Video, Review, Breadcrumb, Organization schema

- - Intelligent selection based on content type

- - JSON-LD format (works with any SEO plugin)

+ **Provides:**

+ - Comprehensive SEO health score (0-100)

+ - Page-by-page opportunity analysis

+ - Automated duplicate creation with all fixes applied

+ - Intelligent schema markup generation based on content type

+ - Before/after comparison for every fix

+ - Plugin-specific guidance (Yoast SEO, Rank Math, or plugin-agnostic)

- **Auto-creates optimized duplicates:**

- - Asks for user approval first

- - Creates duplicates with all fixes applied

- - Updates titles, meta descriptions, headings

- - Adds missing alt text

- - Inserts appropriate schema markup

- - Provides before/after comparison

+ **Generates Schema Markup:**

+ - Article schema (blog posts, news)

+ - FAQ schema (Q&A content detected)

+ - HowTo schema (tutorial/guide content)

+ - Product schema (WooCommerce products - requires WooCommerce add-on)

+ - Event schema (event content detected)

+ - Video schema (embedded videos detected)

+ - Review schema (review content detected)

+ - Breadcrumb schema (site navigation)

+ - Organization/Website schema (site-wide)

## Requirements

- - Respira for WordPress plugin installed

- - MCP connection active

- - WooCommerce add-on (optional - for Product schema)

+ - Respira for WordPress plugin installed and connected

+ - MCP connection active (desktop or WebMCP)

+ - WooCommerce add-on (optional - for product schema)

+ - Read access to scan site, write access to create duplicates

- ## How to Use

+ ## Trigger Phrase

- ### Trigger Phrases

- "amplify my seo and aeo"

+ ## Alternative Triggers

- "optimize my site for search engines"

- "run seo aeo audit"

- "improve my search visibility"

- "scan for seo opportunities"

- ### Workflow

+ ## Execution Workflow

- **Phase 1: Comprehensive Audit**

- 1. Scans all published pages and posts

- 2. Detects installed SEO plugins (Yoast, Rank Math)

- 3. Analyzes content for SEO issues

- 4. Identifies AEO opportunities

- 5. Scores each page by opportunity (high/medium/low)

- 6. Generates comprehensive report

+ ### Phase 1: Comprehensive Audit

- **Phase 2: User Decision**

- Presents report and asks:

- > "I found [X] pages with SEO/AEO improvement opportunities. Would you like me to create optimized duplicates for all of them?"

+ 1. Verify Respira + MCP connection via `respira_get_site_context`. If unavailable, stop and show setup guidance.

+ 2. Detect SEO plugin setup using `respira_list_plugins`:

+ - Yoast SEO

+ - Rank Math

+ - No SEO plugin

+ 3. Scan all published pages and posts:

+ - `respira_list_pages`

+ - `respira_list_posts`

+ 4. For each content item, load content and metadata:

+ - `respira_read_page` or `respira_read_post`

+ - `respira_get_builder_info` when needed

+ 5. Analyze on-page SEO:

+ - Title quality (length, uniqueness, keyword coverage)

+ - Meta description quality (presence, length, CTR intent)

+ - Heading hierarchy (single H1, no level skips)

+ - Image alt text coverage (`respira_list_media` + in-content image checks)

+ - Content depth (word count, readability proxy)

+ - Internal links and orphaned pages

+ - URL slug descriptiveness

+ 6. Analyze AEO opportunities:

+ - FAQ potential (question patterns)

+ - HowTo potential (step-by-step patterns)

+ - Featured snippet opportunities

+ - Missing table of contents on long-form pages

+ - Missing structured data per content type

+ 7. Build opportunity scoring:

+ - Critical / High / Medium / Low

+ - Per-page opportunity score (0-100)

+ 8. Produce full report with:

+ - Overall health score

+ - Priority matrix

+ - Top opportunity pages

+ - Plugin-specific integration notes

- **Phase 3: Auto-Fix (if approved)**

- 7. Creates duplicate for each page with issues

- 8. Applies all fixes to duplicates

- 9. Inserts JSON-LD schema markup

- 10. Provides before/after comparison

- 11. User reviews and approves to publish

+ ### Phase 2: Ask for Confirmation

- For detailed workflow and example output, see `references/workflow-details.md`

+ After report, ask:

- ## SEO Plugin Integration

+ > I found [X] pages with SEO/AEO opportunities. Would you like me to create optimized duplicates for all of them? You will review before publishing.

- **Works with:**

- - Yoast SEO - reads existing meta, populates Yoast fields on duplicates

- - Rank Math - reads existing meta, populates Rank Math fields

- - No plugin - adds meta tags directly, fully functional

+ If user declines, stop after delivering recommendations.

- Schema markup inserted as JSON-LD works alongside any plugin.

+ ### Phase 3: Auto-Fix on Duplicates (Only If Approved)

- ## Honest Disclaimer

+ 1. For each selected page/post:

+ - Create duplicate with `respira_create_duplicate`

+ 2. Apply fixes on duplicate only:

+ - Optimize title tags (target < 60 chars)

+ - Generate/rewrite meta descriptions (target 150-160 chars)

+ - Fix heading structure (single H1, logical hierarchy)

+ - Add/repair image alt text

+ - Add table of contents for long-form pages

+ - Restructure Q&A blocks for FAQ readiness

+ - Generate and inject JSON-LD schema markup

+ - Improve URL slug when safe and requested

+ 3. Save duplicate:

+ - `respira_update_page` / `respira_update_post`

+ 4. Produce before/after comparison snapshots for representative pages

+ 5. Summarize totals:

+ - Duplicates created

+ - Titles/meta/schema/alt/headings fixed

- This skill **identifies** SEO and AEO opportunities and **creates optimized duplicates**. You review and approve before anything goes live.

+ ## Plugin Integration Behavior

- **What this skill CANNOT do:**

- - Guarantee higher rankings (SEO is competitive)

- - Fix technical SEO issues (site speed, server config)

- - Write entirely new content (expands/optimizes existing)

- - Automatically publish changes (you review first)

+ ### Yoast SEO detected

- **What this skill CAN do:**

- - Identify every on-page SEO issue across your entire site

- - Generate intelligent schema markup based on content analysis

- - Create optimized duplicates with all fixes applied

- - Provide before/after comparisons for transparency

+ - Read Yoast metadata

+ - Populate Yoast-compatible meta fields on duplicates

+ - Add JSON-LD schema only where Yoast does not already cover the content type

+ - Suggest focus keywords and readability improvements

+ ### Rank Math detected

+ - Read Rank Math metadata

+ - Populate Rank Math-compatible meta fields on duplicates

+ - Add JSON-LD schema where missing

+ ### No SEO plugin detected

+ - Insert meta tags and JSON-LD directly in duplicate content

+ - Recommend optional Yoast or Rank Math adoption

+ ## Schema Generation Rules

+ Generate schema based on detected content intent:

+ - **Article:** blog/news/editorial content

+ - **FAQPage:** clear Q&A content patterns

+ - **HowTo:** procedural/step-by-step content

+ - **Product:** WooCommerce products (if add-on/tools available)

+ - **Event:** event date/location content

+ - **VideoObject:** embedded YouTube/Vimeo/video blocks

+ - **Review:** clear review/rating content

+ - **BreadcrumbList:** URL hierarchy

+ - **Organization / WebSite:** site-level identity signals

+ All schema must be JSON-LD and valid structure-first (no fabricated claims).

+ ## Output Format

+ Always include:

+ 1. **Executive summary**

+ 2. **Overall score + severity counts**

+ 3. **Top opportunities with impact rationale**

+ 4. **Plugin integration notes**

+ 5. **Clear confirmation prompt for duplicate creation**

+ If auto-fix is run, also include:

+ 6. **Fix summary totals**

+ 7. **Before/after samples**

+ 8. **Review instructions in WordPress admin**

## Safety Model

- - **Read-only audit** - initial scan makes no changes

- - **User confirmation required** - asks before creating duplicates

- - **Duplicate-first** - all fixes applied to duplicates, never live pages

- - **Approval required** - you review every change before publishing

- - **Rollback ready** - can delete all duplicates and start over

+ - Read-only audit first

+ - Explicit user confirmation before changes

+ - Duplicate-first changes only

+ - Never auto-publish

+ - Provide rollback guidance

+ - Preserve live content unless user explicitly approves publishing workflow

- ## Technical Details

+ ## Honest Disclaimer

- Uses these Respira MCP tools:

- - `wordpress_list_pages` / `wordpress_list_posts` - scan content

- - `wordpress_get_page` / `wordpress_get_post` - read content

- - `wordpress_detect_page_builder` - identify builder for extraction

- - `wordpress_list_media` - check image alt text

- - `wordpress_list_plugins` - detect Yoast, Rank Math

- - `wordpress_create_duplicate` - create duplicates

- - `wordpress_update_page` / `wordpress_update_post` - apply fixes

+ This skill identifies SEO/AEO opportunities and creates optimized duplicates for review.

- For complete tool reference and schema markup details, see `references/technical-details.md`

+ It cannot:

+ - Guarantee rankings

+ - Fix off-page SEO or backlinks

+ - Fix server-level technical SEO by itself

+ - Publish without review

+ It can:

+ - Find broad on-page SEO and AEO gaps

+ - Generate structured schema recommendations and implementation

+ - Create transparent before/after duplicate drafts quickly

+ ## Tooling

+ **Core WordPress tools**

+ - `respira_get_site_context`

+ - `respira_list_pages`

+ - `respira_list_posts`

+ - `respira_read_page`

+ - `respira_read_post`

+ - `respira_get_builder_info`

+ - `respira_list_media`

+ - `respira_list_plugins`

+ - `respira_create_duplicate`

+ - `respira_update_page`

+ - `respira_update_post`

+ **WooCommerce tools (optional)**

+ - `woocommerce_list_products`

+ - `woocommerce_get_product`

+ ## Telemetry

+ After run completion, send fire-and-forget usage tracking to:

+ - `POST https://www.respira.press/api/skills/track-usage`

+ Include:

+ - `skill_slug = seo-aeo-amplifier`

+ - site/version context

+ - duration and success

+ - issues found and fixes applied counts

+ - tools used

+ Never block user flow on telemetry failure.

## Related Skills

- - WordPress AI Image Optimizer - optimizes images for speed and SEO

- - WordPress Site DNA - comprehensive site analysis

- - Mobile Experience Report - mobile SEO and UX

+ - WordPress Site DNA

+ - Technical Debt Audit

+ - Mobile Experience Report

---

- Built by Respira for WordPress

- https://respira.press

+ Built by Respira Team

+ https://respira.press/skills/seo-aeo-amplifier