feat: add SEO-AEO Engine skill bundle (8 skills) for content growth a… (#446)

* feat: add SEO-AEO Engine skill bundle (8 skills) for content growth and AEO optimization * fix: resolve P1 invalid JSON-LD and P2 missing references/ in schema-generator --------- Co-authored-by: Antigravity Agent <bot@example.com>
2026-04-04 17:51:09 +01:00
parent bddde3dac2
commit 4961ce5ed5
8 changed files with 756 additions and 0 deletions
--- a/skills/seo-aeo-blog-writer/SKILL.md
+++ b/skills/seo-aeo-blog-writer/SKILL.md
@@ -0,0 +1,88 @@
+---
+name: seo-aeo-blog-writer
+description: "Writes long-form blog posts with TL;DR block, definition sentence, comparison table, and 5-question FAQ for SEO ranking and AEO citation. Activate when the user wants to write a blog post, article, or long-form content piece."
+risk: safe
+source: community
+date_added: "2026-04-01"
+---
+
+# SEO-AEO Blog Writer
+
+## Overview
+
+Writes structured long-form blog posts (800–3000 words) that satisfy both SEO ranking signals and AEO citation requirements. Every post includes a TL;DR direct-answer block, a definition sentence, structured H2/H3 hierarchy, a comparison table where relevant, and exactly 5 FAQ entries written for AI extraction.
+
+Part of the [SEO-AEO Engine](https://github.com/mrprewsh/seo-aeo-engine).
+
+## When to Use This Skill
+
+- Use when writing a cluster article from a content cluster map
+- Use when creating a long-form guide to build topical authority
+- Use when you need content that can be cited by AI engines like Perplexity or ChatGPT
+- Use when you need a blog post that follows a consistent, auditable structure
+
+## How It Works
+
+### Step 1: Write the TL;DR Block First
+Write a 2–3 sentence direct answer to the article's core question. Place it immediately after the H1 in a blockquote. This is the first block AI engines attempt to extract.
+
+### Step 2: Build the Heading Skeleton
+Set H1, H2s (4–6), and H3s before writing any body content. The first H2 must be a "What Is" section with a clean definition sentence as its opening line.
+
+### Step 3: Write Body Sections
+Follow the section order: What Is → Why It Matters → How It Works (with H3 sub-concepts) → Practical Steps → Common Mistakes → FAQ → Conclusion.
+
+### Step 4: Write 5 FAQ Entries
+Use long-tail and secondary keywords as questions. Each answer must be under 50 words and self-contained — readable without any surrounding context.
+
+### Step 5: Run AEO and SEO Checklists
+Verify TL;DR presence, definition sentence, FAQ count, keyword placement, and heading structure before outputting.
+
+## Examples
+
+### Example: TL;DR Block
+How to Manage a Remote Engineering Team
+
+TL;DR: Managing a remote engineering team requires async
+communication tools, clear documentation standards, and
+timezone-aware sprint planning. Teams that nail these three
+areas ship consistently regardless of where members are located.
+
+
+### Example: FAQ Section
+Q: What is the biggest challenge of remote engineering teams?
+A: Async communication. Without shared hours, decisions slow down
+and context gets lost. Teams that document decisions in writing
+and use structured standup tools close this gap fastest.
+Q: How do you run a daily standup with a remote team?
+A: Use async video or text standups posted at the start of each
+member's day. Tools like Loom or Slack threads work well.
+Avoid live calls across more than 2 timezones.
+
+## Best Practices
+
+- ✅ **Do:** Write the TL;DR block before writing anything else — it anchors the article
+- ✅ **Do:** Make the "What Is" definition sentence extractable on its own — one clean sentence
+- ✅ **Do:** Use secondary keywords as FAQ questions to capture long-tail traffic
+- ❌ **Don't:** Write FAQ answers longer than 50 words — AI engines skip long answers
+- ❌ **Don't:** Use duplicate H2 headings anywhere in the article
+- ❌ **Don't:** Skip the comparison table if the topic involves comparing options
+
+## Common Pitfalls
+
+- **Problem:** TL;DR block is too vague to be extracted as a direct answer
+  **Solution:** The TL;DR must answer the article's core question in 2–3 sentences. If it doesn't answer a specific question, rewrite it.
+
+- **Problem:** FAQ answers reference "as mentioned above" or other context
+  **Solution:** Every FAQ answer must stand completely alone — no references to other parts of the article.
+
+## Related Skills
+
+- `@seo-aeo-content-cluster` — provides the topic and keyword for this article
+- `@seo-aeo-content-quality-auditor` — audits the completed post for SEO and AEO signals
+- `@seo-aeo-internal-linking` — maps links between this post and related pages
+
+## Additional Resources
+
+- [SEO-AEO Engine Repository](https://github.com/mrprewsh/seo-aeo-engine)
+- [Full Blog Writer SKILL.md](https://github.com/mrprewsh/seo-aeo-engine/blob/main/.agent/skills/blog-writer/SKILL.md)
--- a/skills/seo-aeo-content-cluster/SKILL.md
+++ b/skills/seo-aeo-content-cluster/SKILL.md
@@ -0,0 +1,89 @@
+---
+name: seo-aeo-content-cluster
+description: "Builds a topical authority map with a pillar page, prioritised cluster articles, content types, internal link map, and content gap analysis. Activate when the user wants to build a content cluster, topic map, or content strategy."
+risk: safe
+source: community
+date_added: "2026-04-01"
+---
+
+# SEO-AEO Content Cluster
+
+## Overview
+
+Maps out a complete topical authority structure around a pillar keyword. Produces a pillar page definition, 8–15 cluster articles sorted into Priority 1/2/3 tiers, a content type for each, an internal link map, and a content gap analysis identifying AEO opportunities competitors are missing.
+
+Part of the [SEO-AEO Engine](https://github.com/mrprewsh/seo-aeo-engine).
+
+## When to Use This Skill
+
+- Use when building topical authority around a new subject
+- Use when you need to know what to write next to support a pillar page
+- Use when planning a content calendar for a niche
+- Use when you want to identify AEO content gaps competitors are missing
+
+## How It Works
+
+### Step 1: Define the Pillar Page
+Set the primary keyword, target audience, and word count target (2500–4000 words) for the pillar page that anchors the cluster.
+
+### Step 2: Generate Cluster Articles
+Produce 8–15 subtopics sorted into three priority tiers:
+- **Priority 1** — High volume, clear intent. Write these first.
+- **Priority 2** — Medium volume, long-tail focus. Write second.
+- **Priority 3** — Low volume, high conversion intent. Write last.
+
+Assign each article a unique keyword, content type, search intent, and link map.
+
+### Step 3: Build Internal Link Map
+Every cluster article must link back to the pillar page. No orphan articles. Show the full tree of relationships.
+
+### Step 4: Run Content Gap Analysis
+Identify angles that competitors likely miss — especially question-based AEO opportunities that AI engines commonly surface.
+
+## Examples
+
+### Example: Automated Budgeting Cluster
+Pillar: The Complete Guide to Automated Budgeting
+Priority 1:
+
+How to Build a Budget That Actually Works | how-to guide
+Best Budgeting Apps Compared | comparison
+What Is Zero-Based Budgeting? | explainer ← AEO priority
+
+Priority 2:
+4. How to Automate Your Savings in 3 Steps | how-to guide
+5. Budgeting for Millennials: What Nobody Tells You | opinion
+Link Map:
+Pillar ← Article 1, 2, 3, 4, 5
+Article 1 ↔ Article 4
+Article 2 → Article 3
+AEO Priority:
+★ Article 3 — "What Is" format has highest AI extraction probability
+★ Article 2 — comparison table will be lifted for product queries
+
+## Best Practices
+
+- ✅ **Do:** Assign every cluster article a unique target keyword — no overlap
+- ✅ **Do:** Include at least one FAQ page and one comparison article in every cluster
+- ✅ **Do:** Flag the 2 highest AEO-opportunity articles for priority writing
+- ❌ **Don't:** Let any article become an orphan — every article links to at least one other
+- ❌ **Don't:** Target the same keyword on both the pillar and a cluster article
+
+## Common Pitfalls
+
+- **Problem:** Cluster articles all target similar keywords and cannibalise each other
+  **Solution:** Run a uniqueness check — every article needs a distinct keyword with no semantic overlap.
+
+- **Problem:** No AEO content in the cluster
+  **Solution:** At least 2 articles must be structured as direct-answer pages (FAQ or "What Is" explainer).
+
+## Related Skills
+
+- `@seo-aeo-keyword-research` — provides the keyword foundation for the cluster
+- `@seo-aeo-blog-writer` — writes the Priority 1 cluster articles
+- `@seo-aeo-internal-linking` — builds the detailed link map from cluster output
+
+## Additional Resources
+
+- [SEO-AEO Engine Repository](https://github.com/mrprewsh/seo-aeo-engine)
+- [Full Content Cluster SKILL.md](https://github.com/mrprewsh/seo-aeo-engine/blob/main/.agent/skills/content-cluster/SKILL.md)
--- a/skills/seo-aeo-content-quality-auditor/SKILL.md
+++ b/skills/seo-aeo-content-quality-auditor/SKILL.md
@@ -0,0 +1,93 @@
+---
+name: seo-aeo-content-quality-auditor
+description: "Audits content for SEO and AEO performance with scored reports, severity-ranked fix lists, and projected scores after fixes. Activate when the user wants to audit, review, or score content for SEO or AEO compliance."
+risk: safe
+source: community
+date_added: "2026-04-01"
+---
+
+# SEO-AEO Content Quality Auditor
+
+## Overview
+
+Runs a dual SEO + AEO audit on any landing page or blog post. Produces an overall score, SEO score, AEO score, and readability score — each out of 100 — with severity-ranked issue lists (Critical / Warning / Polish), exact fix instructions for every issue, and projected scores after all fixes are applied.
+
+Part of the [SEO-AEO Engine](https://github.com/mrprewsh/seo-aeo-engine).
+
+## When to Use This Skill
+
+- Use when auditing a landing page or blog post before publishing
+- Use after the blog-writer or landing-page-writer skill outputs content
+- Use when diagnosing why existing content is underperforming in search
+- Use when you need a scored, actionable SEO and AEO report
+
+## How It Works
+
+### Step 1: Run SEO Checks
+Verify keyword density, H1/H2/H3 structure, meta elements, word count, sentence length, and paragraph density. Flag every issue with its severity.
+
+### Step 2: Run AEO Checks
+Check for TL;DR block, definition sentence, FAQ section (minimum 4 entries), bullet and numbered lists, comparison table, and extractable direct answers. Score each signal as found or missing.
+
+### Step 3: Run Readability Checks
+Check passive voice ratio, transition word presence, wall-of-text paragraphs, subheading frequency, and reading level.
+
+### Step 4: Score and Prioritise
+Calculate three scores out of 100. Sort all issues into Critical (fix before publishing), Important (fix soon), and Polish (optional improvements). Generate projected scores after all fixes are applied.
+
+## Scoring System
+
+| Score | Status | Label |
+|-------|--------|-------|
+| 85–100 | ✅ Pass | Strong |
+| 70–84 | ⚠️ Warn | Acceptable |
+| 50–69 | 🔶 Weak | Needs work |
+| 0–49 | ❌ Fail | Do not publish |
+
+## Examples
+
+### Example: Audit Summary
+Overall Score:    84/100  ⚠️ Acceptable
+SEO Score:        88/100  ✅ Pass
+AEO Score:        74/100  ⚠️ Acceptable
+Readability:      91/100  ✅ Pass
+Verdict: Strong SEO foundation. AEO needs a TL;DR block
+and one more FAQ entry before publishing.
+🔴 Critical (fix before publishing):
+
+AEO: No TL;DR block found
+Fix: Add a 2–3 sentence direct-answer block in a
+blockquote immediately after the H1.
+
+🟡 Important (fix soon):
+2. AEO: FAQ has 3 entries — minimum is 4
+Fix: Add one more FAQ entry using a secondary keyword
+as the question.
+Projected score after fixes: 93/100 ✅
+
+## Best Practices
+
+- ✅ **Do:** Fix all Critical issues before publishing — they block AEO extraction
+- ✅ **Do:** Use the projected score to prioritise which fixes to make first
+- ✅ **Do:** Run the audit on both the landing page and blog post in the same session
+- ❌ **Don't:** Publish content scoring below 50/100 overall
+- ❌ **Don't:** Ignore AEO warnings — they directly affect AI engine citation probability
+
+## Common Pitfalls
+
+- **Problem:** SEO score is high but AEO score is low
+  **Solution:** Traditional SEO tools miss AEO signals entirely. Run the AEO checklist separately and treat it as equally important.
+
+- **Problem:** Fix list is long and overwhelming
+  **Solution:** Work through Critical issues only first, re-run the audit, then tackle Important issues.
+
+## Related Skills
+
+- `@seo-aeo-blog-writer` — produces the content this skill audits
+- `@seo-aeo-landing-page-writer` — produces landing pages this skill audits
+- `@seo-aeo-schema-generator` — uses audit output to determine schema priorities
+
+## Additional Resources
+
+- [SEO-AEO Engine Repository](https://github.com/mrprewsh/seo-aeo-engine)
+- [Full Content Quality Auditor SKILL.md](https://github.com/mrprewsh/seo-aeo-engine/blob/main/.agent/skills/content-quality-auditor/SKILL.md)
--- a/skills/seo-aeo-internal-linking/SKILL.md
+++ b/skills/seo-aeo-internal-linking/SKILL.md
@@ -0,0 +1,85 @@
+---
+name: seo-aeo-internal-linking
+description: "Maps internal link opportunities between pages with anchor text, placement instructions, orphan page detection, and cannibalization checks. Activate when the user wants to build an internal linking strategy or find link opportunities."
+risk: safe
+source: community
+date_added: "2026-04-01"
+---
+
+# SEO-AEO Internal Linking
+
+## Overview
+
+Analyses a set of pages and produces a prioritised list of internal link opportunities with exact anchor text, a context sentence showing where each link should appear, orphan page detection, anchor text cannibalization warnings, and a link equity map showing how authority flows across the content.
+
+Part of the [SEO-AEO Engine](https://github.com/mrprewsh/seo-aeo-engine).
+
+## When to Use This Skill
+
+- Use when building internal links between a new pillar page and its cluster articles
+- Use when auditing an existing site for orphan pages
+- Use after content-cluster generates a topic map
+- Use when you need anchor text suggestions with placement context
+
+## How It Works
+
+### Step 1: Detect Orphan Pages
+Flag any page with zero incoming internal links. These are invisible to search engines and must be linked immediately.
+
+### Step 2: Build Semantic Overlap Matrix
+Match pages by primary keyword similarity and content summary to identify natural linking opportunities.
+
+### Step 3: Assign Link Types
+Every suggestion gets one of four labels:
+- **Cluster → Pillar** — highest priority, consolidates authority upward
+- **Pillar → Cluster** — distributes authority downward
+- **Cluster → Cluster** — builds semantic depth
+- **Contextual Boost** — concentrates equity on a focus page
+
+### Step 4: Write Context Sentences
+For every link opportunity, write the sentence the anchor text should appear in — naturally placed, not forced.
+
+### Step 5: Check Anchor Text
+Flag any exact-match anchor used more than once for the same target page as a cannibalization risk. Never use generic anchors like "click here".
+
+## Examples
+
+### Example: Link Opportunity Output
+🔴 High Priority — Link 1
+Type: Cluster → Pillar
+Source: "How to Build a Budget That Actually Works"
+Target: "The Complete Guide to Automated Budgeting"
+Anchor: "automated budgeting guide"
+Context: "For a full breakdown of every method available,
+see our [automated budgeting guide]."
+Impact: Consolidates topical authority on pillar page.
+Orphan Alert:
+"PennyWise Pricing Page" has no incoming links.
+Fix: Add link from comparison table in Article 2.
+
+## Best Practices
+
+- ✅ **Do:** Every cluster article must have at least one Cluster → Pillar link
+- ✅ **Do:** Write a context sentence for every suggestion — anchor text needs natural placement
+- ✅ **Do:** Fix orphan pages before adding any new links
+- ❌ **Don't:** Use the same exact-match anchor for the same target page more than once
+- ❌ **Don't:** Use "click here", "read more", or "learn more" as anchor text — ever
+- ❌ **Don't:** Add more than 100 outgoing internal links on any single page
+
+## Common Pitfalls
+
+- **Problem:** All cluster articles link to the pillar but not to each other
+  **Solution:** Add Cluster → Cluster links between semantically related articles to build depth.
+
+- **Problem:** Same anchor text used across multiple pages for the same target
+  **Solution:** Use partial match and branded anchors for subsequent links after the first exact-match use.
+
+## Related Skills
+
+- `@seo-aeo-content-cluster` — generates the cluster map this skill links together
+- `@seo-aeo-schema-generator` — uses link map output for BreadcrumbList schema
+
+## Additional Resources
+
+- [SEO-AEO Engine Repository](https://github.com/mrprewsh/seo-aeo-engine)
+- [Full Internal Linking SKILL.md](https://github.com/mrprewsh/seo-aeo-engine/blob/main/.agent/skills/internal-linking/SKILL.md)
--- a/skills/seo-aeo-keyword-research/SKILL.md
+++ b/skills/seo-aeo-keyword-research/SKILL.md
@@ -0,0 +1,113 @@
+---
+name: seo-aeo-keyword-research
+description: "Researches and prioritises SEO keywords with AEO question queries, difficulty tiers, cannibalization checks, and a content map. Activate when the user wants to find keywords, research search terms, or build a keyword strategy."
+risk: safe
+source: community
+date_added: "2026-04-01"
+---
+
+# SEO-AEO Keyword Research
+
+## Overview
+
+Identifies high-value SEO keywords and AEO question-based queries for a topic. Produces keyword tiers (easy wins to long-term goals), search intent classification, cannibalization checks, and a content production map — all from a single topic input.
+
+Part of the [SEO-AEO Engine](https://github.com/mrprewsh/seo-aeo-engine) — an open-source AI-powered content growth system.
+
+## When to Use This Skill
+
+- Use when you need to build a keyword strategy for a new topic or niche
+- Use when you want to find AEO question queries for AI engine citation
+- Use when you need to prioritise which keywords to target first
+- Use when you want to check for keyword cannibalization before writing content
+
+## How It Works
+
+### Step 1: Extract Seed Keywords
+Identify 3–5 core terms that anchor the topic's search territory. Go beyond the obvious head term to include adjacent terms the audience actually uses.
+
+### Step 2: Expand Into Tiers
+Sort all keywords into three tiers:
+- **Tier 1** — Low-to-moderate difficulty. Target first.
+- **Tier 2** — Medium difficulty. Build toward after Tier 1 content is live.
+- **Tier 3** — High difficulty. Long-term goals only.
+
+### Step 3: Generate AEO Keywords
+Produce question-based keywords that AI engines surface in direct answers and People Also Ask boxes. For each AEO keyword, specify the answer format to use (definition sentence, numbered steps, comparison table, direct number).
+
+### Step 4: Run Cannibalization Check
+Flag any two keywords similar enough to split traffic if targeted on separate pages. Recommend which page should own which term.
+
+### Step 5: Build Content Map
+Recommend content type and production order for all Tier 1 and Tier 2 keywords.
+
+## Examples
+
+### Example 1: SaaS Product
+Input: topic = "remote project management software"
+audience = "engineering managers and startup founders"
+goal = "convert"
+Output:
+Tier 1 Keywords:
+
+"remote project management software" | Medium volume | Difficulty: 38
+"project management tool remote teams" | Low volume | Difficulty: 29
+
+AEO Keywords:
+
+"What is the best project management software for remote teams?"
+→ Answer format: Comparison table
+"How does remote project management work?"
+→ Answer format: Numbered steps
+
+Content Map:
+
+Landing page → "remote project management software"
+Pillar blog → "complete guide to remote project management"
+Cluster article → "how to manage remote engineering teams"
+
+
+### Example 2: Fintech App
+Input: topic = "automated budgeting app"
+audience = "millennials managing personal finances"
+goal = "all"
+Output:
+Tier 1 Keywords:
+
+"automated budgeting app" | Medium volume | Difficulty: 33
+"automatic savings app" | Low volume | Difficulty: 24
+
+AEO Keywords:
+
+"What is the best budgeting app for millennials?"
+→ Answer format: Comparison table
+"How does automated budgeting work?"
+→ Answer format: Numbered steps
+
+
+## Best Practices
+
+- ✅ **Do:** Target Tier 1 keywords first — build authority before going after competitive terms
+- ✅ **Do:** Use AEO keywords in FAQ sections and definition blocks for AI engine citation
+- ✅ **Do:** Validate estimated volume and difficulty with a live tool (Ahrefs, SEMrush) before committing
+- ❌ **Don't:** Target two keywords on the same page if cannibalization is flagged
+- ❌ **Don't:** Use volume as the only prioritisation signal — difficulty and intent matter more
+
+## Common Pitfalls
+
+- **Problem:** High-volume keyword chosen but impossible to rank for early on
+  **Solution:** Always cross-check volume with difficulty. Tier 1 should have difficulty under 45.
+
+- **Problem:** AEO keywords ignored in favour of traditional search terms
+  **Solution:** AEO keywords drive AI engine citation — include at least 5 in every research run.
+
+## Related Skills
+
+- `@seo-aeo-content-cluster` — uses keyword research output to build topic cluster
+- `@seo-aeo-landing-page-writer` — consumes primary keyword to generate landing page
+- `@seo-aeo-blog-writer` — uses secondary keywords for cluster article targeting
+
+## Additional Resources
+
+- [SEO-AEO Engine Repository](https://github.com/mrprewsh/seo-aeo-engine)
+- [Full Keyword Research SKILL.md](https://github.com/mrprewsh/seo-aeo-engine/blob/main/.agent/skills/keyword-research/SKILL.md)
--- a/skills/seo-aeo-landing-page-writer/SKILL.md
+++ b/skills/seo-aeo-landing-page-writer/SKILL.md
@@ -0,0 +1,98 @@
+---
+name: seo-aeo-landing-page-writer
+description: "Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer."
+risk: safe
+source: community
+date_added: "2026-04-01"
+---
+
+# SEO-AEO Landing Page Writer
+
+## Overview
+
+Generates a full, publish-ready landing page following a defined section order with SEO heading structure, AEO extraction blocks, FAQ section, comparison table, social proof, and conversion-focused CTAs. Every section serves a specific purpose in a narrative arc that moves the visitor from awareness to action.
+
+Part of the [SEO-AEO Engine](https://github.com/mrprewsh/seo-aeo-engine).
+
+## When to Use This Skill
+
+- Use when building a landing page for a new product or service
+- Use when an existing landing page needs a full SEO and AEO rewrite
+- Use when you need a page that can be cited by AI engines like Perplexity or ChatGPT
+- Use when you want conversion copy that leads with pain before pitching the product
+
+## How It Works
+
+### Step 1: Map Inputs
+Extract product name, audience, primary keyword, pain points, features, benefits, USPs, social proof, and CTAs. Map every feature to a user outcome before writing any copy.
+
+### Step 2: Write AEO Extraction Sentence
+Write one 25–40 word sentence that answers "What is [product]?" — standalone, no jargon, placed in a blockquote immediately after the H1. This is the sentence AI engines extract.
+
+### Step 3: Follow the Narrative Arc
+Write sections in this exact order:
+1. Hero — H1 + AEO sentence + CTA
+2. Problem — audience pain, no product mention yet
+3. Solution — introduce product as the answer
+4. Features as Benefits — table format
+5. Social Proof — testimonials, logos, stats
+6. Mid-page CTA
+7. How It Works — numbered steps
+8. Comparison — table with honest competitor comparison
+9. FAQ — minimum 6 entries, each under 50 words
+10. Trust Signals
+11. Final CTA
+
+### Step 4: Run SEO and AEO Checklists
+Verify keyword placement, heading hierarchy, FAQ count, AEO block presence, and meta description placeholder before outputting.
+
+## Examples
+
+### Example 1: Hero Section Output
+Ship Faster With Your Remote Team
+
+Syncro is a remote-first project management platform that helps
+distributed engineering teams track work, communicate
+asynchronously, and ship without the chaos of email and
+scattered spreadsheets.
+
+[Start Free Trial]  [See How It Works]
+"4,000+ remote teams" · "40% fewer status meetings" · "4.8/5 on G2"
+
+### Example 2: FAQ Section Output
+Q: What is Syncro?
+A: Syncro is a remote-first project management platform for
+distributed engineering teams. It centralises task tracking,
+async communication, and sprint planning in one tool.
+Q: How much does Syncro cost?
+A: Syncro offers a flat-rate plan at $49/month for unlimited
+users. A 14-day free trial is available — no credit card required.
+
+## Best Practices
+
+- ✅ **Do:** Write the problem section before mentioning the product — empathy first
+- ✅ **Do:** Place the AEO extraction sentence in a blockquote immediately after H1
+- ✅ **Do:** Write FAQ answers as standalone — each must make sense without context
+- ✅ **Do:** Include at least one honest point in the comparison table where the alternative wins
+- ❌ **Don't:** Use "revolutionary", "game-changing", or "best-in-class" anywhere
+- ❌ **Don't:** Use "Submit" or "Click Here" as CTA button text
+- ❌ **Don't:** Write paragraphs longer than 4 lines
+
+## Common Pitfalls
+
+- **Problem:** Product mentioned in the pain section
+  **Solution:** The pain section exists to build empathy. Save the product introduction for the solution section.
+
+- **Problem:** FAQ answers are too long to be extracted by AI engines
+  **Solution:** Every FAQ answer must be under 50 words and self-contained.
+
+## Related Skills
+
+- `@seo-aeo-keyword-research` — provides the primary keyword and AEO queries
+- `@seo-aeo-meta-description-generator` — writes title and meta description from page output
+- `@seo-aeo-content-quality-auditor` — audits the completed landing page
+
+## Additional Resources
+
+- [SEO-AEO Engine Repository](https://github.com/mrprewsh/seo-aeo-engine)
+- [Full Landing Page Writer SKILL.md](https://github.com/mrprewsh/seo-aeo-engine/blob/main/.agent/skills/landing-page-writer/SKILL.md)
--- a/skills/seo-aeo-meta-description-generator/SKILL.md
+++ b/skills/seo-aeo-meta-description-generator/SKILL.md
@@ -0,0 +1,87 @@
+---
+name: seo-aeo-meta-description-generator
+description: "Writes 3 title tag variants and 3 meta description variants per page with SERP preview, OG tags, and Twitter Card tags. Activate when the user wants to write meta tags, title tags, or social sharing tags for any page."
+risk: safe
+source: community
+date_added: "2026-04-01"
+---
+
+# SEO-AEO Meta Description Generator
+
+## Overview
+
+Produces 3 title tag variants and 3 meta description variants for any page, each using a different CTR mechanic (benefit lead, question hook, social proof). Also generates Open Graph and Twitter Card tags. Includes a SERP preview block and a variant comparison table with a recommended selection.
+
+Part of the [SEO-AEO Engine](https://github.com/mrprewsh/seo-aeo-engine).
+
+## When to Use This Skill
+
+- Use when a page needs a title tag and meta description written or optimised
+- Use when preparing social sharing tags for LinkedIn, X, or WhatsApp
+- Use when A/B testing CTR on search results
+- Use after the landing-page-writer or blog-writer skill completes
+
+## How It Works
+
+### Step 1: Identify CTR Angle Per Variant
+- **V1 Benefit Lead** — leads with the outcome or benefit
+- **V2 Question Hook** — opens with the question the searcher is asking
+- **V3 Social Proof / Specificity** — leads with a number, stat, or specific claim
+
+### Step 2: Apply Character Limits
+- Title tag: 50–60 characters (hard limit: 60)
+- Meta description: 140–155 characters (hard limit: 160)
+- Never end a description mid-sentence near the limit
+
+### Step 3: Apply CTR Rules
+- Primary keyword in first 3 words of every title variant
+- Primary keyword in first half of every description variant
+- At least one power word per description
+- Every description ends with a CTA verb
+- Never use "click here", passive openers, or all-caps
+
+### Step 4: Write Social Tags
+OG and Twitter tags can be more conversational than SERP tags. Write them as distinct copy — not copy-pastes of the meta description.
+
+## Examples
+
+### Example 1: Landing Page Variants
+Title V1: Remote Project Management Software | Syncro
+(51 chars) — Keyword first, brand at end
+Title V2: Manage Remote Teams Without the Chaos | Syncro
+(54 chars) — Pain-point led with power word
+Description V1 (Benefit Lead):
+Ship faster with your distributed team. Syncro centralises
+tasks, async updates, and sprints in one tool. Start free today.
+(141 chars) ✅
+Description V2 (Question Hook):
+Struggling to keep your remote team aligned? Syncro replaces
+scattered tools with one async-first workspace. Try it free.
+(140 chars) ✅
+
+## Best Practices
+
+- ✅ **Do:** Write 3 variants — always give the user options to test
+- ✅ **Do:** Keep OG and Twitter descriptions more conversational than SERP versions
+- ✅ **Do:** Verify character count on every variant before outputting
+- ❌ **Don't:** Use the same exact-match anchor or keyword more than once per description
+- ❌ **Don't:** Copy-paste the meta description into the OG description
+- ❌ **Don't:** Let any description end mid-sentence near the character limit
+
+## Common Pitfalls
+
+- **Problem:** Description truncates mid-word in search results
+  **Solution:** Always trim a clause rather than letting natural truncation cut the sentence.
+
+- **Problem:** All 3 variants sound identical
+  **Solution:** Each variant must use a genuinely different CTR mechanic — not just rearranged words.
+
+## Related Skills
+
+- `@seo-aeo-landing-page-writer` — provides the page content this skill writes tags for
+- `@seo-aeo-content-quality-auditor` — verifies meta elements as part of the full audit
+
+## Additional Resources
+
+- [SEO-AEO Engine Repository](https://github.com/mrprewsh/seo-aeo-engine)
+- [Full Meta Description Generator SKILL.md](https://github.com/mrprewsh/seo-aeo-engine/blob/main/.agent/skills/meta-description-generator/SKILL.md)
--- a/skills/seo-aeo-schema-generator/SKILL.md
+++ b/skills/seo-aeo-schema-generator/SKILL.md
@@ -0,0 +1,103 @@
+---
+name: seo-aeo-schema-generator
+description: "Generates valid JSON-LD structured data for 10 schema types with rich result eligibility validation and implementation-ready script blocks. Activate when the user wants to generate schema markup, JSON-LD, or structured data for any page."
+risk: safe
+source: community
+date_added: "2026-04-01"
+---
+
+# SEO-AEO Schema Generator
+
+## Overview
+
+Generates implementation-ready JSON-LD schema markup for 10 schema types including FAQPage, Article, Product, HowTo, and BreadcrumbList. Validates all required fields against Google rich result eligibility rules, flags missing fields with exact fix instructions, and outputs one clean `<script>` block per schema type ready to paste into the page `<head>`.
+
+Part of the [SEO-AEO Engine](https://github.com/mrprewsh/seo-aeo-engine).
+
+## When to Use This Skill
+
+- Use when adding structured data to a new landing page or blog post
+- Use when a page needs FAQ rich results or product star ratings in search
+- Use when validating existing schema for Google rich result eligibility
+- Use after the content-quality-auditor flags missing schema
+
+## Supported Schema Types
+
+| Type | Rich Result Unlocked |
+|------|---------------------|
+| FAQPage | FAQ accordion in SERP — AEO critical |
+| Article | Article rich result, Top Stories |
+| Product | Price, availability, rating in SERP |
+| HowTo | Step-by-step rich result |
+| Review | Star rating in SERP |
+| AggregateRating | Star rating with review count |
+| BreadcrumbList | Breadcrumb path in SERP URL |
+| Organization | Brand knowledge panel signals |
+| WebPage | Enhanced page understanding |
+| WebSite | Sitelinks Searchbox |
+
+## How It Works
+
+### Step 1: Recommend Schema Types
+If schema types are not specified, recommend the appropriate types based on the page type. Landing pages get FAQPage + Product + BreadcrumbList. Blog posts get Article + FAQPage + BreadcrumbList.
+
+### Step 2: Use Built-In Schema Templates
+Using your knowledge of schema.org and Google's rich result requirements, construct the JSON-LD template for each requested schema type. Use the required and recommended fields listed in the Google Rich Results documentation for that type.
+
+### Step 3: Populate Fields
+Map all page data to template placeholders. Check every required field against the rich result eligibility rules.
+
+### Step 4: Validate
+Flag any missing required field as a Critical issue. Flag missing recommended fields as warnings. Do not output schema with missing required fields.
+
+### Step 5: Output Script Blocks
+Write one `<script type="application/ld+json">` block per schema type. Include implementation instructions and testing tool links.
+
+## Examples
+
+### Example: FAQPage Schema Output
+```html
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "FAQPage",
+  "mainEntity": [
+    {
+      "@type": "Question",
+      "name": "What is Syncro?",
+      "acceptedAnswer": {
+        "@type": "Answer",
+        "text": "Syncro is a remote-first project management platform for distributed engineering teams. It centralises task tracking, async communication, and sprint planning in one tool."
+      }
+    }
+  ]
+}
+</script>
+```
+
+## Best Practices
+
+- ✅ **Do:** Always include FAQPage schema on any page with a FAQ section — it is the strongest AEO signal
+- ✅ **Do:** Use one `<script>` block per schema type — never combine multiple types
+- ✅ **Do:** Test every output in Google's Rich Results Test before deploying
+- ❌ **Don't:** Use relative URLs anywhere in schema — all URLs must start with `https://`
+- ❌ **Don't:** Leave placeholder text in any field before deploying
+- ❌ **Don't:** Use HTML tags inside JSON-LD string values
+
+## Common Pitfalls
+
+- **Problem:** Schema passes validation but rich result doesn't appear in search
+  **Solution:** Rich results can take weeks to appear after deployment. Request re-indexing in Google Search Console immediately after adding schema.
+
+- **Problem:** Product schema missing star rating display
+  **Solution:** Add AggregateRating object with ratingValue, reviewCount, bestRating, and worstRating — all four fields required.
+
+## Related Skills
+
+- `@seo-aeo-landing-page-writer` — provides the FAQ and product data for schema population
+- `@seo-aeo-content-quality-auditor` — flags schema gaps during the audit
+
+## Additional Resources
+
+- [SEO-AEO Engine Repository](https://github.com/mrprewsh/seo-aeo-engine)
+- [Full Schema Generator SKILL.md](https://github.com/mrprewsh/seo-aeo-engine/blob/main/.agent/skills/schema-generator/SKILL.md)