geo-compare

Compares two GEO audits and generates monthly client progress reports with score deltas.

1|Updated Aug 17, 2026
One-click install
npx skills add https://github.com/Marshal-Nguyen/Skill_Claude_Agent --skill geo-compare-marshal-nguyen
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: geo-compare
Source: https://github.com/Marshal-Nguyen/Skill_Claude_Agent/tree/main/claude/skills/geo-compare
Command: npx skills add https://github.com/Marshal-Nguyen/Skill_Claude_Agent --skill geo-compare-marshal-nguyen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? GEO agencies need to prove ongoing value to clients each month, but manually comparing audit results and writing progress reports is slow and error-prone. This Skill automates the delta analysis between a baseline and current GEO audit and produces a ready-to-share client report. ## Core Features & Use Cases - Audit Delta Calculation: Parses two GEO audit files and computes score changes across 6 categories, 5 AI platforms, and 14 AI crawler statuses with trend indicators. - Action Item Tracking: Reports completion status of quick wins, medium-term, and strategic action items from the previous audit. - Client Report Generation: Outputs a structured monthly progress report (executive summary, score tables, wins, new issues, next-month priorities, 6-month trajectory) saved to ~/.geo-prospects/reports/. - Use Case: An agency runs a monthly check-in for electron-srl.com; the Skill finds the January baseline and March current audits, calculates the +12 point improvement, and generates the client-facing report automatically. ## Quick Start Ask the assistant to run a GEO compare for a client domain, for example: compare the baseline and current GEO audits for electron-srl.com and generate the monthly progress report.

Frequently Asked Questions about geo-compare

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I compare two GEO audits for a client?▼

Provide the client domain or two audit file paths, and the Skill locates the baseline and current audits in ~/.geo-prospects/audits/, parses both, and calculates per-category and per-platform score deltas. The result is a formatted monthly progress report.

What metrics does a GEO monthly progress report track?▼

The report tracks overall GEO score, six category scores, five AI platform readiness scores, AI crawler access changes across 14 crawlers, and action item completion status. It also includes a 6-month trajectory table and estimated business impact.

What happens if only one audit file exists for a domain?▼

If only one audit file exists, the Skill uses it as the baseline and runs a fresh quick audit as the current state. If no files exist, it suggests running a prospect audit first before comparison.

How are score declines handled in the GEO delta report?▼

Declines are marked with trend symbols based on magnitude, from slight decline to significant decline. The Skill frames declines as newly discovered opportunities, since fresh audits often reveal issues not visible in the baseline.

Where are the generated monthly GEO reports saved?▼

Reports are saved to ~/.geo-prospects/reports/ with the filename pattern <domain>-monthly-<YYYY-MM>.md. After saving, the Skill prints a summary of score changes, quick win completion, and target tracking.