Skip to content

sergekostenchuk/seo-llm-skill-cluster / skills/seo-regression-validator

seo-regression-validator

Verified

Validate 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.

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.

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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall