feat: enhance SurfSense with new skills, blog section, and improve SEO metadata

- Added multiple new skills to skills-lock.json from the repository `aaron-he-zhu/seo-geo-claude-skills`. - Introduced `fuzzy-search` dependency in package.json for improved search functionality. - Updated pnpm-lock.yaml to include the new `fuzzy-search` package. - Enhanced SEO metadata across various pages, including canonical links and descriptions for better search visibility. - Improved layout and structure of several components, including the homepage and changelog, to enhance user experience.
2026-04-29 02:46:25 +02:00 · 2026-04-11 23:38:12 -07:00 · 2026-04-11 23:38:12 -07:00 · 7ea840dbb2
commit 7ea840dbb2
parent 61b3f0d7e3
120 changed files with 25729 additions and 352 deletions
--- a/.cursor/skills/performance-reporter/SKILL.md
+++ b/.cursor/skills/performance-reporter/SKILL.md
@ -0,0 +1,263 @@
+---
+name: performance-reporter
+description: 'Generate SEO/GEO dashboards: rankings, traffic, backlinks, AI visibility for stakeholders. SEO报告/绩效仪表盘'
+version: "6.0.0"
+license: Apache-2.0
+compatibility: "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."
+homepage: "https://github.com/aaron-he-zhu/seo-geo-claude-skills"
+when_to_use: "Use when generating SEO performance reports, traffic summaries, ranking reports, or stakeholder-facing dashboards."
+argument-hint: "<domain> [date range]"
+metadata:
+  author: aaron-he-zhu
+  version: "6.0.0"
+  geo-relevance: "medium"
+  tags:
+    - seo
+    - geo
+    - seo-reporting
+    - performance-report
+    - kpi-dashboard
+    - traffic-report
+    - monthly-report
+    - stakeholder-report
+    - SEO报告
+    - SEOレポート
+    - SEO리포트
+    - informe-seo
+  triggers:
+    # EN-formal
+    - "generate SEO report"
+    - "performance report"
+    - "traffic report"
+    - "SEO dashboard"
+    - "SEO analytics"
+    - "monthly report"
+    # EN-casual
+    - "report to stakeholders"
+    - "monthly SEO report"
+    - "show me my SEO results"
+    - "present SEO results to my boss"
+    - "report to my boss"
+    - "monthly SEO summary"
+    # EN-question
+    - "how are my SEO metrics"
+    - "how is my SEO performing"
+    # ZH-pro
+    - "SEO报告"
+    - "绩效仪表盘"
+    - "流量报告"
+    - "数据看板"
+    # ZH-casual
+    - "出SEO报告"
+    - "汇报给老板"
+    - "看看数据"
+    - "月报"
+    - "出月报"
+    - "周报"
+    # JA
+    - "SEOレポート"
+    - "パフォーマンスレポート"
+    # KO
+    - "SEO 리포트"
+    - "성과 보고서"
+    # ES
+    - "informe SEO"
+    - "reporte de rendimiento"
+    # PT
+    - "relatório SEO"
+    # Misspellings
+    - "SEO repoort"
+---
+
+# Performance Reporter
+
+
+> **[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)
+> **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).
+
+
+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
+
+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. **Content Quality Tracking**: Integrates CORE-EEAT scores across audited pages
+7. **ROI Calculation**: Measures SEO investment returns
+8. **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](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/references/skill-contract.md).
+
+### 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](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.
+- **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](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/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** -- Domain, report period, comparison period, report type (Monthly/Quarterly/Annual), audience (Executive/Technical/Client), focus areas.
+
+2. **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.
+
+3. **Report Organic Traffic Performance** -- Traffic overview (sessions, users, pageviews, bounce rate), traffic trend visualization, traffic by source/device, top performing pages.
+
+4. **Report Keyword Rankings** -- Rankings overview by position range, distribution change visualization, top improvements and declines, SERP feature performance.
+
+5. **Report GEO/AI Performance** -- AI citation overview, citations by topic, GEO wins, optimization opportunities.
+
+6. **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."
+
+7. **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."
+
+8. **Report Backlink Performance** -- Link profile summary, weekly link acquisition, notable new links, competitive position.
+
+9. **Report Content Performance** -- Publishing summary, top performing content, content needing attention, content ROI.
+
+10. **Generate Recommendations** -- Immediate/short-term/long-term actions with priority, expected impact, and owner. Goals for next period.
+
+11. **Compile Full Report** -- Combine all sections with table of contents, appendix (data sources, methodology, glossary).
+
+   > **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.
+
+## 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 cloudhosting.com for January 2025"
+
+**Output** (abbreviated -- full report uses templates from all 11 steps):
+
+```markdown
+# 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
+
+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
+
+
+### 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
+
+- [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
+- [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
+- [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
+
+## Next Best Skill
+
+- **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.
--- a/.cursor/skills/performance-reporter/references/kpi-definitions.md
+++ b/.cursor/skills/performance-reporter/references/kpi-definitions.md
@ -0,0 +1,524 @@
+# SEO/GEO KPI Definitions
+
+Complete glossary of SEO and GEO key performance indicators with calculation formulas, data sources, benchmark ranges by industry, and interpretation guidance.
+
+---
+
+## 1. Organic Search KPIs
+
+### Organic Sessions
+
+| Attribute | Detail |
+|-----------|--------|
+| **Definition** | Number of visits to your site originating from organic (unpaid) search engine results |
+| **Formula** | Count of sessions where medium = "organic" |
+| **Data Source** | ~~analytics (Google Analytics, Adobe Analytics, or equivalent) |
+| **Good Range** | Growing month-over-month; 3-10% MoM growth is healthy |
+| **Warning** | Decline >10% MoM without known seasonal cause |
+| **Segmentation** | Always separate brand vs. non-brand organic sessions |
+
+**Interpretation:**
+- Growing organic sessions with stable conversion rate = SEO strategy is working.
+- Growing sessions but declining conversions = traffic quality issue; check keyword targeting.
+- Flat sessions despite new content = content not ranking or cannibalizing existing pages.
+
+---
+
+### Organic Click-Through Rate (CTR)
+
+| Attribute | Detail |
+|-----------|--------|
+| **Definition** | Percentage of search impressions that result in a click to your site |
+| **Formula** | (Organic Clicks / Organic Impressions) x 100 |
+| **Data Source** | ~~search console |
+| **Good Range** | >3% overall; varies significantly by position and query type |
+| **Warning** | <1.5% overall or declining trend |
+| **Segmentation** | By query type (brand vs. non-brand), by page, by position range |
+
+**Benchmarks by Position:**
+
+| Position | Expected CTR Range |
+|----------|-------------------|
+| #1 | 25-35% |
+| #2 | 12-18% |
+| #3 | 8-13% |
+| #4-5 | 4-8% |
+| #6-10 | 2-5% |
+| #11-20 | 0.5-2% |
+
+**Interpretation:**
+- High impressions but low CTR = title tags and meta descriptions need optimization.
+- CTR declining for stable positions = SERP features (AI Overview, PAA) stealing clicks.
+- CTR higher than position benchmarks = strong brand recognition or compelling snippets.
+
+---
+
+### Average Position
+
+| Attribute | Detail |
+|-----------|--------|
+| **Definition** | Mean ranking position across all tracked keywords or queries |
+| **Formula** | Sum of all positions / count of keywords |
+| **Data Source** | ~~search console (query-level), ~~SEO tool (keyword-level) |
+| **Good Range** | <20 for tracked keywords; improving trend |
+| **Warning** | >30 or rising (worsening) trend |
+| **Segmentation** | By keyword group, by page, by intent type |
+
+**Interpretation:**
+- Average position is a directional indicator, not an absolute measure. A few very low-ranking keywords can drag the average down significantly.
+- Always pair with keyword distribution (how many keywords in top 10, top 20, etc.) for a complete picture.
+
+---
+
+### Keyword Visibility Score
+
+| Attribute | Detail |
+|-----------|--------|
+| **Definition** | Weighted score combining keyword positions and search volumes into a single index |
+| **Formula** | Sum of (estimated CTR at position x monthly search volume) for each keyword |
+| **Data Source** | ~~SEO tool |
+| **Good Range** | Growing over time; absolute value depends on niche |
+| **Warning** | Declining trend for 3+ consecutive weeks |
+| **Segmentation** | By topic cluster, by competitor |
+
+**Interpretation:**
+- Visibility score accounts for both ranking position and keyword importance (volume).
+- A single high-volume keyword moving from #1 to #5 can cause a larger visibility drop than 20 low-volume keywords dropping off page 1.
+
+---
+
+### Pages Indexed
+
+| Attribute | Detail |
+|-----------|--------|
+| **Definition** | Number of your pages included in Google's search index |
+| **Formula** | Count of valid indexed pages in Index Coverage report |
+| **Data Source** | ~~search console (Index Coverage / Pages report) |
+| **Good Range** | Indexed count close to total intended indexable pages; growing with new content |
+| **Warning** | Indexed count dropping without intentional removal; large gap between submitted and indexed |
+| **Segmentation** | By sitemap, by content type, by subdirectory |
+
+**Interpretation:**
+- Indexed < submitted = quality or technical issues preventing indexing.
+- Sudden drop in indexed pages = possible noindex tag, robots.txt change, or manual action.
+- Indexed > intended = duplicate content, parameter URLs, or faceted navigation issues.
+
+---
+
+### Organic Conversion Rate
+
+| Attribute | Detail |
+|-----------|--------|
+| **Definition** | Percentage of organic sessions that complete a defined conversion goal |
+| **Formula** | (Organic Conversions / Organic Sessions) x 100 |
+| **Data Source** | ~~analytics |
+| **Good Range** | >2% for lead generation; >1% for e-commerce (varies by industry) |
+| **Warning** | <0.5% or declining while traffic grows |
+| **Segmentation** | By landing page, by keyword intent, by device |
+
+**Industry Benchmarks:**
+
+| Industry | Typical Organic CVR |
+|----------|-------------------|
+| SaaS / Software | 2-5% |
+| E-commerce | 1-3% |
+| Finance | 3-6% |
+| Healthcare | 2-4% |
+| B2B Services | 2-5% |
+| Media / Publishing | 0.5-2% (ad-supported) |
+| Education | 2-5% |
+
+---
+
+### Non-Brand Organic Traffic Share
+
+| Attribute | Detail |
+|-----------|--------|
+| **Definition** | Percentage of organic traffic coming from non-branded search queries |
+| **Formula** | (Organic sessions - brand query sessions) / Organic sessions x 100 |
+| **Data Source** | ~~search console + ~~analytics |
+| **Good Range** | >50% of total organic; growing |
+| **Warning** | <30% (over-reliance on brand awareness, not SEO) |
+| **Segmentation** | Trend over time |
+
+**Interpretation:**
+- High non-brand share = SEO is driving new audience discovery.
+- Low non-brand share = organic traffic is mostly people who already know your brand; SEO is underperforming for acquisition.
+
+---
+
+## 2. GEO / AI Visibility KPIs
+
+### AI Citation Rate
+
+| Attribute | Detail |
+|-----------|--------|
+| **Definition** | Percentage of monitored queries where your content is cited in AI-generated answers |
+| **Formula** | (Queries where you are cited / Total monitored queries with AI answers) x 100 |
+| **Data Source** | ~~AI monitor |
+| **Good Range** | >20% of monitored queries |
+| **Warning** | <5% or declining trend |
+| **Segmentation** | By topic cluster, by content type |
+
+---
+
+### AI Citation Position
+
+| Attribute | Detail |
+|-----------|--------|
+| **Definition** | Your average position among cited sources in AI-generated responses |
+| **Formula** | Sum of citation positions / count of citations |
+| **Data Source** | ~~AI monitor |
+| **Good Range** | Top 3 sources on average |
+| **Warning** | Not cited or consistently cited in position 5+ |
+| **Segmentation** | By query, by topic |
+
+---
+
+### AI Answer Coverage
+
+| Attribute | Detail |
+|-----------|--------|
+| **Definition** | Percentage of your target topics that appear in AI-generated answers |
+| **Formula** | (Topics with AI answers / Total target topics) x 100 |
+| **Data Source** | ~~AI monitor |
+| **Good Range** | Growing over time as AI answers expand |
+| **Warning** | Declining coverage may indicate content quality issues |
+| **Segmentation** | By topic cluster |
+
+---
+
+### Brand Mention in AI Responses
+
+| Attribute | Detail |
+|-----------|--------|
+| **Definition** | Number of times your brand is mentioned in AI-generated responses across monitored queries |
+| **Formula** | Count of AI responses containing your brand name |
+| **Data Source** | ~~AI monitor |
+| **Good Range** | Growing; present in responses for your key topics |
+| **Warning** | Zero mentions for topics where you are an authority |
+| **Segmentation** | By query category |
+
+---
+
+## 3. Domain Authority KPIs
+
+### Domain Rating / Domain Authority
+
+| Attribute | Detail |
+|-----------|--------|
+| **Definition** | Proprietary metric estimating the overall strength of a domain's backlink profile (0-100 scale) |
+| **Formula** | Varies by tool (logarithmic scale based on backlink quantity and quality) |
+| **Data Source** | ~~SEO tool (Ahrefs DR, Moz DA, or equivalent) |
+| **Good Range** | Growing; competitive with top-ranking sites in your niche |
+| **Warning** | Declining or significantly below competitors |
+| **Segmentation** | Compare against competitors |
+
+**Benchmarks by Site Stage:**
+
+| Site Stage | Typical DR/DA |
+|-----------|--------------|
+| Brand 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+ |
+
+---
+
+### Referring Domains
+
+| Attribute | Detail |
+|-----------|--------|
+| **Definition** | Count of unique domains that link to your site |
+| **Formula** | Count of distinct root domains with at least one dofollow or nofollow link |
+| **Data Source** | ~~link database |
+| **Good Range** | Growing MoM; higher than primary competitors |
+| **Warning** | Net loss of referring domains for 2+ consecutive months |
+| **Segmentation** | By authority tier (DR 0-20, 20-40, 40-60, 60+) |
+
+---
+
+### Backlink Growth Rate
+
+| Attribute | Detail |
+|-----------|--------|
+| **Definition** | Net new backlinks acquired per month |
+| **Formula** | New backlinks gained - backlinks lost in the period |
+| **Data Source** | ~~link database |
+| **Good Range** | Positive and steady; proportional to content output |
+| **Warning** | Negative for 2+ months; sudden spikes (may indicate spam) |
+| **Segmentation** | By link quality tier |
+
+---
+
+### Toxic Link Ratio
+
+| Attribute | Detail |
+|-----------|--------|
+| **Definition** | Percentage of your backlinks classified as toxic or spammy |
+| **Formula** | (Toxic backlinks / Total backlinks) x 100 |
+| **Data Source** | ~~link database (toxic score/spam score) |
+| **Good Range** | <5% |
+| **Warning** | 5-10% (monitor and clean up) |
+| **Critical** | >10% (immediate disavow action needed) |
+| **Segmentation** | By toxic type (PBN, spam, irrelevant) |
+
+---
+
+## 4. Technical SEO KPIs
+
+### Core Web Vitals
+
+| Metric | Definition | Good | Needs Improvement | Poor |
+|--------|-----------|------|-------------------|------|
+| **LCP** (Largest Contentful Paint) | Time to render largest content element | <=2.5s | 2.5-4.0s | >4.0s |
+| **CLS** (Cumulative Layout Shift) | Visual stability during page load | <=0.1 | 0.1-0.25 | >0.25 |
+| **INP** (Interaction to Next Paint) | Responsiveness to user interactions | <=200ms | 200-500ms | >500ms |
+
+**Data Source:** ~~search console (Core Web Vitals report), Chrome UX Report, PageSpeed Insights
+
+---
+
+### Crawl Budget Utilization
+
+| Attribute | Detail |
+|-----------|--------|
+| **Definition** | How efficiently search engine crawlers are spending their crawl budget on your site |
+| **Formula** | (Useful pages crawled / Total pages crawled) x 100 |
+| **Data Source** | ~~search console (Crawl Stats), server logs |
+| **Good Range** | >80% of crawled pages are indexable, valuable pages |
+| **Warning** | High crawl of non-indexable or low-value pages |
+| **Segmentation** | By content type, by HTTP status code |
+
+---
+
+### Index Coverage Rate
+
+| Attribute | Detail |
+|-----------|--------|
+| **Definition** | Percentage of submitted pages that are successfully indexed |
+| **Formula** | (Indexed pages / Submitted pages) x 100 |
+| **Data Source** | ~~search console |
+| **Good Range** | >90% for sites with curated sitemaps |
+| **Warning** | <80% or declining |
+| **Segmentation** | By sitemap, by exclusion reason |
+
+---
+
+## 5. Content Performance KPIs
+
+### Content Efficiency Score
+
+| Attribute | Detail |
+|-----------|--------|
+| **Definition** | Ratio of content investment to organic traffic generated |
+| **Formula** | Organic sessions per content piece / cost per content piece |
+| **Data Source** | ~~analytics + internal cost tracking |
+| **Good Range** | Improving over time; varies by content type |
+| **Warning** | Declining efficiency despite continued investment |
+| **Segmentation** | By content type, by topic, by author |
+
+---
+
+### Content Decay Rate
+
+| Attribute | Detail |
+|-----------|--------|
+| **Definition** | Percentage of existing content losing organic traffic over a defined period |
+| **Formula** | (Pages with >20% traffic decline over 6 months / Total pages with traffic) x 100 |
+| **Data Source** | ~~analytics |
+| **Good Range** | <20% of pages decaying per 6-month period |
+| **Warning** | >30% of pages decaying |
+| **Segmentation** | By content age, by topic, by content type |
+
+---
+
+### Organic Revenue Per Session
+
+| Attribute | Detail |
+|-----------|--------|
+| **Definition** | Average revenue generated per organic search session |
+| **Formula** | Total organic revenue / Total organic sessions |
+| **Data Source** | ~~analytics (e-commerce tracking or goal values) |
+| **Good Range** | Stable or growing; varies hugely by industry |
+| **Warning** | Declining while traffic grows (traffic quality deteriorating) |
+| **Segmentation** | By landing page, by keyword intent, by device |
+
+---
+
+## 6. Competitive KPIs
+
+### Share of Voice (SOV)
+
+| Attribute | Detail |
+|-----------|--------|
+| **Definition** | Your visibility as a percentage of total visibility across tracked keywords |
+| **Formula** | (Your visibility score / Sum of all tracked competitors' visibility scores) x 100 |
+| **Data Source** | ~~SEO tool |
+| **Good Range** | Growing; leading in your core topic areas |
+| **Warning** | Declining for 3+ consecutive months |
+| **Segmentation** | By topic cluster, by competitor |
+
+---
+
+### Competitive Keyword Overlap
+
+| Attribute | Detail |
+|-----------|--------|
+| **Definition** | Percentage of your tracked keywords where a specific competitor also ranks in the top 20 |
+| **Formula** | (Keywords where both rank in top 20 / Your total tracked keywords) x 100 |
+| **Data Source** | ~~SEO tool |
+| **Good Range** | Context-dependent; high overlap for direct competitors is expected |
+| **Warning** | New competitor appearing with high overlap indicates emerging threat |
+| **Segmentation** | By competitor, by keyword group |
+
+---
+
+## 7. ROI and Business Impact KPIs
+
+### SEO ROI
+
+| Attribute | Detail |
+|-----------|--------|
+| **Definition** | Return on investment from SEO activities |
+| **Formula** | ((Organic Revenue - SEO Investment) / SEO Investment) x 100 |
+| **Data Source** | ~~analytics + internal cost tracking |
+| **Good Range** | >200% annually (SEO compounds over time) |
+| **Warning** | <100% after 12+ months of investment |
+| **Segmentation** | By content type, by campaign |
+
+**Note:** SEO ROI should be measured over 12+ month horizons. Short-term ROI calculations are misleading because SEO benefits compound over time.
+
+---
+
+### Organic Traffic Value
+
+| Attribute | Detail |
+|-----------|--------|
+| **Definition** | Estimated cost to acquire equivalent traffic through paid search |
+| **Formula** | Sum of (monthly organic clicks per keyword x CPC for that keyword) |
+| **Data Source** | ~~SEO tool (traffic value calculation) |
+| **Good Range** | Growing; significantly higher than SEO investment |
+| **Warning** | Declining traffic value despite stable traffic (keywords losing CPC value) |
+| **Segmentation** | By keyword group, by page |
+
+**Interpretation:**
+- Organic traffic value represents how much you would need to spend on PPC to get the same traffic.
+- Useful for communicating SEO value to stakeholders who understand paid media budgets.
+- A site with $50K/month organic traffic value that spends $10K/month on SEO is getting a 5:1 return.
+
+---
+
+## 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 |
+
--- a/.cursor/skills/performance-reporter/references/report-output-templates.md
+++ b/.cursor/skills/performance-reporter/references/report-output-templates.md
@ -0,0 +1,417 @@
+# Performance Report Output Templates
+
+Detailed output templates for each step of the performance reporting workflow. Use these templates when generating reports for stakeholders.
+
+---
+
+## 1. Report Configuration Template
+
+```markdown
+## 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. Executive Summary Template
+
+```markdown
+# 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] | [status] |
+| Keyword Rankings (Top 10) | [X] | [Y] | [+/-Z] | [T] | [status] |
+| Organic Conversions | [X] | [Y] | [+/-Z%] | [T] | [status] |
+| Domain Authority | [X] | [Y] | [+/-Z] | [T] | [status] |
+| AI Citations | [X] | [Y] | [+/-Z%] | [T] | [status] |
+
+### SEO ROI
+
+**Investment**: $[X] (content, tools, effort)
+**Organic Revenue**: $[Y]
+**ROI**: [Z]%
+```
+
+---
+
+## 3. Organic Traffic Analysis Template
+
+```markdown
+## Organic Traffic Analysis
+
+### Traffic Overview
+
+| 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] |
+
+### Traffic Trend
+
+```
+[Month 1]  ████████████████████ [X]
+[Month 2]  █████████████████████ [Y]
+[Month 3]  ███████████████████████ [Z]
+[Current]  ████████████████████████ [W]
+```
+
+### Traffic by Source
+
+| Channel | Sessions | % of Total | Change |
+|---------|----------|------------|--------|
+| Organic Search | [X] | [Y]% | [+/-Z%] |
+| Direct | [X] | [Y]% | [+/-Z%] |
+| Referral | [X] | [Y]% | [+/-Z%] |
+| Social | [X] | [Y]% | [+/-Z%] |
+
+### Top Performing Pages
+
+| Page | Sessions | Change | Conversions |
+|------|----------|--------|-------------|
+| [Page 1] | [X] | [+/-Y%] | [Z] |
+| [Page 2] | [X] | [+/-Y%] | [Z] |
+| [Page 3] | [X] | [+/-Y%] | [Z] |
+
+### Traffic by Device
+
+| Device | Sessions | Change | Conv. Rate |
+|--------|----------|--------|------------|
+| Desktop | [X] ([Y]%) | [+/-Z%] | [%] |
+| Mobile | [X] ([Y]%) | [+/-Z%] | [%] |
+| Tablet | [X] ([Y]%) | [+/-Z%] | [%] |
+```
+
+---
+
+## 4. Keyword Ranking Performance Template
+
+```markdown
+## Keyword Ranking Performance
+
+### Rankings Overview
+
+| Position Range | Keywords | Change | Traffic Impact |
+|----------------|----------|--------|----------------|
+| Position 1 | [X] | [+/-Y] | [Z] sessions |
+| Position 2-3 | [X] | [+/-Y] | [Z] sessions |
+| Position 4-10 | [X] | [+/-Y] | [Z] sessions |
+| Position 11-20 | [X] | [+/-Y] | [Z] sessions |
+| Position 21-50 | [X] | [+/-Y] | [Z] sessions |
+
+### Top Ranking Improvements
+
+| Keyword | Previous | Current | Change | Traffic |
+|---------|----------|---------|--------|---------|
+| [kw 1] | [X] | [Y] | +[Z] | [sessions] |
+
+### Rankings That Declined
+
+| Keyword | Previous | Current | Change | Impact | Action |
+|---------|----------|---------|--------|--------|--------|
+| [kw 1] | [X] | [Y] | -[Z] | -[sessions] | [action] |
+
+### SERP Feature Performance
+
+| Feature | Won | Lost | Opportunities |
+|---------|-----|------|---------------|
+| Featured Snippets | [X] | [Y] | [Z] |
+| People Also Ask | [X] | [Y] | [Z] |
+| Local Pack | [X] | [Y] | [Z] |
+```
+
+---
+
+## 5. GEO/AI Visibility Template
+
+```markdown
+## GEO (AI Visibility) Performance
+
+### AI Citation Overview
+
+| Metric | This Period | Last Period | Change |
+|--------|-------------|-------------|--------|
+| Keywords with AI Overview | [X]/[Y] | [X]/[Y] | [+/-Z] |
+| Your AI Citations | [X] | [Y] | [+/-Z%] |
+| Citation Rate | [X]% | [Y]% | [+/-Z%] |
+| Avg Citation Position | [X] | [Y] | [+/-Z] |
+
+### AI Citation by Topic
+
+| Topic Cluster | Opportunities | Citations | Rate |
+|---------------|---------------|-----------|------|
+| [Topic 1] | [X] | [Y] | [Z]% |
+
+### GEO Wins This Period
+
+| Query | Citation Status | Source Page | Impact |
+|-------|-----------------|-------------|--------|
+| [query 1] | New citation | [page] | High visibility |
+
+### GEO Optimization Opportunities
+
+| Query | AI Overview | You Cited? | Gap | Action |
+|-------|-------------|------------|-----|--------|
+| [query] | Yes | No | [gap] | [action] |
+```
+
+---
+
+## 6. Domain Authority (CITE Score) Template
+
+```markdown
+## Domain Authority (CITE Score)
+
+### CITE Score Summary
+
+| Metric | This Period | Last Period | Change |
+|--------|-------------|-------------|--------|
+| CITE Score | [X]/100 | [Y]/100 | [+/-Z] |
+| C -- Citation | [X]/100 | [Y]/100 | [+/-Z] |
+| I -- Identity | [X]/100 | [Y]/100 | [+/-Z] |
+| T -- Trust | [X]/100 | [Y]/100 | [+/-Z] |
+| E -- Eminence | [X]/100 | [Y]/100 | [+/-Z] |
+
+**Veto Status**: No triggers / [item] triggered
+
+### Key Changes
+
+- [Notable improvement or concern 1]
+- [Notable improvement or concern 2]
+
+_For full 40-item evaluation, run `/seo:audit-domain`_
+```
+
+**Note**: If no previous CITE audit exists, note this section as "Not yet evaluated -- run domain-authority-auditor for baseline" and skip.
+
+---
+
+## 7. Content Quality (CORE-EEAT Score) Template
+
+```markdown
+## Content Quality (CORE-EEAT Score)
+
+### Content Quality Summary
+
+| Metric | Value |
+|--------|-------|
+| Pages Audited | [count] |
+| Average CORE-EEAT Score | [score]/100 ([rating]) |
+| Average GEO Score (CORE) | [score]/100 |
+| Average SEO Score (EEAT) | [score]/100 |
+| Veto Items Triggered | [count] ([item IDs]) |
+
+### Dimension Averages Across Audited Pages
+
+| Dimension | Average Score | Trend |
+|-----------|--------------|-------|
+| C -- Contextual Clarity | [score] | [up/down/stable] |
+| O -- Organization | [score] | [up/down/stable] |
+| R -- Referenceability | [score] | [up/down/stable] |
+| E -- Exclusivity | [score] | [up/down/stable] |
+| Exp -- Experience | [score] | [up/down/stable] |
+| Ept -- Expertise | [score] | [up/down/stable] |
+| A -- Authority | [score] | [up/down/stable] |
+| T -- Trust | [score] | [up/down/stable] |
+
+### Key Content Quality Changes
+
+- [Notable score changes since last report]
+- [Pages with significant quality improvements/declines]
+
+_For full 80-item evaluation, run `/seo:audit-page` on individual pages._
+```
+
+**Note**: If no content quality audit exists, note this section as "Content quality not yet evaluated -- run `/seo:audit-page` on key landing pages to establish baseline" and skip.
+
+---
+
+## 8. Backlink Performance Template
+
+```markdown
+## Backlink Performance
+
+### Link Profile Summary
+
+| Metric | This Period | Last Period | Change |
+|--------|-------------|-------------|--------|
+| Total Backlinks | [X] | [Y] | [+/-Z] |
+| Referring Domains | [X] | [Y] | [+/-Z] |
+| Domain Authority | [X] | [Y] | [+/-Z] |
+| Avg. Link DA | [X] | [Y] | [+/-Z] |
+
+### Link Acquisition
+
+| Period | New Links | Lost Links | Net |
+|--------|-----------|------------|-----|
+| Week 1 | [X] | [Y] | [+/-Z] |
+| Week 2 | [X] | [Y] | [+/-Z] |
+| Week 3 | [X] | [Y] | [+/-Z] |
+| Week 4 | [X] | [Y] | [+/-Z] |
+| **Total** | **[X]** | **[Y]** | **[+/-Z]** |
+
+### Notable New Links
+
+| Source | DA | Type | Value |
+|--------|-----|------|-------|
+| [domain 1] | [DA] | [type] | High |
+
+### Competitive Position
+
+Your referring domains rank #[X] of [Y] competitors.
+```
+
+---
+
+## 9. Content Performance Template
+
+```markdown
+## Content Performance
+
+### Content Publishing Summary
+
+| Metric | This Period | Last Period | Target |
+|--------|-------------|-------------|--------|
+| New articles published | [X] | [Y] | [Z] |
+| Content updates | [X] | [Y] | [Z] |
+| Total word count | [X] | [Y] | - |
+
+### Top Performing Content
+
+| Content | Traffic | Rankings | Conversions | Status |
+|---------|---------|----------|-------------|--------|
+| [Title 1] | [X] | [Y] keywords | [Z] | Top performer |
+| [Title 2] | [X] | [Y] keywords | [Z] | Growing |
+
+### Content Needing Attention
+
+| Content | Issue | Traffic Change | Action |
+|---------|-------|----------------|--------|
+| [Title] | [issue] | -[X]% | [action] |
+
+### Content ROI
+
+| Content Piece | Investment | Traffic Value | ROI |
+|---------------|------------|---------------|-----|
+| [Title 1] | $[X] | $[Y] | [Z]% |
+```
+
+---
+
+## 10. Recommendations Template
+
+```markdown
+## Recommendations & Next Steps
+
+### Immediate Actions (This Week)
+
+| Priority | Action | Expected Impact | Owner |
+|----------|--------|-----------------|-------|
+| High | [Action 1] | [Impact] | [Owner] |
+
+### Short-term (This Month)
+
+| Priority | Action | Expected Impact | Owner |
+|----------|--------|-----------------|-------|
+| Medium | [Action 1] | [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] |
+```
+
+---
+
+## 11. Full Report Compilation Template
+
+```markdown
+# [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]
+```
--- a/.cursor/skills/performance-reporter/references/report-templates.md
+++ b/.cursor/skills/performance-reporter/references/report-templates.md
@ -0,0 +1,383 @@
+# SEO/GEO Report Templates
+
+Copy-ready report templates for executive, marketing, and technical audiences. Each template includes example data to illustrate proper formatting and data presentation.
+
+---
+
+## 1. Executive Report Template
+
+Use this template for C-suite, VP-level, or board reporting. Focuses on business impact, competitive position, and strategic recommendations. Keep to 1 page plus optional appendix.
+
+---
+
+```markdown
+# SEO & GEO Performance Summary
+
+**Period:** January 2025
+**Prepared for:** Leadership Team
+**Prepared by:** [Name], SEO Lead
+
+---
+
+## Performance at a Glance
+
+| KPI | Jan 2025 | Dec 2024 | MoM Change | YoY Change | Target | Status |
+|-----|----------|----------|------------|------------|--------|--------|
+| Organic Revenue | $142,000 | $128,000 | +10.9% | +34% | $130,000 | On track |
+| Organic Sessions | 285,000 | 261,000 | +9.2% | +28% | 270,000 | On track |
+| Keywords in Top 10 | 187 | 172 | +15 | +62 | 180 | On track |
+| AI Citations | 34 | 28 | +21.4% | N/A | 30 | On track |
+| Domain Rating | 52 | 51 | +1 | +8 | 55 | In progress |
+| Organic CVR | 2.8% | 2.6% | +0.2pp | +0.5pp | 2.5% | On track |
+
+## Competitive Position
+
+**Share of Voice Ranking:** #2 of 5 tracked competitors (up from #3 in Q3)
+
+| Rank | Competitor | Visibility Share |
+|------|-----------|-----------------|
+| 1 | CompetitorA.com | 28% |
+| **2** | **YourSite.com** | **24%** |
+| 3 | CompetitorB.com | 21% |
+| 4 | CompetitorC.com | 16% |
+| 5 | CompetitorD.com | 11% |
+
+## Key Wins
+
+1. **Achieved #1 ranking for "project management software"** — estimated $18K/month traffic value
+2. **AI citation rate increased to 34%** — up from 22% in Q3, now cited in AI responses for core product queries
+3. **Published research report generated 45 backlinks** — from sites including TechCrunch (DR 94) and Forbes (DR 95)
+
+## Risks & Mitigation
+
+1. **Google core update expected in February** — monitoring closely; content quality scores above benchmark
+2. **CompetitorA increased content production 2x** — accelerating our editorial calendar in response
+3. **Mobile CWV scores degraded** — engineering team addressing LCP issue, fix scheduled for Feb 15
+
+## Investment & ROI
+
+| Item | Jan Spend | Organic Revenue | Cumulative ROI (12mo) |
+|------|----------|----------------|----------------------|
+| SEO team | $12,000 | $142,000 | 418% |
+| Content production | $8,000 | (included above) | (included above) |
+| Tools & data | $2,500 | (included above) | (included above) |
+| **Total** | **$22,500** | **$142,000** | **418%** |
+
+## Ask for Next Period
+
+- Approve $5,000 budget increase for digital PR campaign targeting Q2 product launch
+- Engineering allocation: 20 hours for Core Web Vitals remediation
+```
+
+---
+
+## 2. Marketing Team Report Template
+
+Use this template for marketing managers, content teams, and channel leads. Provides detailed performance data with actionable insights.
+
+---
+
+```markdown
+# Monthly SEO & GEO Performance Report
+
+**Domain:** yoursite.com
+**Period:** January 1-31, 2025
+**Comparison:** vs. December 2024 and January 2024
+**Prepared:** February 3, 2025
+
+---
+
+## 1. Traffic Performance
+
+### Overview
+
+| Metric | Jan 2025 | Dec 2024 | MoM | Jan 2024 | YoY |
+|--------|----------|----------|-----|----------|-----|
+| Organic Sessions | 285,000 | 261,000 | +9.2% | 223,000 | +27.8% |
+| Organic Users | 198,000 | 182,000 | +8.8% | 158,000 | +25.3% |
+| Organic Pageviews | 412,000 | 378,000 | +9.0% | 318,000 | +29.6% |
+| Bounce Rate | 42% | 44% | -2pp | 48% | -6pp |
+| Avg Session Duration | 3:12 | 3:05 | +3.8% | 2:48 | +14.3% |
+| Pages/Session | 2.4 | 2.3 | +4.3% | 2.1 | +14.3% |
+
+### Traffic by Device
+
+| Device | Sessions | % of Total | MoM Change | CVR |
+|--------|----------|------------|------------|-----|
+| Desktop | 142,500 (50%) | 50% | +7.1% | 3.2% |
+| Mobile | 131,100 (46%) | 46% | +11.5% | 2.1% |
+| Tablet | 11,400 (4%) | 4% | +5.6% | 2.8% |
+
+### Non-Brand vs. Brand Split
+
+| Segment | Sessions | % of Organic | MoM Change |
+|---------|----------|-------------|------------|
+| Non-brand | 184,000 | 64.6% | +12.1% |
+| Brand | 101,000 | 35.4% | +4.1% |
+
+**Insight:** Non-brand growth outpacing brand growth indicates SEO is driving new audience discovery effectively.
+
+## 2. Keyword Rankings
+
+### Position Distribution
+
+| Range | Jan 2025 | Dec 2024 | Change |
+|-------|----------|----------|--------|
+| Position #1 | 23 | 19 | +4 |
+| Position #2-3 | 41 | 38 | +3 |
+| Position #4-10 | 123 | 115 | +8 |
+| Position #11-20 | 89 | 94 | -5 |
+| Position #21-50 | 156 | 162 | -6 |
+| Not ranking | 68 | 72 | -4 |
+| **Total tracked** | **500** | **500** | — |
+
+### Top 5 Ranking Improvements
+
+| Keyword | Volume | Old Rank | New Rank | Change | Est. Traffic |
+|---------|--------|----------|----------|--------|-------------|
+| project management software | 18,100 | 4 | 1 | +3 | +4,200/mo |
+| best CRM for small business | 8,200 | 12 | 6 | +6 | +380/mo |
+| team collaboration tools | 6,500 | 8 | 3 | +5 | +420/mo |
+| agile methodology guide | 4,400 | 22 | 9 | +13 | +180/mo |
+| remote work software | 5,100 | 15 | 7 | +8 | +210/mo |
+
+### Top 5 Ranking Declines
+
+| Keyword | Volume | Old Rank | New Rank | Change | Action |
+|---------|--------|----------|----------|--------|--------|
+| kanban board software | 3,600 | 5 | 11 | -6 | Content refresh scheduled Feb 10 |
+| project planning template | 2,900 | 7 | 14 | -7 | Competitor published superior template |
+| time tracking tools | 4,100 | 9 | 15 | -6 | New SERP features displacing organic |
+| workflow automation | 3,200 | 6 | 9 | -3 | Monitoring, within normal fluctuation |
+| sprint planning guide | 1,800 | 3 | 8 | -5 | Content update needed with 2025 examples |
+
+## 3. Content Performance
+
+### Top Performing Content (by Organic Traffic)
+
+| Page | Sessions | MoM | Rankings | Conversions |
+|------|----------|-----|----------|-------------|
+| /blog/project-management-guide | 18,400 | +22% | 12 KWs top 10 | 184 |
+| /product/features | 15,200 | +8% | 8 KWs top 10 | 456 |
+| /blog/crm-comparison | 12,100 | +15% | 9 KWs top 10 | 121 |
+| /resources/templates | 9,800 | +31% | 6 KWs top 10 | 98 |
+| /blog/remote-work-tips | 8,600 | +5% | 5 KWs top 10 | 43 |
+
+### Content Needing Refresh (Decaying Traffic)
+
+| Page | Sessions | MoM | Age | Action |
+|------|----------|-----|-----|--------|
+| /blog/2023-trends | 2,100 | -35% | 14mo | Rewrite as 2025 trends |
+| /blog/old-tool-comparison | 1,400 | -28% | 18mo | Update with current pricing/features |
+| /guides/beginner-pm | 3,200 | -18% | 10mo | Add interactive elements, update screenshots |
+
+## 4. GEO / AI Visibility
+
+| Metric | Jan 2025 | Dec 2024 | Change |
+|--------|----------|----------|--------|
+| Queries with AI Overview | 78/500 | 72/500 | +6 |
+| Your citations in AI | 34 | 28 | +6 |
+| Citation rate | 43.6% | 38.9% | +4.7pp |
+| Avg citation position | 2.1 | 2.4 | +0.3 (better) |
+
+### New AI Citations Won
+
+- "best project management software" — cited as #1 source
+- "how to create a project plan" — cited as #2 source
+- "agile vs waterfall" — cited as #3 source
+
+## 5. Backlink Performance
+
+| Metric | Jan 2025 | Dec 2024 | Change |
+|--------|----------|----------|--------|
+| Total referring domains | 1,847 | 1,812 | +35 |
+| New links acquired | 62 | 48 | +14 |
+| Links lost | 27 | 31 | -4 (fewer lost) |
+| Average new link DR | 41 | 38 | +3 |
+
+### Notable New Links
+
+| Source | DR | Type |
+|--------|-----|------|
+| TechCrunch | 94 | Press mention (research report) |
+| Forbes | 95 | Expert quote in roundup |
+| HubSpot Blog | 93 | Resource citation |
+
+## 6. Action Items
+
+| Priority | Action | Owner | Deadline |
+|----------|--------|-------|----------|
+| P0 | Fix mobile LCP issue (currently 3.8s) | Engineering | Feb 15 |
+| P1 | Refresh kanban board software article | Content | Feb 10 |
+| P1 | Publish 2025 trends article (replace 2023 version) | Content | Feb 14 |
+| P2 | Build links to CRM comparison page (target: 5 new) | SEO | Feb 28 |
+| P2 | Optimize 3 pages for AI citation (add structured data) | SEO | Feb 21 |
+| P3 | Research new keyword opportunities in "AI tools" space | SEO | Feb 28 |
+```
+
+---
+
+## 3. Technical SEO Report Template
+
+Use this template for engineering teams, dev leads, and technical stakeholders. Focuses on crawlability, indexation, performance, and error resolution.
+
+---
+
+```markdown
+# Technical SEO Health Report
+
+**Domain:** yoursite.com
+**Period:** January 2025
+**Prepared:** February 3, 2025
+
+---
+
+## 1. Crawl Health
+
+### Crawl Stats Summary
+
+| Metric | Jan 2025 | Dec 2024 | Change | Status |
+|--------|----------|----------|--------|--------|
+| Total pages crawled | 12,400 | 11,800 | +5.1% | Normal |
+| Avg crawl rate (pages/day) | 400 | 381 | +5.0% | Normal |
+| Avg response time | 320ms | 290ms | +10.3% | Monitor |
+| Crawl errors | 18 | 12 | +6 | Investigate |
+
+### Crawl Budget Efficiency
+
+| Page Type | Pages Crawled | % of Crawl | Should Crawl? |
+|-----------|-------------|-----------|---------------|
+| Blog posts | 4,200 | 33.9% | Yes |
+| Product pages | 3,100 | 25.0% | Yes |
+| Category pages | 2,400 | 19.4% | Yes |
+| Parameter URLs | 1,800 | 14.5% | No — block in robots.txt |
+| Paginated archives | 900 | 7.3% | Partially — consolidate |
+
+**Action:** Block parameter URLs via robots.txt to reclaim 14.5% of crawl budget.
+
+## 2. Index Coverage
+
+### Index Status
+
+| Status | Count | Change | Action |
+|--------|-------|--------|--------|
+| Valid (indexed) | 2,847 | +23 | None — healthy growth |
+| Valid with warnings | 42 | +3 | Review warnings |
+| Excluded (intentional) | 1,204 | +8 | Verify intentional |
+| Excluded (error) | 67 | +12 | Fix errors |
+
+### Exclusion Reasons (Top 5)
+
+| Reason | Count | Change | Priority |
+|--------|-------|--------|----------|
+| Crawled, not indexed | 34 | +8 | P1 — improve content quality |
+| Duplicate without canonical | 15 | +2 | P2 — add canonical tags |
+| Blocked by robots.txt | 12 | 0 | Verify intentional |
+| Soft 404 | 6 | +2 | P1 — fix or redirect |
+| Server error (5xx) | 0 | 0 | Clean |
+
+## 3. Core Web Vitals
+
+### Field Data (CrUX — 28-day rolling)
+
+| Metric | Mobile | Desktop | Status |
+|--------|--------|---------|--------|
+| LCP | 3.8s (Poor) | 2.1s (Good) | Mobile needs fix |
+| CLS | 0.08 (Good) | 0.05 (Good) | Passing |
+| INP | 180ms (Good) | 120ms (Good) | Passing |
+
+### LCP Diagnosis (Mobile)
+
+| Page Group | Mobile LCP | Issue | Fix |
+|-----------|-----------|-------|-----|
+| /blog/* | 4.2s | Hero images not optimized | Convert to WebP, add lazy loading |
+| /product/* | 3.5s | Third-party script blocking render | Defer non-critical scripts |
+| /resources/* | 3.1s | Large CSS bundle | Code-split CSS |
+
+**Estimated fix timeline:** 2 weeks (engineering sprint Feb 10-21)
+
+## 4. Error Log
+
+### New Errors This Period
+
+| Error Type | Count | Pages Affected | Priority |
+|-----------|-------|---------------|----------|
+| 404 Not Found | 8 | /blog/deleted-post-1, /old/page-2, +6 | P1 |
+| 500 Server Error | 3 | /api/webhook (intermittent) | P0 |
+| Redirect chain (3+ hops) | 5 | /old-url -> /new-url -> /final-url | P2 |
+| Mixed content warning | 2 | /resources/old-guide, /tools/calc | P2 |
+
+### Error Resolution Status
+
+| Error | Opened | Status | Owner |
+|-------|--------|--------|-------|
+| 404 on /blog/deleted-post-1 | Jan 5 | Redirect created Jan 8 | SEO |
+| 500 on /api/webhook | Jan 12 | Investigating | Backend |
+| Redirect chain on /old-url | Jan 15 | Pending | SEO |
+
+## 5. Schema & Rich Results
+
+### Schema Validation
+
+| Schema Type | Pages | Valid | Warnings | Errors |
+|------------|-------|-------|----------|--------|
+| Article | 342 | 338 | 4 | 0 |
+| Product | 89 | 87 | 0 | 2 |
+| FAQ | 56 | 56 | 0 | 0 |
+| HowTo | 23 | 23 | 0 | 0 |
+| BreadcrumbList | 2,847 | 2,847 | 0 | 0 |
+
+**Action:** Fix 2 Product schema errors (missing "price" property on clearance items).
+
+## 6. Technical Debt Tracker
+
+| Item | Priority | Effort | Impact | Status |
+|------|----------|--------|--------|--------|
+| Block parameter URLs in robots.txt | P1 | Low | Crawl budget +14% | Scheduled Feb 5 |
+| Fix mobile LCP (image optimization) | P0 | Medium | CWV pass rate | Sprint Feb 10-21 |
+| Consolidate duplicate pages (42 pages) | P2 | Medium | Index quality | Backlog |
+| Implement hreflang for EN-GB pages | P3 | High | International SEO | Q2 planned |
+| Migrate HTTP resources to HTTPS | P2 | Low | Security + trust | Scheduled Feb 12 |
+
+## 7. Recommendations for Engineering
+
+1. **Immediate:** Resolve intermittent 500 errors on /api/webhook endpoint
+2. **This sprint:** Optimize hero images on blog templates (convert to WebP, implement responsive sizes)
+3. **Next sprint:** Defer third-party scripts on product pages (move to async loading)
+4. **Backlog:** Implement edge caching for static blog content to improve TTFB
+```
+
+---
+
+## 4. Report Assembly Guidelines
+
+### How to Combine Templates
+
+| Audience | Include Sections | Exclude |
+|----------|-----------------|---------|
+| CEO / Board | Executive template only | All technical detail |
+| VP Marketing | Executive + Marketing sections 1-4, 6 | Crawl stats, schema details |
+| Marketing Manager | Full Marketing template | Deep technical debugging |
+| SEO Manager | Marketing + Technical templates | Executive ROI framing |
+| Engineering Lead | Technical template only | Revenue, keyword details |
+| Client (agency) | Executive + Marketing sections 1-3, 6 | Internal cost data, technical debt |
+
+### Data Freshness Requirements
+
+| Report Type | Maximum Data Age | Reason |
+|------------|-----------------|--------|
+| Executive monthly | 3 days after period end | Allow for data processing lag |
+| Marketing weekly | 1 day after period end | Timely action items |
+| Technical | Real-time where possible | Issues need immediate attention |
+| Quarterly review | 5 days after quarter end | Allow for data reconciliation |
+
+### Report Delivery Checklist
+
+- [ ] All data sources verified and dated
+- [ ] Period-over-period comparisons included
+- [ ] Competitor context provided where relevant
+- [ ] Action items are specific, assigned, and time-bound
+- [ ] Report tailored to audience (no jargon for executives, full detail for technical)
+- [ ] Visualizations are clear and labeled
+- [ ] Sources cited for all external benchmarks
+- [ ] Draft reviewed for accuracy before distribution