Fix SEO skills 19-34 bugs, add slash commands, enhance reference-curator (#3)

* Fix SEO skill 34 bugs, Korean labels, and transition Ahrefs refs to our-seo-agent

P0: Fix report_aggregator.py — wrong SKILL_REGISTRY[33] mapping, missing
CATEGORY_WEIGHTS for 7 categories, and break bug in health score parsing
that exited loop even on parse failure.

P1: Remove VIEW tab references from skill 20, expand skill 32 docs,
replace Ahrefs MCP references across all 16 skills (19-28, 31-34)
with our-seo-agent CLI data source references.

P2: Fix Korean labels in executive_report.py and dashboard_generator.py,
add tenacity to base requirements, sync skill 34 base_client.py with
canonical version from skill 12.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Add Claude Code slash commands for SEO skills 19-34 and fix stale paths

Create 14 new slash command files for skills 19-28, 31-34 so they
appear as /seo-* commands in Claude Code. Also fix stale directory
paths in 8 existing commands (skills 12-18, 29-30) that referenced
pre-renumbering skill directories.

Update .gitignore to track .claude/commands/ while keeping other
.claude/ files ignored.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Add 8 slash commands, enhance reference-curator with depth/output options

- Add slash commands: ourdigital-brand-guide, notion-writer, notebooklm-agent,
  notebooklm-automation, notebooklm-studio, notebooklm-research,
  reference-curator, multi-agent-guide
- Add --depth (light/standard/deep/full) with Firecrawl parameter mapping
- Add --output with ~/Documents/reference-library/ default and user confirmation
- Increase --max-sources default from 10 to 100
- Rename /reference-curator-pipeline to /reference-curator
- Simplify web-crawler-orchestrator label to web-crawler in docs

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Andrew Yim
2026-02-24 14:12:57 +09:00
committed by GitHub
parent 59e5c519f5
commit 397fa2aa5d
33 changed files with 1699 additions and 48 deletions

View File

@@ -0,0 +1,63 @@
---
description: SEO KPI framework - unified metrics, health scores, ROI estimation
---
# SEO KPI Framework
Unified KPI aggregation across all SEO dimensions with health scores, baselines, and ROI estimation.
## Triggers
- "SEO KPI", "SEO performance", "health score", "SEO ROI"
## Capabilities
1. **KPI Aggregation** - Unified metrics across 7 dimensions (traffic, rankings, engagement, technical, content, links, local)
2. **Health Score** - Weighted 0-100 score with trend indicators
3. **Baseline & Targets** - Establish baselines and set 30/60/90-day targets
4. **Performance Reporting** - Period-over-period comparison (MoM, QoQ, YoY)
5. **Executive Summary** - Top wins, concerns, and recommendations
6. **ROI Estimation** - Organic traffic cost valuation
## Scripts
```bash
# Aggregate KPIs
python custom-skills/25-seo-kpi-framework/code/scripts/kpi_aggregator.py \
--url https://example.com --json
# Set baseline
python custom-skills/25-seo-kpi-framework/code/scripts/kpi_aggregator.py \
--url https://example.com --set-baseline --json
# Compare against baseline
python custom-skills/25-seo-kpi-framework/code/scripts/kpi_aggregator.py \
--url https://example.com --baseline baseline.json --json
# With ROI estimation
python custom-skills/25-seo-kpi-framework/code/scripts/kpi_aggregator.py \
--url https://example.com --roi --json
# Monthly performance report
python custom-skills/25-seo-kpi-framework/code/scripts/performance_reporter.py \
--url https://example.com --period monthly --json
# Quarterly report
python custom-skills/25-seo-kpi-framework/code/scripts/performance_reporter.py \
--url https://example.com --period quarterly --json
# Custom date range
python custom-skills/25-seo-kpi-framework/code/scripts/performance_reporter.py \
--url https://example.com --from 2025-01-01 --to 2025-03-31 --json
# Executive summary only
python custom-skills/25-seo-kpi-framework/code/scripts/performance_reporter.py \
--url https://example.com --period monthly --executive --json
```
## Output
- Unified KPI dashboard with health score (0-100)
- 7-dimension breakdown (traffic, rankings, engagement, technical, content, links, local)
- Trend indicators (up/down/stable) per dimension
- 30/60/90-day targets with progress tracking
- Executive summary with top wins and concerns
- Reports saved to Notion SEO Audit Log (Category: SEO KPI & Performance)