claude-skills/documentation
Reza Rezvani f61fc7b0ac feat(marketing): add weighted scoring systems to seo-audit + paid-ads
Phase 1 of the marketing skills improvement plan. Inspired by patterns
from claude-seo (4.7k stars) and claude-ads (2.4k stars) — the highest-
traction Claude Code plugins in the SEO/ads space. Adopts their best
patterns without replacing our existing skills.

seo-audit additions:
- scripts/seo_health_scorer.py — weighted 0-100 health score across 7
  categories (Technical 22%, Content 23%, On-Page 20%, Schema 10%,
  Performance 10%, AI Readiness 10%, Images 5%). Industry profiles
  (SaaS/ecommerce/local/publisher) adjust weights. Severity-weighted
  scoring with Critical/High/Medium/Low priority levels and Quick Wins
  extraction. Demo mode included.
- references/cwv-thresholds.md — Core Web Vitals 2026 thresholds (LCP,
  CLS, INP) with good/needs-improvement/poor ranges and common fixes
- references/eeat-framework.md — E-E-A-T audit checklist per Google's
  Sept 2025 Quality Rater Guidelines, YMYL topic handling
- references/schema-types.md — active/deprecated JSON-LD types with
  validation checklist and common mistakes

paid-ads additions:
- scripts/ad_health_scorer.py — multi-platform ad account scoring with
  severity multipliers (Critical=5x, High=3x, Medium=1.5x, Low=0.5x).
  Platform-specific category weights for Google (6 categories, 74 checks),
  Meta (4 categories), LinkedIn (4), TikTok (4). Cross-platform aggregation
  weighted by budget share. Quick Wins prioritization. Demo mode with
  Google + Meta sample data.
- references/scoring-system.md — full scoring algorithm, severity
  multipliers, platform weights, grade bands, quality gates (hard rules
  like "never Broad Match + Manual CPC")
- references/copy-frameworks.md — 6 ad copy frameworks (PAS, BAB, AIDA,
  FAB, 4P, Star-Story-Solution) with selection matrix by product type,
  platform-specific character limits, and brand DNA extraction (7 voice
  axes as JSON schema)

Key patterns adopted from claude-seo/ads:
- Weighted numeric scores replace binary pass/fail
- Severity multipliers make critical issues dominate the score
- Industry/platform auto-detection adjusts weights
- Quick Wins = high severity + partially working (warn not fail)
- Reference files are lazy-loaded, not inline
- Demo mode with realistic sample data

All scripts stdlib-only, --json + --help verified.

Also saved: documentation/implementation/marketing-skills-improvement-plan.md
covering all 3 phases (Phase 2: content scoring, Phase 3: AI detection).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-13 12:50:10 +02:00
..
delivery Dev (#37) 2026-01-07 18:45:52 +01:00
implementation feat(marketing): add weighted scoring systems to seo-audit + paid-ads 2026-04-13 12:50:10 +02:00
GIST_CONTENT.md docs: create comprehensive GitHub Gist content for SEO and Answer Engine Optimization 2025-10-28 14:27:50 +01:00
GROWTH_STRATEGY.md fix(docs): correct marketing skill count to 6, total to 53, codex to 48 2026-02-10 07:57:58 +01:00
PYTHON_TOOLS_AUDIT.md fix(docs): correct marketing skill count to 6, total to 53, codex to 48 2026-02-10 07:57:58 +01:00
TEST_COVERAGE_ANALYSIS.md docs: add test coverage analysis with prioritized improvement plan 2026-03-30 19:33:25 +00:00
WORKFLOW.md docs(workflow): implement branch protection and workflow documentation 2025-11-05 16:41:29 +01:00