sergekostenchuk/seo-llm-skill-cluster / skills/seo-regression-validator
seo-regression-validator
VerifiedValidate SEO and LLM-readability claims against live HTML, local fixtures, and generated artifacts. Use this skill when the user asks to prove whether title, meta description, canonical, hreflang, JSON-LD, NewsArticle.image, OpenGraph, Twitter cards, RSS autodiscovery, robots.txt, llms.txt, sitemap, news-sitemap, crawler access, or performance evidence is actually present, and when subjective audits must become timestamped pass/fail reports.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.2 KB |
| agents/openai.yaml | config | 388 B |
| evals.json | config | 1.8 KB |
| fixtures/bad-news.html | other | 483 B |
| fixtures/bad-news.report.json | config | 2.3 KB |
| fixtures/good-news.html | other | 2.2 KB |
| fixtures/good-news.report.json | config | 1.1 KB |
| references/regression-checklist.md | markdown | 1.5 KB |
| scripts/audit_static_seo.py | script | 9.7 KB |
| validation-report.md | markdown | 1.9 KB |
validation-report.md
View on GitHub# SEO Regression Validator Validation Report
date: 2026-06-11
task: T-009
skill_path: `./skills/seo-regression-validator`
## Result
Status: pass.
## Commands
```bash
python3 <codex-skills-dir>/senior-skill-architect/scripts/lint_production_skill.py ./skills/seo-regression-validator --json
```
Result: pass, 0 errors, 0 warnings.
```bash
SEO_REGRESSION_TIMESTAMP=2026-06-11T00:00:00Z python3 ./skills/seo-regression-validator/scripts/audit_static_seo.py ./skills/seo-regression-validator/fixtures/good-news.html --report ./skills/seo-regression-validator/fixtures/good-news.report.json
```
Result: pass, 0 issues.
```bash
SEO_REGRESSION_TIMESTAMP=2026-06-11T00:00:00Z python3 ./skills/seo-regression-validator/scripts/audit_static_seo.py ./skills/seo-regression-validator/fixtures/bad-news.html --report ./skills/seo-regression-validator/fixtures/bad-news.report.json
```
Result: expected fail. Detected missing meta description, duplicate canonical, and missing NewsArticle.image as critical findings.
```bash
python3 -m json.tool ./skills/seo-regression-validator/evals.json
python3 -m json.tool ./skills/seo-regression-validator/fixtures/good-news.report.json
python3 -m json.tool ./skills/seo-regression-validator/fixtures/bad-news.report.json
```
Result: valid JSON.
```bash
python3 ./plans/seo-llm-skill-cluster/scripts/lint_skill_cluster.py . --report ./plans/seo-llm-skill-cluster/cluster-lint-report.json
```
Result: pass, 0 critical issues, 0 warnings.
## Eval Coverage
- Positive cases: 3.
- Negative cases: 3.
- Covered targets: good fixture, live artifact plan, unavailable performance tooling.
- Failure cases: bad fixture, fake passing report, unsupported credentialed claim.
## Notes
- The script is read-only: URL fetch or local file read only.
- Credentialed Search Console/analytics data is out of scope.
- Lighthouse/Core Web Vitals are recorded as skipped when tooling is unavailable.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |