Skip to content
cccskills
FreePublished on GitHub

seo-regression-validator

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.

The English summary is being prepared. Showing the original description.

sergekostenchuk/seo-llm-skill-cluster
Works withSearch ConsoleX (Twitter)
See how to install

Files included (10)

  • SKILL.md3.2 KB
  • agents/openai.yaml388 B
  • evals.json1.8 KB
  • fixtures/bad-news.html483 B
  • fixtures/bad-news.report.json2.3 KB
  • fixtures/good-news.html2.2 KB
  • fixtures/good-news.report.json1.1 KB
  • references/regression-checklist.md1.5 KB
  • scripts/audit_static_seo.py9.7 KB
  • validation-report.md1.9 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

SEO Regression Validator

Use this skill after technical SEO/schema guidance exists, before claiming a site or skill output is done.

Read references/regression-checklist.md before running a broad audit.

Owns

  • live HTML and local fixture checks;
  • pass/fail severity model;
  • timestamped evidence reports;
  • schema/head metadata checks;
  • public artifact reachability checks;
  • regression report templates;
  • negative tests for missing JSON-LD, duplicate canonical, missing image, and fake reports.

Does Not Own

  • implementing SEO fixes;
  • Search Console credentialed data;
  • analytics exports;
  • external authority placement;
  • mutating target websites.

Workflow

  1. Define target URLs or fixture files.
  2. Record timestamp, target, method, and user agent.
  3. Fetch or read the target without mutation.
  4. Run deterministic checks using scripts/audit_static_seo.py when HTML is available.
  5. Separate critical failures, warnings, and skipped checks.
  6. Record skipped checks instead of treating them as passes.
  7. Produce or update seo-regression-report.json and a human-readable validation summary.
  8. Route implementation fixes to the appropriate specialist.

Critical By Default

  • missing <title>;
  • missing meta description;
  • missing or duplicate canonical;
  • no JSON-LD on pages expected to have schema;
  • invalid JSON-LD;
  • NewsArticle without usable image;
  • public page blocked or unreachable during live check;
  • report claims success without fetching or reading target.

Warning By Default

  • missing hreflang when a multilingual equivalent is expected;
  • missing OG/Twitter social tags;
  • missing RSS autodiscovery;
  • missing viewport;
  • article meta tags missing when an article schema exists;
  • no visible breadcrumb when BreadcrumbList is expected;
  • performance metrics not measured.

Safety And Privacy Boundaries

  • Do not mutate target sites.
  • Do not use credentials unless the user explicitly provides them for this task.
  • Do not store cookies, tokens, raw private analytics, raw IP logs, or private Search Console rows in reports.
  • Do not claim ranking, indexing, citation, or crawler behavior from one HTML check.

Validation

Validate skill edits with:

python3 <codex-skills-dir>/senior-skill-architect/scripts/lint_production_skill.py ./skills/seo-regression-validator
python3 ./skills/seo-regression-validator/scripts/audit_static_seo.py ./skills/seo-regression-validator/fixtures/good-news.html
python3 ./plans/seo-llm-skill-cluster/scripts/lint_skill_cluster.py .

Forward tests live in evals.json.

Output Shape

Return:

  1. Targets checked.
  2. Critical findings.
  3. Warnings.
  4. Skipped checks.
  5. Evidence paths or URLs.
  6. Implementation owner for each fix.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

backlink-quality-validator

Free

Validate proposed or existing backlinks for relevance, editorial legitimacy, link attributes, spam/toxicity risk, platform compliance, anchor quality, target-page fit, and monitoring evidence. Use this skill when the user asks whether an external link opportunity or placed backlink is safe and useful, and reject toxic, irrelevant, paid-undisclosed, fake, or spam placements.

The English summary is being prepared. Showing the original description.

sergekostenchuk/seo-llm-skill-cluster40Updated Jun 12, 2026

editorial-quality-gate

Free

Review public site content for editorial quality, source support, prompt residue, duplicate blocks, translation drift, hidden filler, and human usefulness before SEO or LLM-friendly publication. Use this skill when the user asks to quality-gate news briefs, longform explainers, blog posts, topic pages, project pages, translated content, or generated article drafts without changing the live publishing pipeline.

The English summary is being prepared. Showing the original description.

sergekostenchuk/seo-llm-skill-cluster40Updated Jun 12, 2026

external-authority-placement-scout

Free

Find and score legitimate external authority and backlink opportunities as a dry-run register, using relevance, platform rules, risk, target-page fit, and explicit user approval gates. Use this skill when the user asks where links to a target site could be placed effectively, but never post, submit, DM, email, open PRs, or edit external accounts without separate explicit approval.

The English summary is being prepared. Showing the original description.

sergekostenchuk/seo-llm-skill-cluster40Updated Jun 12, 2026

information-architecture-seo

Free

Convert a semantic core into crawlable SEO and LLM-friendly information architecture. Use this skill when the user asks for URL structure, page taxonomy, canonical rules, hreflang groups, page roles, pillar/topic/news/article/blog/project separation, multilingual route strategy, or a durable content model such as one short brief plus one longform article. It prevents duplicate public content bodies and hands link-graph work to internal-link-graph-architect.

The English summary is being prepared. Showing the original description.

sergekostenchuk/seo-llm-skill-cluster40Updated Jun 12, 2026

internal-link-graph-architect

Free

Design intentional internal link graphs for SEO, UX, and LLM-readable sites. Use this skill when the user asks for links between short briefs, longform articles, topics, projects, author pages, breadcrumbs, source trails, related stories, orphan-page checks, overlink checks, anchor intent, or validation that a link graph reinforces the canonical content model without creating duplicate story bodies or hidden links.

The English summary is being prepared. Showing the original description.

sergekostenchuk/seo-llm-skill-cluster40Updated Jun 12, 2026

llm-citation-monitor

Free

Plan and record evidence-backed LLM and AI-search citation checks across approved assistant/search surfaces with timestamped queries, locales, modes, cited URLs, snippets, screenshots or transcripts, and caveats. Use this skill when the user asks whether ChatGPT, Perplexity, Claude, Gemini, Copilot, or another assistant cites a target site, but do not claim citation without direct evidence.

The English summary is being prepared. Showing the original description.

sergekostenchuk/seo-llm-skill-cluster40Updated Jun 12, 2026

See all skills by sergekostenchuk

Report a problem with this skill