agent-skills-wordpress

SEO & AEO Amplifier

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

Finds:

• Missing or weak title tags and meta descriptions
• 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 pointing to them)
• Non-descriptive URL slugs
• Content that could answer questions but lacks FAQ schema
• Missing structured data (Article, HowTo, Product, Event, Video, Review)
• Content not optimized for featured snippets
• Missing table of contents on long-form content
• No clear Q&A structure for "People Also Ask" boxes

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)

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 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

Trigger Phrase

• "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"

Execution Workflow

Phase 1: Comprehensive Audit

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:
3. Yoast SEO
4. Rank Math
5. No SEO plugin
6. Scan all published pages and posts:
7. respira_list_pages
8. respira_list_posts
9. For each content item, load content and metadata:
10. respira_read_page or respira_read_post
11. respira_get_builder_info when needed
12. Analyze on-page SEO:
13. Title quality (length, uniqueness, keyword coverage)
14. Meta description quality (presence, length, CTR intent)
15. Heading hierarchy (single H1, no level skips)
16. Image alt text coverage (respira_list_media + in-content image checks)
17. Content depth (word count, readability proxy)
18. Internal links and orphaned pages
19. URL slug descriptiveness
20. Analyze AEO opportunities:
21. FAQ potential (question patterns)
22. HowTo potential (step-by-step patterns)
23. Featured snippet opportunities
24. Missing table of contents on long-form pages
25. Missing structured data per content type
26. Build opportunity scoring:
27. Critical / High / Medium / Low
28. Per-page opportunity score (0-100)
29. Produce full report with:
30. Overall health score
31. Priority matrix
32. Top opportunity pages
33. Plugin-specific integration notes

Phase 2: Ask for Confirmation

After report, ask:

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.

If user declines, stop after delivering recommendations.

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

1. For each selected page/post:
2. Create duplicate with respira_create_duplicate
3. Apply fixes on duplicate only:
4. Optimize title tags (target < 60 chars)
5. Generate/rewrite meta descriptions (target 150-160 chars)
6. Fix heading structure (single H1, logical hierarchy)
7. Add/repair image alt text
8. Add table of contents for long-form pages
9. Restructure Q&A blocks for FAQ readiness
10. Generate and inject JSON-LD schema markup
11. Improve URL slug when safe and requested
12. Save duplicate:
13. respira_update_page / respira_update_post
14. Produce before/after comparison snapshots for representative pages
15. Summarize totals:
16. Duplicates created
17. Titles/meta/schema/alt/headings fixed

Plugin Integration Behavior

Yoast SEO detected

• 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:

1. Fix summary totals
2. Before/after samples
3. Review instructions in WordPress admin

Safety Model

• 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

Honest Disclaimer

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

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 Site DNA
• Technical Debt Audit
• Mobile Experience Report

Built by Respira Team https://respira.press/skills/seo-aeo-amplifier