Skip to content

ZenUml/conf-app / .claude/skills/improve-aeo-geo

improve-aeo-geo

Verified

Audits a website codebase and makes code changes so AI engines (ChatGPT, Claude, Perplexity, Google AI Overviews) can better discover, parse, quote, and cite the site. Covers structured data, content structure, technical signals, and freshness.

FileKindSize
README.mdmarkdown5.0 KB
SKILL.mdskill md20.3 KB
examples/nextjs-blog-before-after.mdmarkdown3.3 KB
examples/wordpress-business-before-after.mdmarkdown1.7 KB

examples/wordpress-business-before-after.md

View on GitHub
# Example: WordPress Business Site — Before & After

A small business WordPress site scoring **31/100 (F)** improved to **82/100 (B+)**.

## Before: What was wrong

```
Score: 31/100 (F)
Foundational: 3/16 checks passing
Intelligence: 1.8/5 average

Failing checks:
- AI bots blocked (security plugin blocked all bots by default)
- nosnippet meta tag on all pages (added by theme)
- No JSON-LD
- No llms.txt
- No RSS feed discovery link
- No canonical URLs
- Homepage had 80 words total
- Product pages had no meta descriptions
- Images had no alt text
- No heading hierarchy (H1 used for styling, H4 for content)
```

## Key Changes

### 1. Unblocked AI bots
- Removed Wordfence rule blocking GPTBot, ClaudeBot, etc.
- Removed `nosnippet` from theme's `header.php`

### 2. Added JSON-LD via functions.php
- Organization schema on all pages
- Product schema on product pages
- Article schema on blog posts

### 3. Content depth
- Expanded homepage from 80 words to 650 words
- Added "What we do", "Who we serve", FAQ section
- Each product page expanded with: description, use cases, specifications, FAQ

### 4. Heading hierarchy fix
- Changed H1 from logo to page title
- Restructured content: H1 (page title) → H2 (sections) → H3 (details)

### 5. Meta & technical
- Added Yoast SEO, configured meta descriptions for all pages
- Added canonical URLs via Yoast
- Created `llms.txt` in web root
- Added RSS discovery link to `header.php`

### 6. GEO content improvements
- Added customer testimonials with names and companies (quotations)
- Added performance statistics: "Serving 500+ clients since 2018"
- Added FAQ sections to 4 key pages with FAQPage schema

## After

```
Score: 82/100 (B+)
Foundational: 14/16 checks passing
Intelligence: 3.6/5 average
```
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall