Add SEO skills 19-28, 31-32 with full Python implementations
12 new skills: Keyword Strategy, SERP Analysis, Position Tracking, Link Building, Content Strategy, E-Commerce SEO, KPI Framework, International SEO, AI Visibility, Knowledge Graph, Competitor Intel, and Crawl Budget. ~20K lines of Python across 25 domain scripts. Updated skill 11 pipeline table and repo CLAUDE.md. Enhanced skill 18 local SEO workflow from jamie.clinic audit. Note: Skill 26 hreflang_validator.py pending (content filter block). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
107
custom-skills/25-seo-kpi-framework/desktop/SKILL.md
Normal file
107
custom-skills/25-seo-kpi-framework/desktop/SKILL.md
Normal file
@@ -0,0 +1,107 @@
|
||||
---
|
||||
name: seo-kpi-framework
|
||||
description: |
|
||||
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
|
||||
|
||||
```markdown
|
||||
## 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
|
||||
8
custom-skills/25-seo-kpi-framework/desktop/skill.yaml
Normal file
8
custom-skills/25-seo-kpi-framework/desktop/skill.yaml
Normal file
@@ -0,0 +1,8 @@
|
||||
name: seo-kpi-framework
|
||||
description: |
|
||||
SEO KPI and performance framework. Triggers: SEO KPI, performance report, health score, SEO metrics, ROI, baseline, targets.
|
||||
allowed-tools:
|
||||
- mcp__ahrefs__*
|
||||
- mcp__notion__*
|
||||
- WebSearch
|
||||
- WebFetch
|
||||
15
custom-skills/25-seo-kpi-framework/desktop/tools/ahrefs.md
Normal file
15
custom-skills/25-seo-kpi-framework/desktop/tools/ahrefs.md
Normal file
@@ -0,0 +1,15 @@
|
||||
# Ahrefs
|
||||
|
||||
> TODO: Document tool usage for this skill
|
||||
|
||||
## Available Commands
|
||||
|
||||
- [ ] List commands
|
||||
|
||||
## Configuration
|
||||
|
||||
- [ ] Add configuration details
|
||||
|
||||
## Examples
|
||||
|
||||
- [ ] Add usage examples
|
||||
15
custom-skills/25-seo-kpi-framework/desktop/tools/notion.md
Normal file
15
custom-skills/25-seo-kpi-framework/desktop/tools/notion.md
Normal file
@@ -0,0 +1,15 @@
|
||||
# Notion
|
||||
|
||||
> TODO: Document tool usage for this skill
|
||||
|
||||
## Available Commands
|
||||
|
||||
- [ ] List commands
|
||||
|
||||
## Configuration
|
||||
|
||||
- [ ] Add configuration details
|
||||
|
||||
## Examples
|
||||
|
||||
- [ ] Add usage examples
|
||||
@@ -0,0 +1,15 @@
|
||||
# WebSearch
|
||||
|
||||
> TODO: Document tool usage for this skill
|
||||
|
||||
## Available Commands
|
||||
|
||||
- [ ] List commands
|
||||
|
||||
## Configuration
|
||||
|
||||
- [ ] Add configuration details
|
||||
|
||||
## Examples
|
||||
|
||||
- [ ] Add usage examples
|
||||
Reference in New Issue
Block a user