🌍 E-GEO

Generative Engine Optimization for AI-Powered Search

🚀 One command. Premium results.
Rank higher in ChatGPT, Perplexity, Claude, and Gemini.

📖 Docs • 🐛 Issues • 💬 Discussions • 📝 Research Paper

---

_{🤖 AI-Assisted Development — See what's AI-generated vs human-authored}

---

✨ What is E-GEO?

E-GEO is a zero-effort Generative Engine Optimization toolkit that transforms your website content to rank higher in AI-powered search engines. Based on the E-GEO research paper, it applies the 10 universal features that consistently improve AI-engine rankings. ✅ No learning curve — One command to optimize ✅ Research-backed — Based on peer-reviewed findings ✅ Production-ready — Copy-paste optimized content

/geo https://yoursite.com/pricing ↓ geo-output/ ├── report.md ├── optimized/ │ └── pricing.md └── schema/ └── pricing.json

---

🚀 Quick Start (3 Steps)

1. Install

Copy the .claude/ folder to your project:

cp -r /path/to/eGEOagents/.claude .

2. Activate

In Claude Code, switch to GEO mode:

/output-style geo-optimizer

3. Optimize

Run your first optimization:

/geo https://yoursite.com

---

🧩 Install as Skills (skills.sh)

Install the complete skill collection:

npx skills add https://github.com/mverab/eGEOagents

Install one skill only:

npx skills add https://github.com/mverab/eGEOagents --skill competitive-analysis

Validate parser discovery before shipping updates:

npx skills add https://github.com/mverab/eGEOagents --list

Verify indexing pages:

• Collection: skills.sh/mverab/egeoagents
• Owner: skills.sh/mverab

---

📋 Commands

Command	What it does
/geo <url>	Full pipeline - Analyze, rank, rewrite, schema
/geo:audit <url>	Analysis only, no changes
/geo:optimize <file>	Optimize local content file
/geo:batch <folder>	Process entire folder
/geo:report	Generate executive report
/geo:compete <query>	Competitive analysis

---

📊 What You Get

After running /geo:

geo-output/
├── report.md           # Executive summary + scores
├── analysis.json       # Raw analysis data
├── optimized/
│   └── pricing.md      # Rewritten content (ready to use)
├── schema/
│   └── pricing.json    # JSON-LD markup (copy to site)
└── checklist.md        # Step-by-step implementation

---

🎯 Results: Backed by Research

E-GEO is based on the E-GEO research paper (arXiv:2511.20867). The paper reports that competitive framing produces the strongest immediate lift, a universal optimization strategy outperforms common heuristics, and the 10 GEO features consistently appear in higher-ranking content.

Feature	What E-GEO Does
Ranking Emphasis	Positions your content as the top choice
User Intent	Directly answers what users are looking for
Competitive Edge	Highlights your unique advantages
Social Proof	Integrates trust signals and testimonials
Authority	Establishes expert, confident tone
Scannability	Structures for easy AI parsing

Results vary by content quality and competition. See the paper for full methodology and findings: arXiv:2511.20867.

---

🆚 E-GEO vs Alternatives

Feature	E-GEO	Traditional SEO	Manual GEO
AI-Engine Optimized	✅ Yes	❌ No	⚠️ Partial
One-Command Setup	✅ Yes	❌ No	❌ No
Research-Based	✅ Yes (paper)	❌ Heuristics	⚠️ Variable
Output Quality	Premium	Basic	Variable
Time to Results	Minutes	Months	Days
Cost	Free	Expensive	Time-intensive
Schema Generation	✅ Auto	❌ No	⚠️ Manual
Competitive Analysis	✅ Built-in	❌ No	❌ No

---

💎 Premium Output

E-GEO delivers outputs that look like they came from a $100M company:

┌─────────────────────────────────────────────────────────────┐
│  🎯 GEO AUDIT REPORT                                        │
├─────────────────────────────────────────────────────────────┤
│  URL: yoursite.com/pricing                                  │
│  Score: 78/100                                              │
│  Ranking Potential: ████████░░ 78%                          │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  ✅ STRENGTHS                                               │
│  • Clear value proposition                                  │
│  • Good content structure                                   │
│                                                             │
│  ⚠️ GAPS                                                    │
│  • Missing social proof → Add customer count                │
│  • No urgency signals → Add limited-time offer              │
│                                                             │
│  📈 PRIORITY ACTIONS                                        │
│  1. Add testimonials (+15 points)                           │
│  2. Include pricing comparison (+10 points)                 │
│  3. Add schema markup (+5 points)                           │
│                                                             │
└─────────────────────────────────────────────────────────────┘

---

🤖 How It Works

E-GEO uses 4 specialized AI agents orchestrated by Claude Code:

Agent	What it does	Output
🔍 Analyzer	Extracts content, scores GEO signals, identifies gaps	analysis.json
📊 Ranker	Simulates AI-engine ranking, predicts positions	Baseline score
✍️ Rewriter	Optimizes content while preserving brand voice	optimized/*.md
🗂️ Indexer	Generates schema markup and technical assets	schema/*.json

---

📁 What's Included

.claude/
├── CLAUDE.md                    # System knowledge base
├── output-styles/
│   └── geo-optimizer.md         # Premium formatting mode
├── agents/
│   ├── geo-analyzer.md          # Content analysis
│   ├── geo-rewriter.md          # Content optimization
│   ├── geo-ranker.md            # Ranking simulation
│   └── geo-indexer.md           # Schema generation
├── skills/
│   ├── competitive-analysis/    # Auto-triggered competitor analysis
│   ├── content-scoring/         # Auto-triggered scoring
│   └── schema-generator/        # Auto-triggered schema
└── commands/
    ├── geo.md                   # Main command
    ├── geo-audit.md
    ├── geo-optimize.md
    ├── geo-batch.md
    ├── geo-report.md
    └── geo-compete.md

---

🎁 Perfect For

🚀 SaaS Founders AI-engine traffic

💼 B2B Marketers Landing pages

🛍️ E-commerce Product descriptions

✍️ Content Creators AI discoverability

🏢 Agencies GEO services

---

📚 Documentation

Resource	Description
📖 Getting Started	Step-by-step tutorial
⚙️ How It Works	Technical deep dive
❓ FAQ	Common questions answered
🧩 skills.sh Playbook	Listing, ranking, and metadata checklist
📝 Usage Guide	Complete command reference
📝 Research Paper	The science behind E-GEO

---

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Quick ways to contribute:

• Report bugs via issues
• Submit pull requests for features
• Improve documentation
• Share your GEO results

---

📜 License

MIT License - use it, modify it, sell with it. See LICENSE for details.

---

🙋 Support & Community

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Research: E-GEO Paper (arXiv:2511.20867)

---

🚀 Ready to Rank Higher?

# Install
cp -r eGEOagents/.claude .

# Activate (in Claude Code)
/output-style geo-optimizer

# Optimize your first page
/geo https://yoursite.com

---

Built for the AI-first web. 🌐

_{Made with ❤️ by Vera Badias • Based on research from arXiv:2511.20867}

_{🤖 This project is AI-assisted. See AI Transparency for details.}