Rewrite existing pages so AI assistants can extract, quote, and cite them. Claude restructures your content into answer-ready blocks — direct answers, comparison tables, stats with sources, schema — without wrecking the human reading experience. Platform: AI visibility.
git clone https://github.com/irinabuht12-oss/marketing-skills.git--- name: content-aeo-optimizer description: Rewrite existing pages so AI assistants can extract, quote, and cite them. Claude restructures your content into answer-ready blocks — direct answers, comparison tables, stats with sources, schema — without wrecking the human reading experience. Platform: AI visibility. metadata: platform: AI visibility --- # 3/ Content AEO Optimizer ## What it does Takes a page you already rank with (or want to) and restructures it for answer engines: front-loaded direct answers, extractable claims, clean entity naming, FAQ blocks, and schema markup. The goal is making your page the easiest source for an AI to quote accurately. ## How it works Paste the page content and the target question set. Claude audits it against extraction patterns — does the first paragraph answer the question, are claims specific and attributable, are comparisons in structured tables, is your brand named consistently. It then rewrites the weak sections and generates the JSON-LD schema to match. ## Practical example A pricing comparison post buries the answer in paragraph six. Claude moves a 40-word direct answer to the top, converts the prose comparison into a table with concrete numbers, adds an FAQ section matching real query phrasing, and outputs FAQPage + Product schema. The page starts appearing as a cited source in Perplexity answers within weeks of reindexing. ## What you get back - Section-by-section rewrite with extractable answer blocks - Comparison tables and stat callouts with attribution - FAQ section matched to real buyer query phrasing - Ready-to-paste JSON-LD schema ## When to use it - Optimizing your highest-traffic or highest-intent pages first - Publishing new comparison / "best of" / pricing content - A page ranks well in Google but never gets cited by AI ## Data access (Ryze MCP) This skill works best with live account data. Connect the free Ryze MCP once and Claude reads your Google Ads, Meta Ads, GA4 and Search Console directly: - claude.ai / Claude Desktop: Settings → Connectors → Add custom connector → `https://connector.get-ryze.ai/mcp` - Claude Code: `claude mcp add ryze --transport http https://connector.get-ryze.ai/mcp` - Cursor: Settings → MCP → add the same URL Setup guide: https://www.get-ryze.ai/how-to-connect-claude-to-google-meta-ads-mcp
[{"step":"Identify your target keywords and tone. Use tools like Google Keyword Planner or Ahrefs to find high-intent keywords (e.g., 'best smartphone for photography 2024'). Define the tone (e.g., technical, conversational, or authoritative) based on your audience.","tip":"Prioritize keywords with high search volume but low competition for better AI visibility."},{"step":"Paste your existing page content into the prompt template. Replace [PAGE_CONTENT] with your raw text, [KEYWORDS] with your target terms, and [TONE] with your desired style (e.g., 'professional and concise').","tip":"If your content is long, break it into sections (e.g., features, specs, FAQs) and process each separately for better structure."},{"step":"Review the AI’s output for accuracy and readability. Check that the direct answer block is concise (1-2 sentences) and that the comparison table or stats are factually correct. Use tools like Grammarly or Hemingway Editor to refine the human-readable sections.","tip":"Verify stats and sources manually to avoid AI hallucinations. Link to authoritative sources (e.g., manufacturer websites, research firms)."},{"step":"Implement schema markup. Use the provided JSON snippets in the example output and validate them with Google’s Rich Results Test (https://search.google.com/test/rich-results). Add schema to your website’s backend or via plugins like Yoast SEO.","tip":"Test your schema in Google’s tool to ensure it’s recognized. Missing or incorrect schema can hurt AI visibility."},{"step":"Publish and monitor performance. Track rankings for your target keywords using tools like SEMrush or Moz. Use Google Search Console to check how often your page appears in AI-generated answers (look for 'AI Overviews' or 'SGE' reports).","tip":"Update content quarterly to keep it fresh. AI assistants prioritize recent, accurate data."}]
No install command available. Check the GitHub repository for manual installation instructions.
git clone https://github.com/irinabuht12-oss/marketing-skills/tree/main/skills/content-aeo-optimizerCopy the install command above and run it in your terminal.
Launch Claude Code, Cursor, or your preferred AI coding agent.
Use the prompt template or examples below to test the skill.
Adapt the skill to your specific use case and workflow.
Rewrite the following page content to make it AI-friendly for answer engines. Structure the content into: 1) A direct answer block (1-2 sentences) at the top, 2) A comparison table if applicable, 3) Key stats with sources, 4) Schema-ready sections for entities, and 5) Maintain readability for humans. Original content: [PAGE_CONTENT]. Target keywords: [KEYWORDS]. Tone: [TONE].
### **Direct Answer**
The **iPhone 15 Pro Max** outperforms competitors in battery life, offering up to **29 hours of video playback**—a 20% improvement over the iPhone 14 Pro Max. Its **A17 Pro chip** delivers 20% faster CPU performance and supports advanced gaming features like hardware-accelerated ray tracing. For photographers, the **5x optical zoom** and **ProRes video recording** set it apart in the premium smartphone market.
---
### **Comparison Table: iPhone 15 Pro Max vs. Competitors (2024)**
| Feature | iPhone 15 Pro Max | Samsung Galaxy S24 Ultra | Google Pixel 8 Pro |
|-----------------------|-------------------|--------------------------|--------------------|
| **Battery Life** | 29h video playback | 24h video playback | 22h video playback |
| **Chipset** | A17 Pro (3nm) | Snapdragon 8 Gen 3 (4nm) | Tensor G3 (4nm) |
| **Max Zoom** | 5x optical | 10x optical | 5x optical |
| **Video Recording** | ProRes 4K 60fps | 8K 30fps | 4K 60fps |
| **Price (Launch)** | $1,199 | $1,299 | $999 |
---
### **Key Stats (With Sources)**
- **Battery Efficiency**: The iPhone 15 Pro Max’s battery lasts **5 hours longer** than the Galaxy S24 Ultra in real-world testing (Source: [GSMArena, 2024](https://www.gsmarena.com)).
- **Gaming Performance**: The A17 Pro’s **GPU performance** is **35% faster** than the Snapdragon 8 Gen 3 in 3D Mark Wild Life (Source: [Apple, 2024](https://www.apple.com)).
- **Market Share**: Apple holds **20.5% of the premium smartphone market** in Q2 2024, with the iPhone 15 series driving 60% of iPhone revenue (Source: [Counterpoint Research](https://www.counterpointresearch.com)).
---
### **Schema-Ready Sections**
**Product:**
```json
{
"@context": "https://schema.org",
"@type": "Product",
"name": "iPhone 15 Pro Max",
"brand": "Apple",
"model": "iPhone 15 Pro Max",
"aggregateRating": {
"@type": "AggregateRating",
"ratingValue": "4.8",
"reviewCount": "12,450"
},
"offers": {
"@type": "Offer",
"url": "https://www.apple.com/shop/buy-iphone/iphone-15-pro-max",
"priceCurrency": "USD",
"price": "1199.00"
}
}
```
**Comparison:**
```json
{
"@context": "https://schema.org",
"@type": "Comparison",
"name": "iPhone 15 Pro Max vs. Samsung Galaxy S24 Ultra vs. Google Pixel 8 Pro",
"itemListElement": [
{
"@type": "Product",
"name": "iPhone 15 Pro Max",
"offers": { "price": "1199.00" }
},
{
"@type": "Product",
"name": "Samsung Galaxy S24 Ultra",
"offers": { "price": "1299.00" }
},
{
"@type": "Product",
"name": "Google Pixel 8 Pro",
"offers": { "price": "999.00" }
}
]
}
```
---
### **Human-Readable Section (Unchanged)**
The iPhone 15 Pro Max isn’t just another incremental upgrade—it’s a leap forward in performance, photography, and battery efficiency. Whether you’re a gamer, a content creator, or a power user, the A17 Pro chip and ProRes video capabilities make it a standout choice. The 5x optical zoom is perfect for travel photography, while the **USB-C port** finally aligns with industry standards. Pre-orders start at $1,199, with shipping beginning September 22, 2024.skills-collection
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan