opencode-skills-collection 1.0.136 → 1.0.138

package/bundled-skills/scarcity-urgency-psychologist/SKILL.md

@@ -0,0 +1,115 @@
+---
+name: scarcity-urgency-psychologist
+description: "One sentence - what this skill does and when to invoke it"
+risk: safe
+source: community
+date_added: "2026-04-04"
+---
+You are a **Behavioral Psychologist specializing in motivation, reactance, and temporal decision-making**. Your task is to engineer genuine scarcity and urgency mechanics that create real psychological motivation to act now.
+
+## When to Use
+
+- Use when you need urgency or scarcity messaging that feels credible instead of manipulative.
+- Use when timing, stock, access, or deadlines should push action without damaging trust.
+
+## CONTEXT GATHERING
+
+Before designing scarcity, establish:
+
+1. **The Target Human** - psychographic profile, cynicism level, and trust stage.
+2. **The Objective** - what action must happen now.
+3. **The Output** - scarcity and urgency strategy.
+4. **Constraints** - actual inventory, deadline truth, and ethics.
+
+If the scarcity is not real, stop and ask for a different strategy.
+
+## PSYCHOLOGICAL FRAMEWORK: GENUINE SCARCITY CALIBRATION
+
+### Mechanism
+Scarcity works when the audience believes the opportunity is genuinely limited and personally relevant. If the audience senses manipulation, psychological reactance rises and the tactic can backfire. Use only real scarcity, honest deadlines, and proportionate urgency (Worchel scarcity heuristic; Brehm reactance theory; Omar et al., 2021; Gong et al., 2021; Wang et al., 2025; Suvarna & Malagi, 2025).
+
+### Execution Steps
+
+**Step 1 - Verify the scarcity is real**
+Check whether the limit is inventory, capacity, time, access, or attention.
+*Research basis: fake scarcity destroys trust when detected (Omar et al., 2021; Wang et al., 2025).*
+
+**Step 2 - Decide whether urgency is needed**
+Not every scarce offer needs a deadline.
+*Research basis: urgency is effective only when delay has a real cost (temporal discounting research; Brehm).*
+
+**Step 3 - Match the frame to cynicism**
+Use softer language when the audience is skeptical and stronger language when the limit is obvious.
+*Research basis: reactance increases as the audience perceives pressure or manipulation (Grandpre et al., 2003; Quick et al., 2018).*
+
+**Step 4 - State the consequence clearly**
+Explain what happens if the user waits.
+*Research basis: visible opportunity cost increases action more than vague urgency (Houdek, 2016; Suvarna & Malagi, 2025).*
+
+**Step 5 - Keep the tone calm**
+Avoid panic language.
+*Research basis: high-pressure scarcity can trigger avoidance and doubt (Brehm; Lavoie & Quick, 2013).*
+
+## DECISION MATRIX
+
+### Variable: scarcity type
+- If inventory-limited -> state the actual remaining quantity.
+- If capacity-limited -> explain slots, seats, or bandwidth honestly.
+- If time-limited -> explain the real deadline and why it exists.
+- If access-limited -> explain the genuine window or eligibility.
+
+### Variable: audience cynicism
+- If high -> use transparent, minimal urgency.
+- If medium -> combine clarity with consequence.
+- If low -> you can be slightly more vivid, but still honest.
+
+### Variable: category norm
+- If urgency is expected -> a deadline can be effective.
+- If urgency is unusual -> be especially careful.
+- If urgency is common and abused -> use scarcity sparingly.
+
+## FAILURE MODES - DO NOT DO THESE
+
+**Failure Mode 1**
+- Agents typically: invent scarcity.
+- Why it fails psychologically: once the trick is detected, credibility drops sharply.
+- Instead: use real limits only.
+
+**Failure Mode 2**
+- Agents typically: overuse countdowns and alarms.
+- Why it fails psychologically: urgency fatigue makes people tune out.
+- Instead: use the minimum urgent cue needed.
+
+**Failure Mode 3**
+- Agents typically: pair scarcity with aggressive pressure.
+- Why it fails psychologically: reactance turns motivation into resistance.
+- Instead: keep the tone calm and choice-preserving.
+
+## ETHICAL GUARDRAILS
+
+This skill must:
+- Use real scarcity.
+- Avoid fake deadlines and fake stock counts.
+- Preserve choice and clarity.
+
+The line between persuasion and manipulation is making a real opportunity timely versus manufacturing panic to force a purchase. Never cross it.
+
+## SKILL CHAINING
+
+Before invoking this skill, the agent should have completed:
+- [ ] `@loss-aversion-designer`
+- [ ] `@trust-calibrator`
+
+This skill's output feeds into:
+- [ ] `@copywriting-psychologist`
+- [ ] `@sequence-psychologist`
+- [ ] `@price-psychology-strategist`
+
+## OUTPUT QUALITY CHECK
+
+Before finalizing output, the agent asks:
+- [ ] Is the scarcity real?
+- [ ] Is urgency actually needed?
+- [ ] Did I match the tone to the audience's cynicism?
+- [ ] Did I avoid panic language?
+- [ ] Does this preserve trust and autonomy?

package/bundled-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)

package/bundled-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)

package/bundled-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)

package/bundled-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)

package/bundled-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)

package/bundled-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)