**Version:** 1.3.0 **Updated:** 2026-06-30 **Freshly updated:** v1.3.0 takes a snapshot with respira_get_snapshot before any edit so every change is one-click reversible, switches from full extract/inject to surgical respira_find_element + respira_update_element edits for meta
Installs just this skill. Get the whole plugin for auto-invocation.
⚡ How it fires
How this skill gets triggered: by you, by Claude, or both.
Fires itselfClaude auto-loads it when your prompt matches the work.
You can call itInvoke it directly when you want it.
Slash command/seo-aeo-amplifier
👁️ Context preview
The summary Claude sees to decide when to auto-load this skill.
**Version:** 1.3.0 **Updated:** 2026-06-30 **Freshly updated:** v1.3.0 takes a snapshot with respira_get_snapshot before any edit so every change is one-click reversible, switches from full extract/inject to surgical respira_find_element + respira_update_element edits for meta
# SEO & AEO Amplifier
**Version:** 1.3.0
**Updated:** 2026-06-30
**Freshly updated:** v1.3.0 takes a snapshot with respira_get_snapshot before any edit so every change is one-click reversible, switches from full extract/inject to surgical respira_find_element + respira_update_element edits for meta titles, descriptions and H1s, applies schema and meta across many pages in a single safe pass with respira_batch_update, and wires respira_generate_activity_report into the "SEO work done -> client report" handoff. Also leans on the real SEO analysis tools (respira_analyze_seo, respira_analyze_aeo, respira_analyze_rankmath, respira_check_seo_issues, respira_check_structured_data) instead of hand-rolled scoring.
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
- 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`:
- 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. Prefer the real analysis tools over hand-rolled checks:
- `respira_analyze_seo` for the on-page SEO pass (title, meta, headings, content depth, links)
- `respira_check_seo_issues` for the prioritized issue list per page
- `respira_analyze_rankmath` when Rank Math is detected (reads its score and recommendations)
- `respira_check_structured_data` to see which schema types already exist vs are missing
- Supplement with `respira_list_media` + in-content image checks for alt text coverage
- Cross-checks the tools cover: title quality, meta description quality, heading hierarchy (single H1, no level skips), content depth, internal links / orphaned pages, URL slug descriptiveness
6. Analyze AEO opportunities with `respira_analyze_aeo` (answer-engine readiness), plus `respira_check_structured_data`:
- 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 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. **Snapshot first.** Before touching anything, take a snapshot with `respira_get_snapshot` so the whole pass is one-click reversible via `respira_restore_snapshot` if a fix looks wrong.
2. For each selected page/post:
- Create the review copy with `respira_create_page_duplicate` (pages) or `respira_create_post_duplicate` (posts)
3. Apply fixes on the duplicate only. Use surgical edits, not full extract/inject:
- **Locate the exact node first** with `respira_find_element` (find the meta title, meta description, and the H1 / heading elements), then change only that node with `respira_update_element`. This avoids re-writing the whole page and keeps the builder's structure intact.
- Optimize title tags (target < 60 chars)
- Generate/rewrite meta descriptions (target 150-160 chars)
4. **Apply the same fix across many pages in one safe pass** with `respira_batch_update` (for example, the same Organization/WebSite schema or a meta pattern across a set of duplicates) instead of looping one slow update at a time.
5. Save remaining page-level changes with `respira_update_page` / `respira_update_post`.
6. Verify with `respira_check_seo_issues` / `respira_check_structured_data` on a sample of the fixed duplicates to confirm the issues actually cleared.
7. Produce before/after comparison snapshots for representative pages.
8. Summarize totals:
- Duplicates created
- Titles/meta/schema/alt/headings fixed
- Snapshot id (so the user knows the rollback point)
## 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
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 first
- Snapshot via `respira_get_snapshot` before any write, restore with `respira_restore_snapshot`
- Explicit user confirmation before changes
- Duplicate-first changes only
- Never auto-publish
- Provide rollback guidance
- Preserve live content unless user explicitly approves publishing workflow
## Client Report Handoff
When the audit and (optional) fixes are done, turn the SEO work into a deliverable the customer can hand to a client or keep for their own records:
- Call `respira_generate_activity_report` to pull the actual edits made in this session (titles, meta, schema, alt text, headings) into a structured "SEO work done" report.
- Pair it with the before/after samples and the snapshot id from Phase 3 so the report shows what changed and how to roll it back.
- Good fit for monthly retainers: run the audit, apply approved fixes on duplicates, then export the activity report as the month's SEO summary.
## 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
