performance-reporter
Comprehensive SEO and GEO performance reports combining rankings, traffic, backlinks, and AI visibility metrics.
- Aggregates data from multiple sources (analytics, search console, SEO tools, AI monitors) into executive summaries, detailed analyses, and visual presentations
- Generates 11-section reports covering organic traffic, keyword rankings, domain authority, content quality (CORE-EEAT), backlinks, and GEO/AI citation performance
- Includes period-over-period trend analysis, benchmark comparisons against goals, and ROI calculations for stakeholder communication
- Supports manual data input when automated connectors unavailable; customizable for executive, technical, and client audiences with actionable recommendations prioritized by impact
Performance Reporter
SEO & GEO Skills Library · 20 skills for SEO + GEO · ClawHub · skills.sh System Mode: This monitoring skill follows the shared Skill Contract and State Model.
This skill creates comprehensive SEO and GEO performance reports that combine multiple metrics into actionable insights. It produces executive summaries, detailed analyses, and visual data presentations for stakeholder communication.
System role: Monitoring layer skill. It turns performance changes into deltas, alerts, and next actions.
When This Must Trigger
Use this when the conversation involves any of these situations — even if the user does not use SEO terminology:
Use this whenever the task needs time-aware change detection, escalation, or stakeholder-ready visibility.
- Monthly/quarterly SEO reporting
- Executive stakeholder updates
- Client reporting for agencies
- Tracking campaign performance
- Combining multiple SEO metrics
- Creating GEO visibility reports
- Documenting ROI from SEO efforts
What This Skill Does
- Data Aggregation: Combines multiple SEO data sources
- Trend Analysis: Identifies patterns across metrics
- Executive Summaries: Creates high-level overviews
- Visual Reports: Presents data in clear formats
- Benchmark Comparison: Tracks against goals and competitors
- Content Quality Tracking: Integrates CORE-EEAT scores across audited pages
- ROI Calculation: Measures SEO investment returns
- Recommendations: Suggests actions based on data
Quick Start
Start with one of these prompts. Finish with a short handoff summary using the repository format in Skill Contract.
Generate Performance Report
Create an SEO performance report for [domain] for [time period]
Executive Summary
Generate an executive summary of SEO performance for [month/quarter]
Specific Report Types
Create a GEO visibility report for [domain]
Generate a content performance report
Skill Contract
Expected output: a delta summary, alert/report output, and a short handoff summary ready for memory/monitoring/.
- Reads: current metrics, previous baselines, alert thresholds, and reporting context from CLAUDE.md and the shared State Model when available.
- Writes: a user-facing monitoring deliverable plus a reusable summary that can be stored under
memory/monitoring/. - Promotes: significant changes, confirmed anomalies, and follow-up actions to
memory/open-loops.mdandmemory/decisions.md. - Next handoff: use the
Next Best Skillbelow when a change needs action.
Data Sources
Note: All integrations are optional. This skill works without any API keys — users provide data manually when no tools are connected.
See CONNECTORS.md for tool category placeholders.
With ~~analytics + ~~search console + ~~SEO tool + ~~AI monitor connected: Automatically aggregate traffic metrics from ~~analytics, search performance data from ~~search console, ranking and backlink data from ~~SEO tool, and GEO visibility metrics from ~~AI monitor. Creates comprehensive multi-source reports with historical trends.
With manual data only: Ask the user to provide:
- Analytics screenshots or traffic data export (sessions, users, conversions)
- Search Console data (impressions, clicks, average position)
- Keyword ranking data for the reporting period
- Backlink metrics (referring domains, new/lost links)
- Key performance indicators and goals for comparison
- AI citation data if tracking GEO metrics
Proceed with the full analysis using provided data. Note in the output which metrics are from automated collection vs. user-provided data.
Instructions
When a user requests a performance report:
-
Define Report Parameters -- Domain, report period, comparison period, report type (Monthly/Quarterly/Annual), audience (Executive/Technical/Client), focus areas.
-
Create Executive Summary -- Overall performance rating, key wins/watch areas/action required, metrics at a glance table (traffic, rankings, conversions, DA, AI citations), SEO ROI calculation.
-
Report Organic Traffic Performance -- Traffic overview (sessions, users, pageviews, bounce rate), traffic trend visualization, traffic by source/device, top performing pages.
-
Report Keyword Rankings -- Rankings overview by position range, distribution change visualization, top improvements and declines, SERP feature performance.
-
Report GEO/AI Performance -- AI citation overview, citations by topic, GEO wins, optimization opportunities.
-
Report Domain Authority (CITE Score) -- If a CITE audit has been run, include CITE dimension scores (C/I/T/E) with period-over-period trends and veto status. If no audit exists, note as "Not yet evaluated."
-
Content Quality (CORE-EEAT Score) -- If content-quality-auditor has been run, include average scores across all 8 CORE-EEAT dimensions with trends. If no audit exists, note as "Not yet evaluated."
-
Report Backlink Performance -- Link profile summary, weekly link acquisition, notable new links, competitive position.
-
Report Content Performance -- Publishing summary, top performing content, content needing attention, content ROI.
-
Generate Recommendations -- Immediate/short-term/long-term actions with priority, expected impact, and owner. Goals for next period.
-
Compile Full Report -- Combine all sections with table of contents, appendix (data sources, methodology, glossary).
Reference: See references/report-output-templates.md for complete output templates for all 11 report sections.
Validation Checkpoints
Input Validation
- Reporting period clearly defined with comparison period
- All required data sources available or alternatives noted
- Target audience identified (executive/technical/client)
- Performance goals and KPIs established for benchmarking
Output Validation
- Every metric cites its data source and collection date
- Trends include period-over-period comparisons
- Recommendations are specific, prioritized, and actionable
- Source of each data point clearly stated (~~analytics data, ~~search console data, ~~SEO tool data, user-provided, or estimated)
Example
User: "Create a monthly SEO report for cloudhosting.com for January 2025"
Output (abbreviated -- full report uses templates from all 11 steps):
# CloudHosting SEO & GEO Performance Report — January 2025
## Executive Summary — Overall Performance: Good
| Metric | Jan 2025 | Dec 2024 | Change | Target | Status |
|--------|----------|----------|--------|--------|--------|
| Organic Traffic | 52,100 | 45,200 | +15.3% | 50,000 | On track |
| Keywords Top 10 | 87 | 79 | +8 | 90 | Watch |
| Organic Conversions | 684 | 612 | +11.8% | 700 | Watch |
| Domain Rating | 54 | 53 | +1 | 55 | Watch |
| AI Citations | 18 | 12 | +50.0% | 20 | Watch |
**SEO ROI**: $8,200 invested / $41,040 organic revenue = 400%
**Immediate**: Fix 37 crawl errors on /pricing/ pages
**This Month**: Optimize mobile LCP; publish 3 AI Overview comparison pages
**This Quarter**: Build Wikidata entry for CloudHost Inc.
Tips for Success
- Lead with insights - Start with what matters, not raw data
- Visualize data - Charts and graphs improve comprehension
- Compare periods - Context makes data meaningful
- Include actions - Every report should drive decisions
- Customize for audience - Executives need different info than technical teams
- Track GEO metrics - AI visibility is increasingly important
Save Results
After delivering monitoring data or reports to the user, ask:
"Save these results for future sessions?"
If yes, write a dated summary to memory/monitoring/YYYY-MM-DD-<topic>.md containing:
- One-line headline finding or status change
- Top 3-5 actionable items
- Open loops or anomalies requiring follow-up
- Source data references
If any findings should influence ongoing strategy, recommend promoting key conclusions to memory/hot-cache.md.
Reference Materials
- Report Output Templates — Complete output templates for all 11 report sections
- KPI Definitions — SEO/GEO metric definitions with benchmarks, good ranges, warning thresholds, trend analysis, and attribution guidance
- Report Templates by Audience — Copy-ready templates for executive, marketing, technical, and client audiences
Next Best Skill
- Primary: alert-manager — turn reporting insights into ongoing monitoring rules.