
Geo Compare
- 402 installs
- 9.2k repo stars
- Updated August 4, 2026
- zubair-trabzada/geo-seo-claude
geo-compare is a Claude Code agent skill that generates monthly GEO audit delta reports comparing baseline and current scores across categories, platforms, and AI crawlers for developers running generative-engine optimiz
About
geo-compare is version 1.0.0 in the zubair-trabzada/geo-seo-claude GEO-first SEO toolkit. It compares two saved GEO audits—a baseline and a current snapshot—from ~/.geo-prospects/audits/, parses overall GEO scores across 6 categories and 5 platforms, tracks 14 AI crawler access changes, and calculates action-item completion deltas. The /geo compare command outputs a formatted markdown monthly progress report to ~/.geo-prospects/reports/ with executive summary, score breakdowns, crawler status changes, and next-month focus areas. Developers and agency engineers reach for geo-compare during monthly client check-ins when they need concrete proof of GEO score improvements since onboarding, not for running the initial full /geo audit.
- Generates monthly GEO progress reports for client retention
- Compares baseline vs current GEO scores point-by-point
- Accepts domain name or baseline and current file as input
- 290 installs making it the most popular skill in the geo-seo-claude toolkit
- Designed as an agency client retention tool
Geo Compare by the numbers
- 402 all-time installs (skills.sh)
- Ranked #809 of 1,879 Marketing & SEO skills by installs in the Skillselion catalog
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/zubair-trabzada/geo-seo-claude --skill geo-compareAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 402 |
|---|---|
| repo stars | ★ 9.2k |
| Last updated | August 4, 2026 |
| Repository | zubair-trabzada/geo-seo-claude ↗ |
How do you report monthly GEO score progress?
Generates monthly GEO score comparison reports showing clients exactly what SEO metrics improved since they started working with you.
Who is it for?
Developers and SEO engineers managing GEO client retainers who already have baseline and follow-up audit JSON files and need monthly progress proof reports.
Skip if: Teams without prior GEO audits who need an initial /geo audit, citability scoring, or technical SEO crawl rather than month-over-month comparison.
When should I use this skill?
User says compare GEO audits, monthly report, delta, progress check-in, or /geo compare for a client domain with existing audit history.
What you get
Markdown monthly delta reports in ~/.geo-prospects/reports/ with per-category score changes, platform deltas, crawler status diffs, and action-plan completion tracking.
- monthly GEO delta markdown reports
- action-item completion summaries
By the numbers
- Version 1.0.0 comparing scores across 6 categories and 5 platforms
- Tracks AI crawler access changes across 14 crawlers between audit snapshots
Files
GEO Monthly Delta Report Generator
Purpose
The single most powerful retention tool for a GEO agency: show clients exactly what improved since they started working with you. Every point gained on the GEO score is proof of value. This skill generates the "here's your progress" report.
---
Commands
/geo compare <domain>
/geo compare <baseline-file> <current-file>
/geo compare electron-srl.com --month march-2026Examples:
/geo compare electron-srl.com
/geo compare ~/.geo-prospects/audits/electron-srl.com-2026-01-15.md ~/.geo-prospects/audits/electron-srl.com-2026-03-12.md---
Workflow
Step 1: Find Audit Files
If only domain is provided: 1. Look in ~/.geo-prospects/audits/ for files matching <domain>-*.md 2. Sort by date 3. Use oldest as baseline, newest as current 4. If only one file exists: use it as baseline, run a fresh quick audit as current 5. If no files exist: suggest running /geo prospect audit <domain> first
Step 2: Parse Both Audits
Extract from each audit file:
- Overall GEO Score
- Per-category scores (6 categories)
- Per-platform scores (5 platforms)
- AI crawler status (14 crawlers)
- Critical issues list
- Action items list with status
Step 3: Calculate Deltas
For each metric:
- Delta = Current - Baseline
- Trend = ▲ (improved), ▼ (declined), ── (unchanged)
- Color coding in report: green (+), red (-), gray (=)
Step 4: Generate Monthly Report
Output to ~/.geo-prospects/reports/<domain>-monthly-<date>.md
---
Report Template
Generate the following document:
# GEO Monthly Progress Report
## [COMPANY NAME] — [MONTH YEAR]
**Reporting period:** [BASELINE DATE] → [CURRENT DATE]
**Prepared by:** [AGENCY NAME]
**Report reference:** GEO-MONTHLY-[DOMAIN]-[YYMMDD]
---
## Executive Summary
[2-3 sentences: What improved, what's the trend, what to focus on next month.]
Example: "Electron Srl's GEO Score improved from 32 to 44 this month (+12 points),
placing the site firmly in the 'Below Average' tier and on track to reach 'Moderate'
by May. The biggest wins were AI crawler access (+3 crawlers now allowed) and schema
implementation (+Organization and LocalBusiness schemas live). Next month's focus is
content citability — the highest-weighted remaining gap."
---
## GEO Score Progress
OVERALL GEO SCORE
Baseline [▓▓▓▓░░░░░░░░░░░░░░░░] 32/100 (Critical) Current [▓▓▓▓▓▓▓▓░░░░░░░░░░░░] 44/100 (Below Average) Change ▲ +12 points (+37.5%)
Target: 65/100 by Month 6 (on track ✓)
---
## Score Breakdown: Before vs. After
| Category | Baseline | Current | Change | Trend |
|----------|---------|---------|--------|-------|
| AI Citability & Visibility | [X]/100 | [X]/100 | [+/-X] | [▲/▼/──] |
| Brand Authority Signals | [X]/100 | [X]/100 | [+/-X] | [▲/▼/──] |
| Content Quality & E-E-A-T | [X]/100 | [X]/100 | [+/-X] | [▲/▼/──] |
| Technical Foundations | [X]/100 | [X]/100 | [+/-X] | [▲/▼/──] |
| Structured Data | [X]/100 | [X]/100 | [+/-X] | [▲/▼/──] |
| Platform Optimization | [X]/100 | [X]/100 | [+/-X] | [▲/▼/──] |
| **TOTAL** | **[X]/100** | **[X]/100** | **[+/-X]** | **[▲/▼]** |
---
## Platform Readiness: Before vs. After
| AI Platform | Baseline | Current | Change |
|-------------|---------|---------|--------|
| Google AI Overviews | [X]/100 | [X]/100 | [+/-X] |
| ChatGPT Web Search | [X]/100 | [X]/100 | [+/-X] |
| Perplexity AI | [X]/100 | [X]/100 | [+/-X] |
| Google Gemini | [X]/100 | [X]/100 | [+/-X] |
| Bing Copilot | [X]/100 | [X]/100 | [+/-X] |
---
## AI Crawler Access Changes
| Crawler | Baseline | Current | Change |
|---------|---------|---------|--------|
| GPTBot (ChatGPT) | Blocked/Allowed | Blocked/Allowed | ✓ Fixed / No change |
| ClaudeBot (Anthropic) | Blocked/Allowed | Blocked/Allowed | ✓ Fixed / No change |
| PerplexityBot | Blocked/Allowed | Blocked/Allowed | ✓ Fixed / No change |
| Google-Extended (Gemini) | Blocked/Allowed | Blocked/Allowed | ✓ Fixed / No change |
| Bingbot | Blocked/Allowed | Blocked/Allowed | ✓ Fixed / No change |
[Show only crawlers that changed, or all if few crawlers.]
---
## Action Plan Progress
### Quick Wins — Status Update
| # | Action | Assigned | Status | Impact |
|---|--------|---------|--------|--------|
| 1 | Allow all AI crawlers in robots.txt | Client dev | ✅ Done | +3 crawlers |
| 2 | Add Organization schema to homepage | Client dev | ✅ Done | Schema score +15 |
| 3 | Create llms.txt | Agency | ✅ Done | AI visibility +8 |
| 4 | Add author bylines to all articles | Client content | 🔄 In Progress | — |
| 5 | Fix meta descriptions (47 pages missing) | Client dev | ❌ Not started | — |
**Quick wins completed: [X]/[Y] ([%])**
### Medium-Term — Status Update
| # | Action | Target Month | Status |
|---|--------|-------------|--------|
| 1 | Rewrite top 10 pages with Q&A structure | Month 2 | 🔄 3/10 done |
| 2 | E-E-A-T: Create author pages | Month 2 | ❌ Not started |
| 3 | Register Bing Webmaster Tools | Month 1 | ✅ Done |
| 4 | Implement IndexNow | Month 2 | 🔄 In Progress |
### Strategic — Status Update
| # | Action | Target | Status |
|---|--------|--------|--------|
| 1 | Wikipedia entity creation | Month 4 | 📋 Planned |
| 2 | YouTube channel launch | Month 3 | 📋 Planned |
| 3 | Reddit presence (industry subs) | Month 3 | 📋 Planned |
---
## This Month's Wins
> Use this section to celebrate — clients need to see the value clearly.
✅ **[WIN 1]:** [Specific, tangible result — e.g., "GPTBot and ClaudeBot are now allowed. ChatGPT can now crawl and cite your content."]
✅ **[WIN 2]:** [e.g., "Organization schema implemented on homepage. Your brand entity is now machine-readable."]
✅ **[WIN 3]:** [e.g., "llms.txt created and deployed at electron-srl.com/llms.txt — one of only ~12% of sites in your industry to have this."]
---
## New Issues Discovered
> Issues found in current audit that weren't in baseline.
⚠️ **[ISSUE 1]:** [What it is, what it means, how we'll fix it]
⚠️ **[ISSUE 2]:** [What it is, what it means, how we'll fix it]
---
## Next Month Focus
### Priority Actions for [NEXT MONTH]:
| Priority | Action | Owner | Expected Impact |
|----------|--------|-------|----------------|
| 1 | [Highest ROI action] | [Agency/Client] | +[X] GEO points |
| 2 | [Second priority] | [Agency/Client] | +[X] GEO points |
| 3 | [Third priority] | [Agency/Client] | +[X] GEO points |
**Target GEO Score next month:** [CURRENT + estimated gain]/100
---
## 6-Month Trajectory
| Month | Date | Score | Delta | Key Achievement |
|-------|------|-------|-------|----------------|
| Baseline | [Date] | [Score] | — | Initial audit |
| Month 1 | [Date] | [Score] | [+X] | Quick wins implemented |
| Month 2 | [Date] | [Score] | [+X] | *Current month* |
| Month 3 | [Date] | — | — | Content citability |
| Month 4 | — | — | — | Brand authority |
| Month 5 | — | — | — | Strategic initiatives |
| Month 6 | — | **Target: [X]** | — | Full review |
[Only fill rows that have happened. Show projected rows as "—"]
---
## Estimated Business Impact
Based on the [X]-point improvement this month:
- **AI citation likelihood:** Increased by approximately [X]%
- **Crawlers with access:** [X]/14 → [Y]/14 (better coverage on [platforms])
- **Estimated monthly AI-referred traffic improvement:** +[X]% (conservative)
- **Traffic value at current conversion rates:** +€[X]/month in organic value
*Note: Full traffic impact from GEO changes typically takes 4-8 weeks to materialize
as AI platforms re-index and update their knowledge bases.*
---
*GEO Monthly Report — [COMPANY NAME] — [DATE]*
*Questions or comments? [CONTACT EMAIL]*---
Delta Calculation Logic
When parsing two audit files, look for these patterns:
Score markers to extract:
- "GEO Score: XX/100"
- "Overall Score: XX"
- "AI Citability: XX/100"
- "Brand Authority: XX/100"
- "Technical: XX/100"
- "Schema: XX/100"
- "Platform: XX/100"
- "Content: XX/100"
- "GPTBot: Allowed/Blocked"
- "ClaudeBot: Allowed/Blocked"If exact scores are not found in audit files, use contextual analysis of the written findings to estimate approximate scores based on issues described.
---
Trend Interpretation
| Delta | Trend Symbol | Meaning |
|---|---|---|
| +5 or more | ▲▲ | Strong improvement |
| +1 to +4 | ▲ | Improvement |
| 0 | ── | No change |
| -1 to -4 | ▼ | Slight decline |
| -5 or more | ▼▼ | Significant decline — needs discussion |
A decline is not necessarily bad — it can mean new issues were discovered in the fresh audit that weren't visible before. Frame declines as "newly discovered opportunities."
---
Output
1. Save report to ~/.geo-prospects/reports/<domain>-monthly-<YYYY-MM>.md 2. Print confirmation with key stats:
✓ Monthly report generated: ~/.geo-prospects/reports/electron-srl.com-monthly-2026-03.md
SUMMARY:
GEO Score: 32 → 44 (+12 points) ▲
Quick wins completed: 3/5 (60%)
New issues found: 2 (minor)
On track for Month 6 target: YES (65/100)3. Suggest next action: "Share with client or run /geo report-pdf for a visual version"
Related skills
How it compares
Use geo-compare after running /geo audit twice; it reports month-over-month deltas rather than performing the initial citability, crawler, or schema analysis.
FAQ
Where does geo-compare read audit files from?
geo-compare loads baseline and current GEO audit files from ~/.geo-prospects/audits/ for the target domain. It identifies the earliest audit as baseline and the latest as current unless a specific month flag is provided.
What metrics does a geo-compare report include?
geo-compare reports overall GEO score deltas across 6 categories, per-platform changes across 5 platforms, AI crawler access diffs for 14 crawlers, critical issue changes, and action-item completion status with color-coded gains and losses.
How do you run geo-compare in Claude Code?
geo-compare runs via /geo compare <domain> or /geo compare <domain> --month <label> in the geo-seo-claude toolkit. Output saves as a markdown monthly report under ~/.geo-prospects/reports/.