ourdigital/our-claude-skills
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Fix SEO skill 34 bugs, Korean labels, and transition Ahrefs refs to our-seo-agent (#2)

Browse Source
This commit is contained in:
Andrew Yim
2026-02-14 01:09:35 +09:00
committed by GitHub
parent d2d0a2d460
commit a28bfbf847
34 changed files with 265 additions and 262 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
custom-skills/25-seo-kpi-framework/desktop/SKILL.md
View File

@@ -10,26 +10,23 @@ description: |
## 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).
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 our-seo-agent traffic cost data, 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
4. **ROI Estimation** - Traffic value from organic cost data
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
### SEO Data
```
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
our-seo-agent CLI: Primary metrics source (future); use --input for pre-fetched JSON
WebSearch / WebFetch: Supplementary metrics data
```
### Notion for Report Storage
@@ -45,7 +42,7 @@ mcp__notion__*: Save reports to SEO Audit Log database
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)
6. Estimate ROI from traffic cost data (use our-seo-agent CLI or pre-fetched JSON)
### 2. Performance Reporting
1. Determine date range from period (monthly/quarterly/yearly/custom)
@@ -94,10 +91,10 @@ mcp__notion__*: Save reports to SEO Audit Log database
## Limitations
- Local KPIs require external GBP data (not available via Ahrefs)
- Local KPIs require external GBP data (not available via our-seo-agent)
- 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
- ROI is estimated from organic traffic cost data, not actual revenue
## Notion Output (Required)