sergekostenchuk/ui-ux-agent-skill-system

seo-regression-validator

Validate SEO and LLM-readability claims against live HTML, local fixtures, and generated artifacts.

Ver código fuente

Cómo usar

  1. Copia el comando y revisa el paquete antes de instalarlo en tu entorno de agente.
  2. Consulta las herramientas, credenciales y entornos necesarios en el documento original.
  3. Describe las entradas y el resultado deseado; contrasta la salida con las fuentes.
npx skills add https://github.com/sergekostenchuk/ui-ux-agent-skill-system --skill seo-regression-validator

Antes de empezar

  • La instalación no incluye suscripción al modelo, cuota API ni permisos sobre tus archivos.
  • Las estrellas e instalaciones reflejan actividad, no una prueba independiente de calidad o seguridad.
Documento original del Skill

Contenido del repositorio de origen con títulos, ejemplos, código, tablas, enlaces e imágenes preservados.

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:

bash
python3 $CODEX_HOME/skills/senior-skill-architect/scripts/lint_production_skill.py $HOME/SKILL/skills/seo-regression-validator
python3 $HOME/SKILL/skills/seo-regression-validator/scripts/audit_static_seo.py $HOME/SKILL/skills/seo-regression-validator/fixtures/good-news.html
python3 $HOME/SKILL/plans/seo-llm-skill-cluster/scripts/lint_skill_cluster.py $HOME/SKILL

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.

Relacionados por tarea

del mismo repositorio

Más Skills

Todos los Skills
sergekostenchuk
Comunidad

admin-ui-builder

Use when admin/CMS/back-office screens need to be built or specified after admin-ui-orchestrator defines roles, permissions, workflows, and safety gates. Covers tables, forms, editors, moderation queues, dashboards, CRUD surfaces, and state coverage without production destructive actions.

instalaciones
1
GitHub Stars
32
Actualizado
13 sept
sergekostenchuk
Comunidad

admin-ui-orchestrator

Use when a project needs admin/CMS/back-office UI architecture: roles, permissions, content workflows, AI assistant boundaries, audit logs, destructive-action confirmations, and builder handoff. Planning only; do not perform production admin actions or expose secrets.

instalaciones
1
GitHub Stars
32
Actualizado
13 sept
sergekostenchuk
Comunidad

analytics-setup-architect

Use when a website or web app needs privacy-aware analytics architecture: GA4, Yandex Metrica, self-hosted analytics, consent, UTM, event taxonomy, funnels, dashboards, and launch verification. Do not mutate real analytics accounts or store credentials without explicit approval.

instalaciones
1
GitHub Stars
32
Actualizado
13 sept
sergekostenchuk
Comunidad

figma-canvas-editor

Create and edit native Figma canvas objects with MCP when explicitly scoped. Use this skill when the user asks to add or change frames, sections, components, instances, auto layout, variables, styles, FigJam objects, connectors, Slides objects, or selected nodes in Figma, and when the task requires mutation evidence, rollback-aware scope, and design-system consistency.

instalaciones
1
GitHub Stars
32
Actualizado
13 sept