performance-reporter

name	performance-reporter
description	Generates comprehensive SEO and GEO performance reports combining rankings, traffic, backlinks, and AI visibility metrics. Creates executive summaries and detailed analyses for stakeholder reporting.

Performance Reporter

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

1. Data Aggregation: Combines multiple SEO data sources
2. Trend Analysis: Identifies patterns across metrics
3. Executive Summaries: Creates high-level overviews
4. Visual Reports: Presents data in clear formats
5. Benchmark Comparison: Tracks against goals and competitors
6. ROI Calculation: Measures SEO investment returns
7. 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:

1. Analytics screenshots or traffic data export (sessions, users, conversions)
2. Search Console data (impressions, clicks, average position)
3. Keyword ranking data for the reporting period
4. Backlink metrics (referring domains, new/lost links)
5. Key performance indicators and goals for comparison
6. 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:

1. 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]
   

2. 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]%
   

3. 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] |
   
   
   
   

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 December 2024"

Output: [Full report following the structure above with period-specific data and insights]

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

1. Lead with insights - Start with what matters, not raw data
2. Visualize data - Charts and graphs improve comprehension
3. Compare periods - Context makes data meaningful
4. Include actions - Every report should drive decisions
5. Customize for audience - Executives need different info than technical teams
6. Track GEO metrics - AI visibility is increasingly important

Related Skills

• rank-tracker - Detailed ranking data
• backlink-analyzer - Link profile data
• alert-manager - Set up report triggers
• serp-analysis - SERP composition data
• memory-management - Archive reports in project memory