Performance Reporter

1---2name: performance-reporter3description: 'Generate SEO/GEO dashboards: rankings, traffic, backlinks, AI visibility for stakeholders. SEO报告/绩效仪表盘'4version: "9.0.0"5license: Apache-2.06compatibility: "Claude Code ≥1.0, skills.sh marketplace, ClawHub marketplace, Vercel Labs skills ecosystem. No system packages required. Optional: MCP network access for SEO tool integrations."7homepage: "https://github.com/aaron-he-zhu/seo-geo-claude-skills"8when_to_use: "Use when generating SEO performance reports, traffic summaries, ranking reports, or stakeholder-facing dashboards."9argument-hint: "<domain> [date range]"10metadata:11  author: aaron-he-zhu12  version: "9.0.0"13  geo-relevance: "medium"14  tags:15    - seo16    - geo17    - seo-reporting18    - performance-report19    - kpi-dashboard20    - traffic-report21    - monthly-report22    - stakeholder-report23    - SEO报告24    - SEOレポート25    - SEO리포트26    - informe-seo27  triggers:28    # EN-formal29    - "generate SEO report"30    - "performance report"31    - "traffic report"32    - "SEO dashboard"33    - "SEO analytics"34    - "monthly report"35    # EN-casual36    - "report to stakeholders"37    - "monthly SEO report"38    - "show me my SEO results"39    - "present SEO results to my boss"40    - "report to my boss"41    - "monthly SEO summary"42    # EN-question43    - "how are my SEO metrics"44    - "how is my SEO performing"45    # ZH-pro46    - "SEO报告"47    - "绩效仪表盘"48    - "流量报告"49    - "数据看板"50    # ZH-casual51    - "出SEO报告"52    - "汇报给老板"53    - "看看数据"54    - "月报"55    - "出月报"56    - "周报"57    # JA58    - "SEOレポート"59    - "パフォーマンスレポート"60    # KO61    - "SEO 리포트"62    - "성과 보고서"63    # ES64    - "informe SEO"65    - "reporte de rendimiento"66    # PT67    - "relatório SEO"68    # Misspellings69    - "SEO repoort"70---71 72# Performance Reporter73 74 75> **[SEO & GEO Skills Library](https://github.com/aaron-he-zhu/seo-geo-claude-skills)** · 20 skills for SEO + GEO · [ClawHub](https://clawhub.ai/u/aaron-he-zhu) · [skills.sh](https://skills.sh/aaron-he-zhu/seo-geo-claude-skills)76> **System Mode**: This monitoring skill follows the shared [Skill Contract](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/references/skill-contract.md) and [State Model](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/references/state-model.md).77 78 79This 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.80 81**System role**: Monitoring layer skill. It turns performance changes into deltas, alerts, and next actions.82 83## When This Must Trigger84 85Use this when the conversation involves time-aware change detection, escalation, or stakeholder-ready visibility — even if the user doesn't use SEO terminology:86 87- Monthly/quarterly SEO reporting88- Executive stakeholder updates89- Client reporting for agencies90- Tracking campaign performance91- Combining multiple SEO metrics92- Creating GEO visibility reports93- Documenting ROI from SEO efforts94 95## What This Skill Does96 971. **Data Aggregation**: Combines multiple SEO data sources982. **Trend Analysis**: Identifies patterns across metrics993. **Executive Summaries**: Creates high-level overviews1004. **Visual Reports**: Presents data in clear formats1015. **Benchmark Comparison**: Tracks against goals and competitors1026. **Content Quality Tracking**: Integrates CORE-EEAT scores across audited pages1037. **ROI Calculation**: Measures SEO investment returns1048. **Recommendations**: Suggests actions based on data105 106## Quick Start107 108Start with one of these prompts. Finish with a short handoff summary using the repository format in [Skill Contract](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/references/skill-contract.md).109 110### Generate Performance Report111 112```113Create an SEO performance report for [domain] for [time period]114```115 116### Executive Summary117 118```119Generate an executive summary of SEO performance for [month/quarter]120```121 122### Specific Report Types123 124```125Create a GEO visibility report for [domain]126```127 128```129Generate a content performance report130```131 132## Skill Contract133 134**Expected output**: a delta summary, alert/report output, and a short handoff summary ready for `memory/monitoring/`.135 136- **Reads**: current metrics, previous baselines, alert thresholds, and reporting context from [CLAUDE.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/CLAUDE.md) and the shared [State Model](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/references/state-model.md) when available.137- **Writes**: a user-facing monitoring deliverable plus a reusable summary that can be stored under `memory/monitoring/`.138- **Promotes**: significant changes, confirmed anomalies, and follow-up actions to `memory/open-loops.md` and `memory/decisions.md`.139- **Next handoff**: use the `Next Best Skill` below when a change needs action.140 141### Handoff Summary142 143Emit this shape when finishing the skill (see [skill-contract.md §Handoff Summary Format](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/references/skill-contract.md) for the authoritative format):144 145- **Status**: DONE / DONE_WITH_CONCERNS / BLOCKED / NEEDS_INPUT146- **Objective**: what was analyzed, created, or fixed147- **Key Findings / Output**: the highest-signal result148- **Evidence**: URLs, data points, or sections reviewed149- **Open Loops**: blockers, missing inputs, or unresolved risks150- **Recommended Next Skill**: one primary next move151 152## Data Sources153 154> **Note:** All integrations are optional. This skill works without any API keys — users provide data manually when no tools are connected.155 156> See [CONNECTORS.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/CONNECTORS.md) for tool category placeholders.157 158**With ~~analytics + ~~search console + ~~SEO tool + ~~AI monitor connected:**159Automatically 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.160 161**With manual data only:**162Ask the user to provide:1631. Analytics screenshots or traffic data export (sessions, users, conversions)1642. Search Console data (impressions, clicks, average position)1653. Keyword ranking data for the reporting period1664. Backlink metrics (referring domains, new/lost links)1675. Key performance indicators and goals for comparison1686. AI citation data if tracking GEO metrics169 170Proceed with the full analysis using provided data. Note in the output which metrics are from automated collection vs. user-provided data.171 172## Instructions173 174When a user requests a performance report:175 1761. **Define Report Parameters** -- Domain, report period, comparison period, report type (Monthly/Quarterly/Annual), audience (Executive/Technical/Client), focus areas.177 1782. **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.179 1803. **Report Organic Traffic Performance** -- Traffic overview (sessions, users, pageviews, bounce rate), traffic trend visualization, traffic by source/device, top performing pages.181 1824. **Report Keyword Rankings** -- Rankings overview by position range, distribution change visualization, top improvements and declines, SERP feature performance.183 1845. **Report GEO/AI Performance** -- AI citation overview, citations by topic, GEO wins, optimization opportunities.185 1866. **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."187 1887. **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."189 1908. **Report Backlink Performance** -- Link profile summary, weekly link acquisition, notable new links, competitive position.191 1929. **Report Content Performance** -- Publishing summary, top performing content, content needing attention, content ROI.193 19410. **Generate Recommendations** -- Immediate/short-term/long-term actions with priority, expected impact, and owner. Goals for next period.195 19611. **Compile Full Report** -- Combine all sections with table of contents, appendix (data sources, methodology, glossary).197 198   > **Reference**: See [references/report-output-templates.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/monitor/performance-reporter/references/report-output-templates.md) for complete output templates for all 11 report sections.199 200## Validation Checkpoints201 202### Input Validation203- [ ] Reporting period clearly defined with comparison period204- [ ] All required data sources available or alternatives noted205- [ ] Target audience identified (executive/technical/client)206- [ ] Performance goals and KPIs established for benchmarking207 208### Output Validation209- [ ] Every metric cites its data source and collection date210- [ ] Trends include period-over-period comparisons211- [ ] Recommendations are specific, prioritized, and actionable212- [ ] Source of each data point clearly stated (~~analytics data, ~~search console data, ~~SEO tool data, user-provided, or estimated)213 214## Example215 216**User**: "Create a monthly SEO report for cloudhosting.com for January 2025"217 218**Output** (abbreviated -- full report uses templates from all 11 steps):219 220```markdown221# CloudHosting SEO & GEO Performance Report — January 2025222 223## Executive Summary — Overall Performance: Good224 225| Metric | Jan 2025 | Dec 2024 | Change | Target | Status |226|--------|----------|----------|--------|--------|--------|227| Organic Traffic | 52,100 | 45,200 | +15.3% | 50,000 | On track |228| Keywords Top 10 | 87 | 79 | +8 | 90 | Watch |229| Organic Conversions | 684 | 612 | +11.8% | 700 | Watch |230| Domain Rating | 54 | 53 | +1 | 55 | Watch |231| AI Citations | 18 | 12 | +50.0% | 20 | Watch |232 233**SEO ROI**: $8,200 invested / $41,040 organic revenue = 400%234 235**Immediate**: Fix 37 crawl errors on /pricing/ pages236**This Month**: Optimize mobile LCP; publish 3 AI Overview comparison pages237**This Quarter**: Build Wikidata entry for CloudHost Inc.238```239 240## Tips for Success241 2421. **Lead with insights** - Start with what matters, not raw data2432. **Visualize data** - Charts and graphs improve comprehension2443. **Compare periods** - Context makes data meaningful2454. **Include actions** - Every report should drive decisions2465. **Customize for audience** - Executives need different info than technical teams2476. **Track GEO metrics** - AI visibility is increasingly important248 249 250### Save Results251 252After delivering monitoring data or reports to the user, ask:253 254> "Save these results for future sessions?"255 256If yes, write a dated summary to `memory/monitoring/YYYY-MM-DD-<topic>.md` containing:257- One-line headline finding or status change258- Top 3-5 actionable items259- Open loops or anomalies requiring follow-up260- Source data references261 262If any findings should influence ongoing strategy, recommend promoting key conclusions to `memory/hot-cache.md`.263 264## Reference Materials265 266- [Report Output Templates](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/monitor/performance-reporter/references/report-output-templates.md) — Complete output templates for all 11 report sections267- [KPI Definitions](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/monitor/performance-reporter/references/kpi-definitions.md) — SEO/GEO metric definitions with benchmarks, good ranges, warning thresholds, trend analysis, and attribution guidance268- [Report Templates by Audience](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/monitor/performance-reporter/references/report-templates.md) — Copy-ready templates for executive, marketing, technical, and client audiences269 270## Next Best Skill271 272- **Primary**: [alert-manager](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/monitor/alert-manager/SKILL.md) — turn reporting insights into ongoing monitoring rules.