Performance Reporter
- 4.8k installs
- 115 repo stars
- Updated July 13, 2026
- aaron-he-zhu/seo-geo-claude-skills
Performance Reporter aggregates SEO/GEO data into stakeholder performance reports and dashboards spanning traffic, rankings, authority, and content progress with period-over-period deltas.
About
Performance Reporter (v9.9.10) is a Claude Code SEO/GEO skill that aggregates traffic, rankings, authority, backlinks, and content progress into stakeholder reports and dashboards. Invoke it when users ask to generate an SEO report, monthly or weekly traffic summaries, GEO visibility reports, content performance reports, or boss-facing 汇报 updates. It is not for raw ranking deltas; defer position-by-position tracking to rank-tracker. The skill contract reads current and prior-period metrics, writes a monitoring deliverable plus a handoff summary for memory/monitoring/, and promotes anomalies to memory/open-loops.md. Eleven sections cover executive summary, organic traffic, keyword rankings overview, GEO and AI citations, CITE authority, CORE-EEAT content quality, backlinks, content performance, prioritized recommendations, and appendix sources. Every metric is labeled Measured, User-provided, or Estimated; missing inputs become Not yet evaluated rather than fabricated. Decision gates stop only when no comparison period exists, offering last 30 vs prior 30, monthly, or custom ranges. Without connected tools, request analytics exports, Search Console data, rankings, and KPIs from the.
- Builds multi-metric SEO and GEO stakeholder reports across traffic, rankings, authority, backlinks, and content.
- Labels each metric Measured, User-provided, or Estimated; missing sections read Not yet evaluated.
- Requires a comparison period and defaults to executive templates when audience is unstated.
- Eleven sections include executive summary, GEO/AI citations, CITE authority, CORE-EEAT, and prioritized actions with own
- Defers raw position-by-position ranking deltas to rank-tracker; follow recurring monitoring with alert-manager.
Performance Reporter by the numbers
- 4,805 all-time installs (skills.sh)
- +5 installs in the week ending Jul 28, 2026 (Skillselion tracking)
- Ranked #145 of 1,881 Marketing & SEO skills by installs in the Skillselion catalog
- Security screen: LOW risk (skills.sh audit)
- Data as of Jul 28, 2026 (Skillselion catalog sync)
performance-reporter capabilities & compatibility
- Capabilities
- define report parameters, audience, and comparis · compile executive summaries with wins, watch are · report organic traffic, rankings distribution, a · summarize geo and ai citation performance · include cite authority and core eeat content sco · generate immediate, short term, and long term pr
- Use cases
- seo · data analysis · marketing
- Runs
- Runs locally
- Pricing
- Free
What performance-reporter says it does
Aggregates SEO/GEO data, builds stakeholder reports, benchmarks goals/competitors, calculates ROI, and turns deltas into prioritized recommendations.
Use when generating multi-metric SEO/GEO performance reports, traffic summaries, stakeholder dashboards, SEO报告, 流量报告, 月报, 周报, or 汇报给老板.
Label every metric **Measured** (tool/export), **User-provided**, or **Estimated** (model inference); never present an estimate as measured
npx skills add https://github.com/aaron-he-zhu/seo-geo-claude-skills --skill performance-reporterAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 4.8k |
|---|---|
| repo stars | ★ 115 |
| Security audit | 3 / 3 scanners passed |
| Last updated | July 13, 2026 |
| Repository | aaron-he-zhu/seo-geo-claude-skills ↗ |
What it does
Generate multi-metric SEO and GEO performance reports with period comparisons for executives, clients, or monthly stakeholder updates.
Who is it for?
Monthly or weekly SEO reports, traffic summaries, GEO visibility reports, content performance reviews, and reporting to executives or clients.
Skip if: Raw ranking position deltas or deep SERP-by-SERP tracking; use rank-tracker instead.
When should I use this skill?
User asks to generate an SEO performance report, traffic report, SEO dashboard, monthly SEO report, show SEO results, report to my boss, or 出月报.
What you get
A compiled report with executive summary, sectioned KPIs, labeled data provenance, prioritized recommendations, and an optional memory/monitoring/ handoff summary.
- SEO/GEO KPI report
- Source-cited metric tables
By the numbers
- Skill version 9.9.10 documented in frontmatter.
- Eleven numbered report sections defined in instructions.
Files
Performance Reporter
Aggregates SEO/GEO data, builds stakeholder reports, benchmarks goals/competitors, calculates ROI, and turns deltas into prioritized recommendations.
Quick Start
Create an SEO performance report for [domain] for [time period]
Generate an executive summary of SEO performance for [month/quarter]
Create a GEO visibility report for [domain]
Generate a content performance reportSkill Contract
Expected output: a delta summary, alert/report output, and a short handoff summary ready for memory/monitoring/.
- Reads: current and prior-period metrics across traffic/rankings/authority/content, report audience, date range, and any user-provided or tool data.
- Writes: a user-facing monitoring deliverable plus a reusable summary that can be stored under
memory/monitoring/. - Promotes: significant changes, confirmed anomalies, follow-up actions, and pending decisions to
memory/open-loops.md. - Done when: each in-scope section (traffic, rankings, GEO, authority, backlinks, content) is present or marked "Not yet evaluated"; every metric is source-tagged and compared to the prior period; and recommendations carry owner, priority, and expected impact.
- Primary next skill: use the
Next Best Skillbelow when a change needs action.
Handoff Summary
Emit the standard shape from skill-contract.md §Handoff Summary Format.
Data Sources
All integrations optional (see CONNECTORS.md). With tools connected, aggregates traffic from ~~analytics, search data from ~~search console, rankings/backlinks from ~~SEO tool, and AI visibility from ~~AI monitor. Without tools, ask user for analytics exports, Search Console data, ranking data, and KPIs.
Decision Gates
Stop and ask the user when:
- No reporting period or comparison period can be determined and none is in context — offer: (1) last 30 days vs prior 30, (2) last calendar month vs prior month, (3) a custom range. A period comparison is required, not optional.
Continue silently (never stop for):
- A section's source data is missing — mark that section "Not yet evaluated" and proceed; do not fabricate the metric.
- Audience not stated — default to the executive template and note the assumption.
Instructions
When a user requests a performance report, use Report Output Templates and cover:
1. Define Report Parameters — Domain, period, comparison period, report type, audience, focus areas, and data freshness. 2. Create Executive Summary — Overall rating, wins, watch areas, required actions, metrics at a glance (traffic, rankings, conversions, DA/authority, AI citations), and SEO ROI; tag each metric Measured / User-provided / Estimated. 3. Report Organic Traffic — Sessions, users, pageviews, engagement/bounce, trend visualization, source/device split, top pages, each figure source-tagged. 4. Report Keyword Rankings — Position ranges, distribution change, top improvements/declines, SERP features. For raw position-by-position deltas, defer to rank-tracker rather than recomputing here. 5. Report GEO/AI Performance — AI citation overview, citations by topic, GEO wins, and optimization opportunities. 6. Report Domain Authority (CITE) — Include CITE dimension scores and veto status when available; otherwise mark "Not yet evaluated." 7. Report Content Quality (CORE-EEAT) — Include average scores and trends when available; otherwise mark "Not yet evaluated." 8. Report Backlinks — Link profile summary, acquisition trend, notable links, competitive position. 9. Report Content Performance — Publishing summary, top content, content needing attention, and content ROI. 10. Generate Recommendations — Immediate, short-term, and long-term actions with priority, owner, expected impact, and next-period goals. 11. Compile Full Report — Add table of contents, appendix, data sources, methodology, and glossary.
Label every metric Measured (tool/export), User-provided, or Estimated (model inference); never present an estimate as measured; if a required metric is unavailable, mark it N/A — do not invent it. Likewise separate an observed change from a plausible explanation (corroborate before stating it as the cause), an optimization opportunity, and follow-up needing crawl/SERP/rank/audit — never report an unverified explanation as a confirmed cause.
Example
Sample output: an executive summary with overall status, metrics-at-a-glance for traffic/rankings/conversions/authority/AI citations, SEO ROI, and immediate/month/quarter actions with owners and dates.
Tips for Success
Lead with insights, compare periods, state data freshness, include owner/deadline/impact for actions, tailor depth to audience, and track GEO/AI citation metrics when in scope.
Save Results
Ask "Save these results?" If yes, write to memory/monitoring/ — see Skill Contract §Save Results Template.
Reference Materials
- Report Output Templates — Compact starter blocks for all 11 report sections
- KPI Definitions — SEO/GEO metric definitions with benchmarks, thresholds, trend analysis, and attribution guidance
- Report Templates by Audience — Copy-ready templates for executive, marketing, technical, and client audiences
Next Best Skill
Recurring monitoring needed → alert-manager — turn reporting insights into ongoing monitoring rules. One-off report → Terminal. Visited-set rule applies per Skill Contract.
SEO/GEO KPI Definitions
Use these definitions when building recurring performance reports. Always show source, date range, comparison period, and whether the metric is brand, non-brand, or blended.
KPI Matrix
| Category | KPI | Formula / source | Good | Warning / action trigger |
|---|---|---|---|---|
| Organic search | Organic sessions | Count sessions where medium = organic; analytics platform | Growing MoM; 3-10% MoM is healthy | Decline >10% MoM without seasonal cause; split brand vs non-brand |
| Organic search | Organic CTR | Organic clicks / impressions x 100; Search Console | >3% overall | <1.5% or declining; stable position + low CTR means title/meta issue |
| Organic search | Average position | Sum of positions / keyword count; Search Console or SEO tool | <20 for tracked keywords; improving | >30 or worsening; pair with top 10/top 20 distribution |
| Organic search | Keyword visibility | Sum of estimated CTR at position x monthly volume | Growing | Declining 3+ consecutive weeks |
| Organic search | Pages indexed | Valid indexed pages in Search Console | Close to intended indexable pages | Drop without intent; submitted/indexed gap; indexed > intended |
| Organic search | Organic CVR | Organic conversions / organic sessions x 100 | >2% lead gen; >1% e-commerce | <0.5% or declining while traffic grows |
| Organic search | Non-brand share | Non-brand organic sessions / total organic sessions x 100 | >50% | <30%, indicating brand dependency |
| GEO / AI | AI citation rate | Cited queries / monitored AI-answer queries x 100 | >20% | <5% or declining |
| GEO / AI | AI citation position | Sum citation positions / citation count | Top 3 average | Not cited or consistently 5+ |
| GEO / AI | AI answer coverage | Topics with AI answers / target topics x 100 | Growing | Declining coverage |
| GEO / AI | Brand mention in AI | AI responses containing brand name | Growing for authority topics | Zero mentions on priority topics |
| Authority | Domain Rating / Authority | Tool-specific 0-100 logarithmic link score | Growing and competitive | Flat while competitors grow |
| Authority | Referring domains | Distinct root domains linking | Growing MoM | Net loss for 2+ months |
| Authority | Backlink growth rate | New backlinks - lost backlinks | Positive and steady | Negative 2+ months or spam-like spike |
| Authority | Toxic link ratio | Toxic backlinks / total backlinks x 100 | <5% | 5-10% warning; >10% critical, review before disavow |
| Technical | Crawl budget utilization | Useful pages crawled / total pages crawled x 100 | >80% useful/indexable | High crawl of non-indexable or low-value pages |
| Technical | Index coverage rate | Indexed pages / submitted pages x 100 | >90% for curated sitemap | <80% or declining |
| Content | Content efficiency | Organic sessions per piece / cost per piece | Improving | Flat or declining after refresh window |
| Content | Content decay rate | Pages with >20% traffic decline over 6 months / pages with traffic | <20% | >30% |
| Business | Organic revenue/session | Organic revenue / organic sessions | Stable or growing | Declining while traffic grows |
| Competitive | Share of voice | Your visibility / total competitor visibility x 100 | Growing in core topics | Declining 3+ consecutive months |
| Competitive | Keyword overlap | Shared top-20 keywords / your tracked keywords x 100 | Expected for direct competitors | New high-overlap competitor = emerging threat |
| ROI | SEO ROI | (Organic revenue - SEO investment) / investment x 100 | >200% annually | <100% after 12+ months |
| ROI | Organic traffic value | Sum monthly organic clicks x CPC | Growing; exceeds SEO investment | Value compression or shrinking gap vs spend |
Benchmarks
CTR by Position
| Position | Typical CTR |
|---|---|
| #1 | 25-35% |
| #2 | 12-18% |
| #3 | 8-13% |
| #4-5 | 4-8% |
| #6-10 | 2-5% |
| #11-20 | 0.5-2% |
Organic Conversion Rate by Industry
| Industry | Typical range |
|---|---|
| SaaS | 2-5% |
| E-commerce | 1-3% |
| Finance | 3-6% |
| Healthcare | 2-4% |
| B2B services | 2-5% |
| Media | 0.5-2% |
Domain Authority Maturity
| Stage | Typical range |
|---|---|
| New, 0-6 months | 0-15 |
| Early growth, 6-18 months | 15-30 |
| Established, 18-36 months | 25-50 |
| Mature, 3+ years | 40-70+ |
| Industry leader | 70-90+ |
Core Web Vitals
| Metric | Good | Needs improvement | Poor |
|---|---|---|---|
| LCP | <=2.5s | 2.5-4.0s | >4.0s |
| CLS | <=0.1 | 0.1-0.25 | >0.25 |
| INP | <=200ms | 200-500ms | >500ms |
Summary Tables
| Organic metric | Good | Warning | Source |
|---|---|---|---|
| Organic sessions | Growing MoM | >10% decline | Analytics |
| Keyword visibility | >60% in top 100 | <40% | SEO tool |
| Average position | <20 | >30 | Search Console |
| Organic CTR | >3% | <1.5% | Search Console |
| Pages indexed | Near intended indexable set | Dropping/gap | Search Console |
| Organic CVR | >2% lead gen | <0.5% | Analytics |
| Non-brand share | >50% | <30% | Analytics |
| GEO metric | Good | Warning | Source |
|---|---|---|---|
| AI citation rate | >20% | <5% | AI monitor |
| AI citation position | Top 3 | Not cited / 5+ | AI monitor |
| AI answer coverage | Growing | Declining | AI monitor |
| Brand mention in AI | Growing | Zero | AI monitor |
Trend Interpretation
| Pattern | Likely cause | Action |
|---|---|---|
| Steady growth | Strategy working | Continue; optimize high performers |
| Sudden spike then drop | Viral content or algorithm volatility | Investigate source; replicate only if durable |
| Gradual decline | Content decay, competition, technical debt | Run content + technical audit |
| Flat line | Plateau | Expand topics, links, or formats |
| Seasonal pattern | Demand cycle | Compare YoY and plan calendar around peaks |
Period Comparison Guide
| Comparison | Best for | Limitation |
|---|---|---|
| WoW | Sudden changes | Noisy; weekday effects |
| MoM | Operating trends | Seasonal bias |
| YoY | Seasonality control | Can hide recent trajectory |
| Rolling 30-day | Noise smoothing | Lags real changes |
Interpretation Notes
- Segment brand vs non-brand before drawing SEO conclusions.
- Pair position with CTR and SERP-feature context; AI Overview/PAA can steal clicks.
- Treat average position as directional, not a standalone success metric.
- Measure ROI over 12+ months because SEO compounds.
- Document every benchmark source and date in the report.
Performance Report Output Templates
Use one reporting shape: metric table -> what changed -> why it matters -> next action.
Shared Conventions
| Item | Rule |
|---|---|
| Status | On track, Watch, Off track, or N/A |
| Delta | Show absolute and percentage change when possible |
| Audience | Executive = trends + actions; Technical = causes + owners |
| Missing inputs | Mark Not yet evaluated and point to the next-best skill |
Report Configuration
Domain, period, comparison, data freshness, report type, Audience, focus, source/date for each imported data set.
Executive Summary
# SEO & GEO Performance Report
**Domain**: [domain] | **Period**: [date range] | **Prepared**: [date]
**Overall performance**: [Excellent/Good/Needs Attention/Critical]
| Metric | Current | Previous | Change | Target | Status |
|--------|---------|----------|--------|--------|--------|
| Organic Traffic | [X] | [Y] | [+/-Z%] | [T] | [status] |
| Keywords Top 10 | [X] | [Y] | [+/-Z] | [T] | [status] |
| Organic Conversions | [X] | [Y] | [+/-Z%] | [T] | [status] |
| Domain Authority / CITE | [X] | [Y] | [+/-Z] | [T] | [status] |
| AI Citations | [X] | [Y] | [+/-Z%] | [T] | [status] |
Wins: [bullets] | Watch areas: [bullets] | Action required: [bullets]Section Templates
| Section | Required fields |
|---|---|
| Organic Traffic | sessions, users, pageviews, bounce rate, top pages, device split, why it moved, next action |
| Keyword Rankings | position buckets, top improvements, declines, SERP features, traffic impact |
| GEO / AI Visibility | queries with AI answer, your citations, citation rate, wins, gaps |
| Domain Authority (CITE Score) | CITE score, C/I/T/E dimensions, veto status, Not yet evaluated fallback |
| Content Quality (CORE-EEAT) | pages audited, average CORE-EEAT/GEO/SEO, veto IDs, dimension trends |
| Backlinks | total backlinks, referring domains, average authority, notable links, toxic risk |
| Content Performance | new articles, updates, top performers, declining pages, refresh actions |
| Recommendations | horizon, priority, action, expected impact, owner |
Full Report Skeleton
# [Company] SEO & GEO Performance Report - [Month/Quarter] [Year]
## Executive Summary
## Organic Traffic
## Keyword Rankings
## GEO / AI Visibility
## Domain Authority (CITE Score)
## Content Quality (CORE-EEAT)
## Backlinks
## Content Performance
## Recommendations & Next Steps
## Appendix: data sources, methodology, missing inputsSEO/GEO Report Templates
Copy-ready report skeletons for executive, marketing, technical, and client audiences. Use placeholders, not sample numbers, unless user data is available.
1. Executive Report
For C-suite/VP reporting. Keep to 1 page and lead with business impact.
# SEO & GEO Performance Summary
**Period**: [Month Year] | **Audience**: [Audience] | **Prepared by**: [Name]
## Performance At A Glance
| KPI | Current | Prior | MoM/QoQ | YoY | Target | Status |
|-----|---------|-------|---------|-----|--------|--------|
| Organic revenue | [$] | [$] | [%] | [%] | [$] | [status] |
| Organic sessions | [X] | [X] | [%] | [%] | [X] | [status] |
| Keywords in Top 10 | [X] | [X] | [+/-X] | [+/-X] | [X] | [status] |
| Organic conversions | [X] | [X] | [%] | [%] | [X] | [status] |
| Domain Rating / Authority | [X] | [X] | [+/-X] | [+/-X] | [X] | [status] |
| AI citations | [X] | [X] | [%] | N/A | [X] | [status] |
## Competitive Position
**Share of voice**: [rank] of [N] tracked competitors ([change]).
| Rank | Competitor | Visibility Share | Change |
|------|------------|------------------|--------|
| [1] | [domain] | [%] | [+/-] |
## Wins, Risks, And Ask
- Wins: [business win], [SEO/GEO win], [authority/content win]
- Risks: [risk + mitigation/owner], [risk + mitigation/owner]
- Investment / ROI: [spend] -> [organic revenue/value] -> [ROI]
- Ask for next period: [decision/budget/resource] by [date]2. Marketing Report
For marketing managers, content teams, and channel leads.
# Monthly SEO & GEO Performance Report
**Domain**: [domain] | **Period**: [date range] | **Comparison**: [prior period + prior year]
| Area | Metric | Current | Prior | Change | YoY | Action |
|------|--------|---------|-------|--------|-----|--------|
| Traffic | Organic sessions / users | [X] | [X] | [%] | [%] | [action] |
| Engagement | Bounce or engagement rate / duration | [value] | [value] | [change] | [change] | [action] |
| Rankings | #1 / Top 3 / Top 10 / 11-50 | [counts] | [counts] | [+/-] | [+/-] | [action] |
| Content | Top pages / conversions | [values] | [values] | [change] | [change] | [action] |
| GEO | AI Overview queries / citations / citation rate | [values] | [values] | [change] | N/A | [action] |
| Authority | Referring domains / new links / avg new DR | [values] | [values] | [change] | [change] | [action] |
## Keyword Movers
| Keyword | Volume | Old -> New | Change | Action |
|---------|--------|------------|--------|--------|
| [keyword] | [X] | [X -> Y] | [+/-] | [action] |
## Action Items
| Priority | Action | Owner | Deadline | Expected Impact |
|----------|--------|-------|----------|-----------------|
| P0/P1/P2 | [action] | [owner] | [date] | [impact] |3. Technical Report
For engineering teams and technical stakeholders. Add business impact only for prioritization.
# Technical SEO Health Report
**Domain**: [domain] | **Period**: [date range] | **Data freshness**: [timestamp]
| Area | Metric | Current | Prior | Change | Status | Action |
|------|--------|---------|-------|--------|--------|--------|
| Crawl | Pages crawled / avg response time | [values] | [values] | [change] | [status] | [action] |
| Indexation | Valid indexed / excluded errors | [values] | [values] | [change] | [status] | [action] |
| CWV | LCP / CLS / INP | [values] | [values] | [change] | [status] | [action] |
| Errors | 404 / 5xx / redirect chains | [counts] | [counts] | [change] | [status] | [action] |
| Schema | Valid / warning / error pages | [counts] | [counts] | [change] | [status] | [action] |
## Technical Debt Tracker
| Item | Priority | Effort | Owner | Deadline | Status |
|------|----------|--------|-------|----------|--------|
| [issue] | P0/P1/P2 | L/M/H | [owner] | [date] | [status] |4. Assembly Rules
| Audience | Include | Exclude |
|---|---|---|
| CEO / Board | Executive summary, KPI status, ROI, risks, asks | Technical debugging detail |
| VP Marketing | Executive + marketing sections | Deep crawl/schema logs |
| Marketing Manager | Full marketing report | Engineering-only detail |
| Engineering Lead | Technical report + P0/P1 context | Keyword/revenue overload |
| Client / Agency | Executive + marketing + actions | Internal cost data |
Data Freshness Requirements
| Report Type | Maximum Data Age |
|---|---|
| Executive monthly | 3 days after period end |
| Marketing weekly | 1 day after period end |
| Technical | Real-time where possible |
| Quarterly review | 5 days after quarter end |
Delivery Checklist
- [ ] All data sources verified and dated
- [ ] Period-over-period comparisons included
- [ ] Authority metric included when reporting performance at a glance
- [ ] AI citation / GEO metric included when in scope
- [ ] Action items are specific, assigned, and time-bound
- [ ] Report tailored to audience level
- [ ] External benchmarks cited with source and date
Related skills
Seo AuditRun structured SEO audits on their SaaS site or content hub and receive a prioritized action plan.167k41.1kCopywritingGenerate, rewrite, or strengthen persuasive website and landing-page copy that converts visitors into users.158k41.1k
Viral Short FormQuickly generate high-retention hooks, scripts, and outlines for TikTok, Reels, YouTube Shorts, and carousels.132k64Viral HooksWrite and critique viral hooks for short-form video opening sequences.123k64Viral Captions And CtasOptimize social media captions and CTAs for viral short-form video reach and saves.123k64Viral Youtube ShortsWrite and diagnose YouTube Shorts for Shorts Feed and long-form funnel.123k64How it compares
Use performance-reporter for standardized recurring KPI reports; use content-refresher when traffic decline signals require page-level refresh actions.
FAQ
What does Performance Reporter output?
A delta summary, alert/report output, and a short handoff summary ready for memory/monitoring/, with sections for traffic, rankings, GEO, authority, backlinks, content, and prioritized recommendations.
When should I use rank-tracker instead?
Use rank-tracker for raw ranking deltas and position-by-position SERP tracking; Performance Reporter summarizes distributions and trends, not granular rank recomputation.
What happens if a data source is missing?
Mark that section Not yet evaluated and proceed; never fabricate metrics. Label available figures Measured, User-provided, or Estimated and keep estimates separate from measured values.
Is Performance Reporter safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.