our-claude-skills/custom-skills/25-seo-kpi-framework/desktop/SKILL.md

name, description

name	description
seo-kpi-framework	SEO KPI and performance framework for unified metrics, health scores, ROI, and period-over-period reporting. Triggers: SEO KPI, performance report, health score, SEO metrics, ROI, baseline, targets.

SEO KPI & Performance Framework

Purpose

Aggregate SEO KPIs across all dimensions into a unified dashboard. Establish baselines, set targets (30/60/90-day), generate executive summaries with health scores, provide tactical breakdowns, estimate ROI using Ahrefs traffic cost, and support period-over-period comparison (MoM, QoQ, YoY).

Core Capabilities

1. KPI Aggregation - Unified metrics across 7 dimensions (traffic, rankings, links, technical, content, engagement, local)
2. Health Scoring - Weighted 0-100 score with trend direction
3. Baseline & Targets - Establish baselines and set 30/60/90 day growth targets
4. ROI Estimation - Traffic value from Ahrefs organic cost
5. Performance Reporting - Period-over-period comparison with executive summary
6. Tactical Breakdown - Actionable next steps per dimension

MCP Tool Usage

Ahrefs for SEO Metrics

mcp__ahrefs__site-explorer-metrics: Current organic metrics snapshot
mcp__ahrefs__site-explorer-metrics-history: Historical trend data
mcp__ahrefs__site-explorer-metrics-by-country: Country-level breakdown
mcp__ahrefs__site-explorer-domain-rating-history: Domain rating trend
mcp__ahrefs__site-explorer-total-search-volume-history: Keyword volume trend

Notion for Report Storage

mcp__notion__*: Save reports to SEO Audit Log database

Workflow

1. KPI Aggregation

1. Fetch site-explorer-metrics for current organic data
2. Extract traffic, ranking, link, technical, content metrics
3. Calculate dimension scores with weights (traffic 25%, rankings 20%, technical 20%, content 15%, links 15%, local 5%)
4. Compute overall health score (0-100)
5. Set 30/60/90 day targets (5%/10%/20% improvement)
6. Estimate ROI from Ahrefs traffic cost (divide raw cost by 100 for USD)

2. Performance Reporting

1. Determine date range from period (monthly/quarterly/yearly/custom)
2. Fetch metrics-history for current and previous period
3. Calculate period-over-period changes
4. Identify wins (>5% improvement) and concerns (>5% decline)
5. Generate executive summary with trend arrows
6. Create tactical breakdown with actionable next steps
7. Compare against targets if provided

Output Format

## SEO KPI Dashboard: [domain]

### Health Score: [score]/100 ([trend])

### KPI Summary
| Dimension | Score | Key Metric | Trend |
|-----------|-------|------------|-------|
| Traffic | [score] | [organic_traffic] | [arrow] |
| Rankings | [score] | [visibility] | [arrow] |
| Links | [score] | [DR] | [arrow] |
| Technical | [score] | [health] | [arrow] |
| Content | [score] | [indexed_pages] | [arrow] |

### Executive Summary
- Top Wins: [list]
- Top Concerns: [list]
- Recommendations: [list]

### Targets (30/60/90 day)
[Target table with progress bars]

Key Metrics

Dimension	Metrics	Source
Traffic	Organic traffic, traffic value (USD)	site-explorer-metrics
Rankings	Visibility score, top10 keywords	site-explorer-metrics
Links	Domain rating, referring domains	domain-rating, metrics
Technical	Pages crawled, technical health	site-explorer-metrics
Content	Indexed pages, freshness score	site-explorer-metrics
Local	GBP visibility, review score	External data

Limitations

• Local KPIs require external GBP data (not available via Ahrefs)
• Engagement KPIs (bounce rate, session duration) require Google Analytics
• Technical health is estimated heuristically from available data
• ROI is estimated from Ahrefs traffic cost, not actual revenue

Notion Output (Required)

All reports MUST be saved to OurDigital SEO Audit Log:

• Database ID: 2c8581e5-8a1e-8035-880b-e38cefc2f3ef
• Properties: Issue (title), Site (url), Category, Priority, Found Date, Audit ID
• Language: Korean with English technical terms
• Audit ID Format: KPI-YYYYMMDD-NNN