# GEO monthly delta report generator Human Guide ## What This Is For Monthly delta tracking and progress reporting for GEO clients. It gives the agent a clearer input/output frame for search and SEO workflows: what context to ask for, what decisions to make, and what usable artifact to return. Use this as a human-readable version of the GEO monthly delta report generator agent skill. It is meant for marketers, operators, founders, and other non-coders who want the workflow without reading agent-specific implementation instructions. ## When To Use This - Use this when you need a repeatable process for GEO monthly delta report generator. - Use this when the task needs judgment, examples, constraints, or a clear output format rather than a one-off prompt. - Use this when you want to hand an AI assistant enough context to produce a usable marketing artifact. ## When Not To Use This - Do not use this when you only need a quick factual answer. - Do not use this when the work depends on private data you cannot share with the assistant. - Do not use this as a replacement for legal, compliance, financial, or medical review. ## What You Need Before Starting - The goal or business outcome you want. - The audience, customer segment, or market context. - Any source material the assistant should respect, such as notes, briefs, examples, URLs, or brand guidance. - Constraints such as tone, length, channel, deadline, region, or approval requirements. - A clear definition of what a good final answer should look like. ## Step-By-Step Workflow 1. State the job clearly: "Use the GEO monthly delta report generator guide to help me with..." 2. Add context: audience, goal, offer, channel, source material, and constraints. 3. Ask the assistant to identify missing inputs before producing the final output. 4. Have the assistant follow the skill-specific guidance below. 5. Review the result against the final checklist and ask for revisions where needed. ## Skill-Specific Guidance - Look in `~/.geo-prospects/audits/` for files matching `-*.md` - Use oldest as baseline, newest as current - If only one file exists: use it as baseline, run a fresh quick audit as current - If no files exist: suggest running `/geo prospect audit ` first - Per-category scores (6 categories) - Per-platform scores (5 platforms) - AI crawler status (14 crawlers) - Action items list with status - Trend = ▲ (improved), ▼ (declined), ── (unchanged) - Color coding in report: green (+), red (-), gray (=) - Save report to `~/.geo-prospects/reports/-monthly-.md` - Print confirmation with key stats: ## Decision Points And Nuance The original skill emphasizes: Purpose, Commands, Workflow, Step 1: Find Audit Files, Step 2: Parse Both Audits, Step 3: Calculate Deltas, Step 4: Generate Monthly Report, Report Template, [COMPANY NAME] — [MONTH YEAR], Executive Summary. Use these questions to steer the work: - What is the intended audience or buyer? - What source material must be preserved? - What should the assistant optimize for: clarity, persuasion, accuracy, speed, creativity, or conversion? - What examples represent the desired quality bar? - What should the assistant avoid? ## Common Mistakes - Starting without a clear audience or goal. - Asking for a final artifact before sharing examples or constraints. - Accepting a generic first draft without checking it against the intended use. ## Copy-And-Paste Prompt ```text Use the GEO monthly delta report generator human guide. My goal: [Describe the business outcome] Audience: [Describe who this is for] Context and source material: [Paste notes, examples, links, or existing copy] Constraints: [Tone, length, channel, timeline, must-include items, must-avoid items] Before producing the final output, ask me for any missing information that would materially improve the result. ``` ## Final Checklist - [ ] The output matches the original goal. - [ ] The audience and context are reflected in the answer. - [ ] Important constraints and source material were preserved. - [ ] The assistant made the relevant decisions explicit. - [ ] The final artifact is ready to use, review, or hand to the next person. ## Source This guide was generated from the zubair-trabzada/geo-seo-claude skill entry for `geo-compare`. ## Source Skill Notes These notes preserve the nuance from the original skill. Use them as supporting reference when the workflow above feels too generic. # 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 /geo compare /geo compare electron-srl.com --month march-2026 ``` **Examples:** ``` /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 `-*.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 ` 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/-monthly-.md` --- ## Report Template Generate the following document: ```markdown # 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'