---
name: zm-revisa-web
description: Revisa el SEO técnico y la accesibilidad básica de una página o carpeta de HTML ya generado (título, descripción, viewport, h1 único, canonical, Open Graph, alt de imágenes, etiquetas de campos, enlaces vacíos y JSON-LD) con un script local sin dependencias. Úsala antes de publicar una web, cuando pidan "revisar el SEO", "auditar la página" o "comprobar que la web está lista".
license: MIT
compatibility: Requiere Node.js 18 o más nuevo para ejecutar revisar.js. No usa red.
---

# ZM Revisa tu Web

Skill original de ZM. Ejecuta una revisión repetible sobre HTML ya generado y te obliga a corregir con evidencia en lugar de opinar a ojo.

## Reglas que no se rompen

- Revisa el HTML **final** (la carpeta que se publica: `dist`, `out`, `build`, `public`), no las plantillas.
- No declares «listo» con errores pendientes. Si un error es intencional, dilo y explica por qué.
- No inventes datos para rellenar huecos: ni direcciones, ni teléfonos, ni reseñas, ni datos estructurados falsos.
- El script solo lee archivos. No lo modifiques para ocultar un hallazgo.

## Paso 1. Localiza el HTML final

Averigua qué carpeta se publica. Si el proyecto necesita un build, ejecútalo primero con el comando que ya use el proyecto.

## Paso 2. Ejecuta la revisión

```
node revisar.js <carpeta-o-archivo.html>
```

`revisar.js` está en la misma carpeta que este archivo. Añade `--json` si necesitas procesar el resultado. El código de salida es `1` si hay algún error y `0` si no.

## Paso 3. Corrige por prioridad

1. **Errores** (rompen algo para personas o buscadores): idioma, título, descripción, viewport, h1, canonical no absoluto, imágenes sin `alt`, campos sin etiqueta, botones o enlaces sin nombre, JSON-LD que no se puede leer.
2. **Avisos** (mejoras): longitudes, canonical ausente, Open Graph, enlaces a `#`, `noindex`, falta de datos estructurados.

Corrige en la **fuente** (plantilla o componente), no en el HTML generado. Una imagen decorativa lleva `alt=""`, no un texto inventado.

## Paso 4. Repite y entrega

Vuelve a generar el sitio y ejecuta otra vez el script. Entrega:

- La salida final del script, sin recortar.
- La lista de avisos que decides no corregir, con el motivo de cada uno.
- Lo que el script **no** cubre y sigue pendiente (ver límites).

## Límites

- Lee texto con patrones: no ejecuta JavaScript ni ve la página. El contenido que se pinta en el navegador no se revisa.
- No mide contraste, foco, orden de tabulación, velocidad ni enlaces rotos.
- Pasar esta revisión no garantiza posiciones en buscadores ni el cumplimiento de WCAG.
