From metaflow-marketing-skills
Builds trustworthy SEO reports by accounting for ~75% incomplete GSC data and probabilistic AI visibility. Helps configure attribution, KPI hierarchies, and appropriate caveats.
How this skill is triggered — by the user, by Claude, or both
Slash command
/metaflow-marketing-skills:seo-reporting-measurementThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
- **GSC data is ~75% incomplete.** Google filters approximately 75% of search impressions for "privacy" (industry analysis, Feb 2026). Single-source GSC decisions are unreliable.
⚠️ GSC impression data is approximately 75% incomplete. Google filters most search impressions for privacy. Single-source GSC decisions are unreliable. All figures below should be treated as directional trends, not absolute numbers. Cross-reference with third-party tools and focus on deltas over time, not point values.
This is not boilerplate — stakeholders consistently misinterpret SEO reports when they don't understand the data limits. Lead every report with this caveat.
Organized from leading (early signals) to lagging (business outcomes). Each tier has different review cadence and different audiences.
Leading indicators (weekly review):
Core SEO metrics (monthly review):
Business metrics (monthly review, executive audience):
AI visibility metrics (quarterly review minimum):
Per industry reporting, these metrics should NOT be used as primary KPIs:
| Metric | Why retire it | What to use instead |
|---|---|---|
| Organic traffic as standalone KPI | Lacks intent context; treats all traffic as equal | Organic sessions segmented by intent |
| Average keyword position | Meaningless in aggregate (averaging ranks across different queries is statistically incoherent) | Ranking distribution buckets (top 3, top 10, top 20) |
| Domain authority as a business metric | A third-party proxy score, not a Google metric | Referring domain count and quality, actual ranking performance |
| Bounce rate in isolation | GA4 redefined it; often misinterpreted | Engagement rate + task completion signals |
| Single-run AI visibility "score" | Non-deterministic; meaningless without sample size | Visibility % across 60+ runs per prompt per platform |
| Individual meta description CTR | Google rewrites ~60% of meta descriptions; you're measuring Google's rewrite, not yours | Page-level CTR trends with content changes logged |
Monthly Organic Value =
(Organic Sessions × Conversion Rate × Average Order Value)
+
(Lead Gen Conversions × Lead Value × Close Rate)
Important: This is a last-click formula. Multi-touch attribution typically reveals 30-60% more organic value than last-click. If you can, use GA4's data-driven attribution model or build a custom model that credits organic for its role in multi-touch journeys.
Document your model. Every report should state which attribution model is used and its known limitations. Stakeholders will ask why "SEO revenue" differs from "paid social revenue" — the model is the answer.
When reporting AI visibility to stakeholders, every metric must include sample size and the measurement protocol. See references/ai-metrics-reporting.md for the detailed reporting patterns.
Core rules:
When Google rolls out a core update or an AI platform shifts behavior:
See references/algorithm-update-playbook.md for the full diagnostic playbook.
Adapt to the audience. Executives want the one-pager; SEO teams want the detail.
## SEO Performance Report — [Period]
### Executive Summary
[2-3 sentences: what happened this period, what it means for the business, what to do next. No jargon. No fluff.]
### Business Impact
| Metric | This Period | Prior Period | YoY | Target |
|--------|-------------|--------------|-----|--------|
| Organic Revenue | | | | |
| Organic Leads | | | | |
| Organic Sessions (non-branded) | | | | |
| Organic CAC | | | | |
⚠️ Attribution model: [last-click / multi-touch / data-driven]. GSC data ~75% filtered — trends more reliable than absolutes.
### Search Visibility
- Ranking distribution (top 3 / top 10 / top 20)
- Branded vs non-branded impressions and clicks
- SERP feature presence (featured snippets, PAA, AI Overviews)
- New vs lost keywords this period
### AI Search Visibility (if tracking)
| Platform | Visibility % | Δ vs last | Sample size |
|----------|-------------|-----------|-------------|
⚠️ AI metrics are probabilistic. Replication studies: <1% chance of same brand list from same prompt. All figures represent statistical patterns across [X] runs per prompt per platform. Focus on quarterly trends.
### Content Performance
- Top performing pages (by revenue/conversions, not just traffic)
- Decaying content (pages losing rankings or traffic)
- Content refresh priorities (decayed priority pages)
- New content performance (published this period)
### Technical Health
- Core Web Vitals (LCP, INP, CLS — field data)
- Indexation status (indexed vs discovered vs excluded)
- Critical issues (GSC errors, coverage issues, manual actions)
- AI crawler access status
### Competitive Landscape
- Key ranking movements in the competitive set
- Opportunities (pages where we gained position)
- Threats (pages where competitors gained)
### Recommended Actions (Prioritized)
| Priority | Action | Expected Impact | Effort | Timeline |
|----------|--------|----------------|--------|----------|
### Appendix: Methodology Notes
- Data sources: GSC, GA4, rank-tracking / backlink tool, [other]
- Attribution model in use
- AI measurement protocol and sample sizes
- Known limitations: GSC filtering, AI non-determinism, attribution caveats
- Period definitions: [date range, comparison period]
| Cadence | Audience | Focus | Output |
|---|---|---|---|
| Weekly (tactical) | SEO team, content team | Rankings changes, traffic anomalies, technical issues, newly indexed pages | Dashboard + 5-bullet weekly note |
| Monthly (strategic) | Marketing leadership, department heads | Full performance across KPI hierarchy, content wins/losses, recommendations | Structured report (template above) |
| Quarterly (deep dive) | Executive team, board if applicable | Trend analysis, strategy review, competitive repositioning, AI visibility assessment, ROI analysis | Comprehensive presentation |
| Ad-hoc (incident) | Relevant stakeholders | Algorithm updates, major traffic shifts, migrations, crises | Incident report with diagnosis + plan |
For ongoing visibility, build a dashboard (Looker Studio, GA4 native, or a BI tool) with:
Update weekly; review monthly in the structured report.
See the report structure template above. For each report, customize the sections based on what the audience can act on. Executive reports drop the technical detail; SEO team reports drop the business framing.
Period: March 2026 Audience: VP of Marketing + Head of Growth
Organic revenue grew 18% month-over-month, driven by 12 new product analytics cluster pages published in Q1 now ranking on page 1. AI visibility on ChatGPT rose from 12% to 19% after rewriting the pricing page to server-side render. Core Web Vitals regressed on mobile (LCP 3.8s vs 2.4s target) after a blog redesign — fix planned for sprint 14.
| Metric | Mar 2026 | Feb 2026 | YoY | Target |
|---|---|---|---|---|
| Organic revenue (multi-touch) | $187K | $158K | +34% | $200K |
| Organic demo requests | 142 | 119 | +41% | 150 |
| Organic sessions (non-branded) | 89K | 82K | +22% | 100K |
⚠️ Multi-touch data-driven attribution via GA4. GSC impression data ~75% filtered — trend reliable; absolute impression count understated.
| Platform | Visibility % | Δ vs Feb | Sample size |
|---|---|---|---|
| ChatGPT | 19% | +7% | 15 prompts × 60 runs |
| Perplexity | 24% | +2% | 15 prompts × 60 runs |
| AI Overviews | 14% | +6% | 15 prompts × 60 runs |
| AI Mode | 8% | +1% | 15 prompts × 60 runs |
⚠️ AI metrics are probabilistic. Replication studies: <1% chance of same brand list on same prompt. Figures represent patterns across 60 runs per prompt per platform. ChatGPT gain corresponds to pricing page SSR launch on March 11.
/product-analytics-guide (pillar, 8.2K sessions, 22 demos), /amplitude-vs-mixpanel-vs-posthog (4.8K sessions, 31 demos — highest converting), /event-scoping-framework (3.1K sessions, 18 demos)/what-is-product-analytics (ranked #8, falling from #3 over 3 months)| Priority | Action | Impact | Effort | Timeline |
|---|---|---|---|---|
| Critical | Fix LCP regression (compress blog hero images, preload) | High — CWV is page experience signal | Low | Sprint 14 |
| High | Refresh /what-is-product-analytics with updated stats, ski ramp structure | High — recovery of top-3 position | Medium | April W2 |
| High | Publish Q2 benchmark data study | High — PR asset + linkable content | High | End of April |
| Medium | Server-render remaining 4 JS-heavy landing pages | Medium — unlocks AI visibility on those pages | Medium | Sprint 15 |
| Medium | Add FAQPage schema to top 10 commercial pages | Medium — rich result eligibility | Low | April W1 |
Read these when the task warrants:
references/ai-metrics-reporting.md — Detailed guidance on reporting AI visibility metrics responsibly, including sample-size tables, caveat language, and common stakeholder pitfalls. Read when building an AI visibility section of a report.references/algorithm-update-playbook.md — Diagnostic playbook for responding to Google core updates, AI platform shifts, and traffic anomalies. Read when you suspect an algorithm-driven impact.Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub narayan-metaflow/metaflow-marketing-skills --plugin metaflow-marketing-skills