GEO Monthly Delta Report Generator

GEO Monthly Delta Report Generator

What Is This?

The GEO Monthly Delta Report Generator is a skill designed for the Happycapy Skills platform, tailored for agencies and professionals working with GEO clients. It automates the process of comparing two GEO audit reports-typically a historical baseline and a recent audit-calculating improvements, tracking the completion of action items, and generating a comprehensive progress report for clients. The core purpose is to clearly demonstrate the tangible value delivered over time, by quantifying changes in GEO scores across all categories and providing a client-friendly summary of what has improved since the engagement began.

This skill operates via command-line instructions or chat-based commands, leveraging file system access to identify and compare audit files, and ultimately outputs a detailed “here’s your progress” report. It is specifically designed to streamline monthly client check-ins, retention meetings, and reporting cycles by automating what is often a manual and error-prone process.

Why Use It?

Retention and transparency are critical for agencies working in GEO optimization or similar fields. Clients want to see concrete evidence of progress, not just promises of improvement. The GEO Monthly Delta Report Generator addresses this need by:

• Quantifying Progress: It calculates and presents delta (change) values for all tracked GEO audit categories, making it easy to see where scores have increased.
• Proving Value: By showing point-by-point improvements, the skill provides direct evidence of your agency’s impact on the client’s performance.
• Tracking Action Items: The skill checks which action items from previous audits have been completed, offering a clear picture of what's been accomplished.
• Automating Reports: Reduces manual effort and potential errors in assembling reports, freeing up time for higher-value activities.
• Client Communication: The generated reports are designed to be client-friendly, ensuring that even non-technical stakeholders can understand and appreciate the progress made.

How to Use It

The GEO Monthly Delta Report Generator is invoked using the /geo compare command, which can be issued in several ways depending on the available data:

Basic Usage

To generate a delta report for a domain, simply run:

/geo compare <domain>

For example:

/geo compare electron-srl.com

This command will:

1. Search the ~/.geo-prospects/audits/ directory for markdown files matching the pattern <domain>-*.md.
2. Sort the files by date.
3. Select the oldest file as the baseline and the newest as the current audit.
4. If only one file is found, it will use it as the baseline and trigger a new quick audit to serve as the current state.
5. If no files are found, it will inform the user that no audits are available.

Comparing Specific Files

If you wish to compare two specific audit files:

/geo compare <baseline-file> <current-file>

For example:

/geo compare ~/.geo-prospects/audits/electron-srl.com-2026-01-15.md ~/.geo-prospects/audits/electron-srl.com-2026-03-12.md

Month-Specific Reporting

To generate a report for a particular month:

/geo compare <domain> --month <month-year>

Example:

/geo compare electron-srl.com --month march-2026

Output

The skill generates a markdown report summarizing:

• Each GEO audit category, with before-and-after scores and the delta
• Action items completed since the last audit
• A client-facing summary highlighting overall progress

When to Use It

• Monthly Client Check-ins: Use the skill during regular reporting cycles to deliver updated progress reports.
• Retention Presentations: Show clear, quantifiable improvements to support client retention and contract renewals.
• After Significant Updates: When major changes or optimizations have been implemented, use the skill to demonstrate their impact.
• On-Demand Comparisons: For internal reviews or ad-hoc client requests regarding progress over a specific period.

Important Notes

• File Naming and Structure: Audit files must follow the expected naming convention (<domain>-<YYYY-MM-DD>.md) and reside in the ~/.geo-prospects/audits/ directory for automatic file discovery.
• Minimum Data Requirement: At least one audit file must exist for a domain. If only one is present, the skill will attempt to generate a new quick audit for comparison.
• Command Flexibility: The skill can be triggered via domain name, specific file paths, or with additional parameters such as month selection.
• Intended Audience: The output is tailored for client consumption but requires proper configuration by technical users or account managers familiar with the reporting process.
• No Emojis or Non-English Output: All reports and interactions are strictly in English and adhere to a professional tone.
• Extensible Integration: The skill is built to fit within the broader Happycapy Skills platform and can integrate with other automation or reporting workflows.

For more technical details, visit the source repository.