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.md and memory/decisions.md.
- Next handoff: use the
Next Best Skill below 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
Output Validation
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
Next Best Skill
- Primary: alert-manager — turn reporting insights into ongoing monitoring rules.
1---
2name: performance-reporter
3description: 'Generate SEO/GEO dashboards: rankings, traffic, backlinks, AI visibility for stakeholders. SEO报告/绩效仪表盘'
4version: "6.0.0"
5license: Apache-2.0
6compatibility: "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-zhu
12 version: "6.0.0"
13 geo-relevance: "medium"
14 tags:
15 - seo
16 - geo
17 - seo-reporting
18 - performance-report
19 - kpi-dashboard
20 - traffic-report
21 - monthly-report
22 - stakeholder-report
23 - SEO报告
24 - SEOレポート
25 - SEO리포트
26 - informe-seo
27 triggers:
28 # EN-formal
29 - "generate SEO report"
30 - "performance report"
31 - "traffic report"
32 - "SEO dashboard"
33 - "SEO analytics"
34 - "monthly report"
35 # EN-casual
36 - "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-question
43 - "how are my SEO metrics"
44 - "how is my SEO performing"
45 # ZH-pro
46 - "SEO报告"
47 - "绩效仪表盘"
48 - "流量报告"
49 - "数据看板"
50 # ZH-casual
51 - "出SEO报告"
52 - "汇报给老板"
53 - "看看数据"
54 - "月报"
55 - "出月报"
56 - "周报"
57 # JA
58 - "SEOレポート"
59 - "パフォーマンスレポート"
60 # KO
61 - "SEO 리포트"
62 - "성과 보고서"
63 # ES
64 - "informe SEO"
65 - "reporte de rendimiento"
66 # PT
67 - "relatório SEO"
68 # Misspellings
69 - "SEO repoort"
70---
71
72# Performance Reporter
73
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 Trigger
84
85Use this when the conversation involves any of these situations — even if the user does not use SEO terminology:
86
87Use this whenever the task needs time-aware change detection, escalation, or stakeholder-ready visibility.
88
89- Monthly/quarterly SEO reporting
90- Executive stakeholder updates
91- Client reporting for agencies
92- Tracking campaign performance
93- Combining multiple SEO metrics
94- Creating GEO visibility reports
95- Documenting ROI from SEO efforts
96
97## What This Skill Does
98
991. **Data Aggregation**: Combines multiple SEO data sources
1002. **Trend Analysis**: Identifies patterns across metrics
1013. **Executive Summaries**: Creates high-level overviews
1024. **Visual Reports**: Presents data in clear formats
1035. **Benchmark Comparison**: Tracks against goals and competitors
1046. **Content Quality Tracking**: Integrates CORE-EEAT scores across audited pages
1057. **ROI Calculation**: Measures SEO investment returns
1068. **Recommendations**: Suggests actions based on data
107
108## Quick Start
109
110Start 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).
111
112### Generate Performance Report
113
114```
115Create an SEO performance report for [domain] for [time period]
116```
117
118### Executive Summary
119
120```
121Generate an executive summary of SEO performance for [month/quarter]
122```
123
124### Specific Report Types
125
126```
127Create a GEO visibility report for [domain]
128```
129
130```
131Generate a content performance report
132```
133
134## Skill Contract
135
136**Expected output**: a delta summary, alert/report output, and a short handoff summary ready for `memory/monitoring/`.
137
138- **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.
139- **Writes**: a user-facing monitoring deliverable plus a reusable summary that can be stored under `memory/monitoring/`.
140- **Promotes**: significant changes, confirmed anomalies, and follow-up actions to `memory/open-loops.md` and `memory/decisions.md`.
141- **Next handoff**: use the `Next Best Skill` below when a change needs action.
142
143## Data Sources
144
145> **Note:** All integrations are optional. This skill works without any API keys — users provide data manually when no tools are connected.
146
147> See [CONNECTORS.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/CONNECTORS.md) for tool category placeholders.
148
149**With ~~analytics + ~~search console + ~~SEO tool + ~~AI monitor connected:**
150Automatically 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.
151
152**With manual data only:**
153Ask the user to provide:
1541. Analytics screenshots or traffic data export (sessions, users, conversions)
1552. Search Console data (impressions, clicks, average position)
1563. Keyword ranking data for the reporting period
1574. Backlink metrics (referring domains, new/lost links)
1585. Key performance indicators and goals for comparison
1596. AI citation data if tracking GEO metrics
160
161Proceed with the full analysis using provided data. Note in the output which metrics are from automated collection vs. user-provided data.
162
163## Instructions
164
165When a user requests a performance report:
166
1671. **Define Report Parameters** -- Domain, report period, comparison period, report type (Monthly/Quarterly/Annual), audience (Executive/Technical/Client), focus areas.
168
1692. **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.
170
1713. **Report Organic Traffic Performance** -- Traffic overview (sessions, users, pageviews, bounce rate), traffic trend visualization, traffic by source/device, top performing pages.
172
1734. **Report Keyword Rankings** -- Rankings overview by position range, distribution change visualization, top improvements and declines, SERP feature performance.
174
1755. **Report GEO/AI Performance** -- AI citation overview, citations by topic, GEO wins, optimization opportunities.
176
1776. **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."
178
1797. **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."
180
1818. **Report Backlink Performance** -- Link profile summary, weekly link acquisition, notable new links, competitive position.
182
1839. **Report Content Performance** -- Publishing summary, top performing content, content needing attention, content ROI.
184
18510. **Generate Recommendations** -- Immediate/short-term/long-term actions with priority, expected impact, and owner. Goals for next period.
186
18711. **Compile Full Report** -- Combine all sections with table of contents, appendix (data sources, methodology, glossary).
188
189 > **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.
190
191## Validation Checkpoints
192
193### Input Validation
194- [ ] Reporting period clearly defined with comparison period
195- [ ] All required data sources available or alternatives noted
196- [ ] Target audience identified (executive/technical/client)
197- [ ] Performance goals and KPIs established for benchmarking
198
199### Output Validation
200- [ ] Every metric cites its data source and collection date
201- [ ] Trends include period-over-period comparisons
202- [ ] Recommendations are specific, prioritized, and actionable
203- [ ] Source of each data point clearly stated (~~analytics data, ~~search console data, ~~SEO tool data, user-provided, or estimated)
204
205## Example
206
207**User**: "Create a monthly SEO report for cloudhosting.com for January 2025"
208
209**Output** (abbreviated -- full report uses templates from all 11 steps):
210
211```markdown
212# CloudHosting SEO & GEO Performance Report — January 2025
213
214## Executive Summary — Overall Performance: Good
215
216| Metric | Jan 2025 | Dec 2024 | Change | Target | Status |
217|--------|----------|----------|--------|--------|--------|
218| Organic Traffic | 52,100 | 45,200 | +15.3% | 50,000 | On track |
219| Keywords Top 10 | 87 | 79 | +8 | 90 | Watch |
220| Organic Conversions | 684 | 612 | +11.8% | 700 | Watch |
221| Domain Rating | 54 | 53 | +1 | 55 | Watch |
222| AI Citations | 18 | 12 | +50.0% | 20 | Watch |
223
224**SEO ROI**: $8,200 invested / $41,040 organic revenue = 400%
225
226**Immediate**: Fix 37 crawl errors on /pricing/ pages
227**This Month**: Optimize mobile LCP; publish 3 AI Overview comparison pages
228**This Quarter**: Build Wikidata entry for CloudHost Inc.
229```
230
231## Tips for Success
232
2331. **Lead with insights** - Start with what matters, not raw data
2342. **Visualize data** - Charts and graphs improve comprehension
2353. **Compare periods** - Context makes data meaningful
2364. **Include actions** - Every report should drive decisions
2375. **Customize for audience** - Executives need different info than technical teams
2386. **Track GEO metrics** - AI visibility is increasingly important
239
240
241### Save Results
242
243After delivering monitoring data or reports to the user, ask:
244
245> "Save these results for future sessions?"
246
247If yes, write a dated summary to `memory/monitoring/YYYY-MM-DD-<topic>.md` containing:
248- One-line headline finding or status change
249- Top 3-5 actionable items
250- Open loops or anomalies requiring follow-up
251- Source data references
252
253If any findings should influence ongoing strategy, recommend promoting key conclusions to `memory/hot-cache.md`.
254
255## Reference Materials
256
257- [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 sections
258- [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 guidance
259- [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 audiences
260
261## Next Best Skill
262
263- **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.