| name | performance-reporter |
| description | Use when the user asks to "generate SEO report", "performance report", "traffic report", "SEO dashboard", "report to stakeholders", "show me the numbers", "monthly SEO report", or "present SEO results to my boss". Generates comprehensive SEO and GEO performance reports combining rankings, traffic, backlinks, and AI visibility metrics. Creates executive summaries and detailed analyses for stakeholder reporting. For detailed rank tracking, see rank-tracker. For link-specific analysis, see backlink-analyzer. |
| license | Apache-2.0 |
| metadata | {"author":"aaron-he-zhu","version":"2.0.0","geo-relevance":"medium","tags":["seo","geo","performance report","seo report","traffic analysis","seo dashboard","executive summary","analytics report","kpi tracking"],"triggers":["generate SEO report","performance report","traffic report","SEO dashboard","report to stakeholders","monthly report","SEO analytics","show me the numbers","monthly SEO report","present SEO results to my boss"]} |
Performance Reporter
SEO & GEO Skills Library · 20 skills for SEO + GEO · Install all: npx skills add aaron-he-zhu/seo-geo-claude-skills
Browse all 20 skills
Research · keyword-research · competitor-analysis · serp-analysis · content-gap-analysis
Build · seo-content-writer · geo-content-optimizer · meta-tags-optimizer · schema-markup-generator
Optimize · on-page-seo-auditor · technical-seo-checker · internal-linking-optimizer · content-refresher
Monitor · rank-tracker · backlink-analyzer · performance-reporter · alert-manager
Cross-cutting · content-quality-auditor · domain-authority-auditor · entity-optimizer · memory-management
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.
When to Use This Skill
- 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
How to Use
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
Data Sources
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
## Report Configuration
**Domain**: [domain]
**Report Period**: [start date] to [end date]
**Comparison Period**: [previous period for comparison]
**Report Type**: [Monthly/Quarterly/Annual/Custom]
**Audience**: [Executive/Technical/Client]
**Focus Areas**: [Rankings/Traffic/Content/Backlinks/GEO]
-
Create Executive Summary
# SEO Performance Report
**Domain**: [domain]
**Period**: [date range]
**Prepared**: [date]
---
## Executive Summary
### Overall Performance: [Excellent/Good/Needs Attention/Critical]
**Key Highlights**:
🟢 **Wins**:
- [Win 1 - e.g., "Organic traffic increased 25%"]
- [Win 2 - e.g., "3 new #1 rankings achieved"]
- [Win 3 - e.g., "Conversion rate improved 15%"]
🟡 **Watch Areas**:
- [Area 1 - e.g., "Mobile rankings declining slightly"]
- [Area 2 - e.g., "Competitor gaining ground on key terms"]
🔴 **Action Required**:
- [Issue 1 - e.g., "Technical SEO audit needed"]
### Key Metrics at a Glance
| Metric | This Period | Last Period | Change | Target | Status |
|--------|-------------|-------------|--------|--------|--------|
| Organic Traffic | [X] | [Y] | [+/-Z%] | [T] | ✅/⚠️/❌ |
| Keyword Rankings (Top 10) | [X] | [Y] | [+/-Z] | [T] | ✅/⚠️/❌ |
| Organic Conversions | [X] | [Y] | [+/-Z%] | [T] | ✅/⚠️/❌ |
| Domain Authority | [X] | [Y] | [+/-Z] | [T] | ✅/⚠️/❌ |
| AI Citations | [X] | [Y] | [+/-Z%] | [T] | ✅/⚠️/❌ |
### SEO ROI
**Investment**: $[X] (content, tools, effort)
**Organic Revenue**: $[Y]
**ROI**: [Z]%
-
Report Organic Traffic Performance
| Metric | This Period | vs Last Period | vs Last Year |
|--------|-------------|----------------|--------------|
| Sessions | [X] | [+/-Y%] | [+/-Z%] |
| Users | [X] | [+/-Y%] | [+/-Z%] |
| Pageviews | [X] | [+/-Y%] | [+/-Z%] |
| Avg. Session Duration | [X] | [+/-Y%] | [+/-Z%] |
| Bounce Rate | [X]% | [+/-Y%] | [+/-Z%] |
| Pages per Session | [X] | [+/-Y] | [+/-Z] |
## Recommendations & Next Steps
### Immediate Actions (This Week)
| Priority | Action | Expected Impact | Owner |
|----------|--------|-----------------|-------|
| 🔴 High | [Action 1] | [Impact] | [Owner] |
| 🔴 High | [Action 2] | [Impact] | [Owner] |
### Short-term (This Month)
| Priority | Action | Expected Impact | Owner |
|----------|--------|-----------------|-------|
| 🟡 Medium | [Action 1] | [Impact] | [Owner] |
| 🟡 Medium | [Action 2] | [Impact] | [Owner] |
### Long-term (This Quarter)
| Priority | Action | Expected Impact | Owner |
|----------|--------|-----------------|-------|
| 🟢 Planned | [Action 1] | [Impact] | [Owner] |
### Goals for Next Period
| Metric | Current | Target | Action to Achieve |
|--------|---------|--------|-------------------|
| Organic Traffic | [X] | [Y] | [action] |
| Keywords Top 10 | [X] | [Y] | [action] |
| AI Citations | [X] | [Y] | [action] |
| Referring Domains | [X] | [Y] | [action] |
- Compile Full Report
# [Company] SEO & GEO Performance Report
## [Month/Quarter] [Year]
---
### Table of Contents
1. Executive Summary
2. Organic Traffic Performance
3. Keyword Rankings
4. GEO/AI Visibility
5. Domain Authority (CITE Score)
6. Content Quality (CORE-EEAT Score)
7. Backlink Analysis
8. Content Performance
9. Technical Health
10. Competitive Landscape
11. Recommendations
12. Appendix
---
[Include all sections from above]
---
## Appendix
### Data Sources
- ~~analytics (traffic and conversion data)
- ~~search console (search performance)
- ~~SEO tool (rankings and backlinks)
- ~~AI monitor (GEO metrics)
### Methodology
[Explain how metrics were calculated]
### Glossary
- **GEO**: Generative Engine Optimization
- **DA**: Domain Authority
- [Additional terms]
Validation Checkpoints
Input Validation
Output Validation
Example
User: "Create a monthly SEO report for cloudhosting.com for January 2025"
Output:
# CloudHosting SEO & GEO Performance Report
**Domain**: cloudhosting.com
**Period**: January 1-31, 2025
**Comparison**: vs December 2024
**Prepared**: February 3, 2025
---
## Executive Summary
### Overall Performance: Good
**Key Highlights**:
🟢 **Wins**:
- Organic traffic increased 15.3% (45,200 → 52,100 sessions)
- 4 new Top 10 keyword rankings in "cloud hosting" cluster
- Organic conversions up 11.8% (612 → 684 trial signups)
🟡 **Watch Areas**:
- Mobile page speed declining (LCP 3.1s → 3.4s)
- Competitor SiteGround gaining on "managed cloud hosting" terms
🔴 **Action Required**:
- Fix crawl errors on /pricing/ pages (37 404s detected)
### Key Metrics at a Glance
| Metric | Jan 2025 | Dec 2024 | Change | Target | Status |
|--------|----------|----------|--------|--------|--------|
| Organic Traffic | 52,100 | 45,200 | +15.3% | 50,000 | ✅ |
| Keywords Top 10 | 87 | 79 | +8 | 90 | ⚠️ |
| Organic Conversions | 684 | 612 | +11.8% | 700 | ⚠️ |
| Domain Rating | 54 | 53 | +1 | 55 | ⚠️ |
| AI Citations | 18 | 12 | +50.0% | 20 | ⚠️ |
### SEO ROI
**Investment**: $8,200 (content production, tools, link building)
**Organic Revenue**: $41,040 (684 trials × 12% close rate × $500 MRR)
**ROI**: 400%
---
## Organic Traffic Analysis
### Traffic Overview
| Metric | Jan 2025 | vs Dec 2024 | vs Jan 2024 |
|--------|----------|-------------|-------------|
| Sessions | 52,100 | +15.3% | +38.2% |
| Users | 41,680 | +14.1% | +35.7% |
| Pageviews | 98,990 | +12.6% | +29.4% |
| Avg. Session Duration | 2m 48s | +6.2% | +18.3% |
| Bounce Rate | 42.3% | -3.1% | -8.7% |
### Top Performing Pages
| Page | Sessions | Change | Conversions |
|------|----------|--------|-------------|
| /guide/cloud-hosting | 8,420 | +22.1% | 142 |
| /compare/aws-vs-gcp | 5,310 | +31.4% | 87 |
| /pricing | 4,890 | +9.8% | 201 |
---
## GEO (AI Visibility) Performance
### AI Citation Overview
| Metric | Jan 2025 | Dec 2024 | Change |
|--------|----------|----------|--------|
| Keywords with AI Overview | 34/120 | 28/120 | +6 |
| Your AI Citations | 18 | 12 | +50.0% |
| Citation Rate | 15.0% | 10.0% | +5.0% |
| Avg Citation Position | 2.4 | 3.1 | +0.7 |
| Query | Citation Status | Source Page | Impact |
|-------|-----------------|-------------|--------|
| "best cloud hosting for startups" | 🆕 New citation | /guide/cloud-hosting | High visibility |
| "cloud hosting vs shared hosting" | ⬆️ Position 4→2 | /compare/cloud-vs-shared | Better exposure |
| "managed cloud hosting benefits" | 🆕 New citation | /features/managed | High visibility |
---
| Metric | Jan 2025 | Dec 2024 | Change |
|--------|----------|----------|--------|
| CITE Score | 71/100 | 67/100 | +4 |
| C — Citation | 68/100 | 65/100 | +3 |
| I — Identity | 55/100 | 52/100 | +3 |
| T — Trust | 82/100 | 80/100 | +2 |
| E — Eminence | 61/100 | 58/100 | +3 |
: ✅ No triggers
---
| Priority | Action | Expected Impact | Owner |
|----------|--------|-----------------|-------|
| P0 | Fix 37 crawl errors on /pricing/ pages | Recover ~800 lost sessions/month | Dev team |
| Priority | Action | Expected Impact | Owner |
|----------|--------|-----------------|-------|
| P1 | Optimize mobile LCP on top 10 landing pages | Improve mobile rankings for 15+ keywords | Dev team |
| P1 | Publish 3 comparison pages targeting AI Overview queries | +5-8 new AI citations | Content team |
| Priority | Action | Expected Impact | Owner |
|----------|--------|-----------------|-------|
| P2 | Build Wikidata entry and Schema.org for CloudHost Inc. | Strengthen CITE Identity score by +10 pts | SEO lead |
Report Templates by Audience
Executive Report (1 page)
Focus on: Business impact, ROI, top-line metrics, key recommendations
Marketing Team Report (3-5 pages)
Focus on: Detailed metrics, content performance, campaign results
Technical SEO Report (5-10 pages)
Focus on: Crawl data, technical issues, detailed rankings, backlink analysis
Client Report (2-3 pages)
Focus on: Progress against goals, wins, clear recommendations
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
SEO/GEO Metric Definitions and Benchmarks
Organic Search Metrics
| Metric | Definition | Good Range | Warning | Source |
|---|
| Organic sessions | Visits from organic search | Growing MoM | >10% decline | ~~analytics |
| Keyword visibility | % of target keywords in top 100 | >60% | <40% | ~~SEO tool |
| Average position | Mean position across tracked keywords | <20 | >30 | ~~search console |
| Organic CTR | Clicks / impressions from search | >3% | <1.5% | ~~search console |
| Pages indexed | Pages in Google index | Growing | Dropping | ~~search console |
| Organic conversion rate | Conversions / organic sessions | >2% | <0.5% | ~~analytics |
| Non-brand organic traffic | Organic traffic minus brand searches | >50% of total organic | <30% | ~~analytics |
GEO/AI Visibility Metrics
| Metric | Definition | Good Range | Warning | Source |
|---|
| AI citation rate | % of monitored queries citing your content | >20% | <5% | ~~AI monitor |
| AI citation position | Average position in AI response citations | Top 3 sources | Not cited | ~~AI monitor |
| AI answer coverage | % of your topics appearing in AI answers | Growing | Declining | ~~AI monitor |
| Brand mention in AI | Times your brand is mentioned in AI responses | Growing | Zero | ~~AI monitor |
Domain Authority Metrics
| Metric | Definition | Good Range | Warning | Source |
|---|
| Domain Rating/Authority | Overall domain strength | Growing | Declining | ~~SEO tool |
| Referring domains | Unique domains linking to you | Growing MoM | Loss >10% MoM | ~~link database |
| Backlink growth rate | Net new backlinks per month | Positive | Negative trend | ~~link database |
| Toxic link ratio | Toxic links / total links | <5% | >10% | ~~link database |
Reporting Templates by Audience
Executive Report (C-Suite / Leadership)
Focus: Business outcomes, ROI, competitive position
Length: 1 page + appendix
Frequency: Monthly or Quarterly
| Section | Content |
|---|
| Traffic & Revenue | Organic traffic trend + attributed revenue |
| Competitive Position | Visibility share vs. top 3 competitors |
| AI Visibility | AI citation trend and coverage |
| Key Wins | Top 3 achievements with business impact |
| Risks | Top 3 concerns with proposed mitigation |
| Investment Ask | Resources needed for next period |
Marketing Team Report
Focus: Channel performance, content effectiveness, technical health
Length: 2-3 pages
Frequency: Monthly
| Section | Content |
|---|
| Keyword Performance | Rankings gained/lost, new keywords discovered |
| Content Performance | Top pages by traffic, engagement, conversions |
| Technical Health | Crawl errors, speed scores, indexation |
| Backlink Profile | New links, lost links, quality assessment |
| GEO Performance | AI citation changes, new citations |
| Action Items | P0-P3 prioritized task list |
Technical SEO Report
Focus: Crawlability, indexation, speed, errors
Length: Detailed
Frequency: Weekly or Bi-weekly
| Section | Content |
|---|
| Crawl Stats | Pages crawled, errors, crawl budget usage |
| Index Coverage | Indexed/excluded/errored pages |
| Core Web Vitals | LCP, CLS, INP trends |
| Error Log | New 4xx/5xx errors with resolution status |
| Schema Validation | New warnings, rich result eligibility |
| Technical Debt | Outstanding issues by priority |
Trend Analysis Framework
Period-Over-Period Analysis
| Comparison | Best For | Limitation |
|---|
| Week over week (WoW) | Detecting sudden changes | Noisy, affected by day-of-week patterns |
| Month over month (MoM) | Identifying trends | Seasonal bias |
| Year over year (YoY) | Accounting for seasonality | Does not reflect recent trajectory |
| Rolling 30-day average | Smoothing noise | Lags behind real changes |
Trend Interpretation Guidelines
| Pattern | Likely Cause | Recommended Action |
|---|
| Steady growth | Strategy is working | Continue, optimize high performers |
| Sudden spike then drop | Viral content or algorithm volatility | Investigate cause, build on if repeatable |
| Gradual decline | Content decay, competition, technical debt | Comprehensive audit needed |
| Flat line | Plateau — existing strategy maxed out | New content areas, new link strategies |
| Seasonal pattern | Industry/demand cycles | Plan content calendar around peaks |
SEO Attribution Guidance
Attribution Challenges in SEO
| Challenge | Impact | Mitigation |
|---|
| Long conversion paths | SEO rarely gets last-touch credit | Use assisted conversions report |
| Brand vs. non-brand | Brand searches inflate organic metrics | Always separate brand/non-brand |
| Cross-device journeys | Mobile search to desktop conversion | Enable cross-device tracking |
| SEO + paid overlap | Cannibalization or lift? | Test turning off paid for branded terms |
| Content assists sales | Hard to attribute | Track content touches in CRM |
Reference Materials
- KPI Definitions — Complete SEO/GEO metric definitions with benchmarks, good ranges, and warning thresholds
- Report Templates — Report templates by audience (executive, marketing, technical, client)
Related Skills
