¿Qué hace website-audit?
Un solo comando mide el sitio; luego confirmas lo que un script no puede juzgar y entregas un informe que un fundador puede utilizar. La auditoría es de solo lectura: nunca envía un formulario, nunca inicia sesión, nunca hace clic en nada que cambie el estado, respeta robots.txt y hace pausas entre cargas de página.
Entradas
- URL (obligatoria). Pídela si el usuario no la ha proporcionado.
- Límite de páginas (opcional, predeterminado 10). Usa 3–5 para una revisión rápida, 15–25 para una línea base completa antes de la reconstrucción.
- Idioma del informe (opcional, predeterminado = el idioma en que escribe el usuario).
Requisitos
- Node.js 22 o más reciente (
node --version). Lighthouse necesita además Node ≥ 22.19 y npm (npx). - Google Chrome o Chromium. Se detecta automáticamente en macOS, Linux y Windows, incluido un Chromium ya descargado por
npx playwright install chromium. De lo contrario, estableceCHROME_BIN=/path/to/chrome. - Acceso de red al sitio auditado, más una CDN pública de npm (axe-core) y el registro npm (Lighthouse). Si no se puede obtener alguna herramienta, esa área se marca como omitida en el informe con el motivo; la ejecución no falla.
Pasos
1. Ejecutar la auditoría
<skill-dir> es la carpeta donde reside este SKILL.md.
node <skill-dir>/scripts/audit.mjs https://example.com --limit 10
Opciones: --limit N · --delay MS (pausa entre páginas, predeterminado 1000) · --max-links N (verificaciones de enlaces internos, predeterminado 150) · --no-lighthouse · --no-axe · --max-minutes N (predeterminado 15) · --out DIR.
La salida va a ./website-audit/<dominio>/ relativa a la carpeta actual (sobrescribe con --out o la variable de entorno WEBSITE_AUDIT_OUT):
website-audit-<dominio>-<fecha>.md: el informewebsite-audit-<dominio>-<fecha>.json: mediciones sin procesar, hallazgos, puntuaciones, instantáneascreens/: capturas de pantalla de la primera pantalla por página, escritorio y 390 px
El progreso va a stderr; la última línea de stdout es un resumen JSON (ok, report, pages, seconds, overall, counts, scores, skipped). El código de salida 2 significa que la auditoría no pudo ejecutarse en absoluto (sin Node 22, sin Chrome, sitio inaccesible): muestra al usuario el mensaje, que indica qué instalar o verificar.
Una ejecución de 10 páginas toma aproximadamente 2–4 minutos; Lighthouse añade 30–60 segundos.
2. Revisión manual
Sigue <skill-dir>/references/manual-review.md:
- Confirma cada P0 con su evidencia (el script es literal; la protección contra bots o un formulario JavaScript pueden simular un P0).
- Resuelve cada elemento «verificar manualmente» leyendo las capturas de pantalla en
screens/. - Asegúrate de que «Arreglar primero» se lea como el primer sprint de la reconstrucción.
Edita el informe en markdown en su lugar. No cambies el JSON; es la línea base sin procesar.
3. Idioma
El script escribe en inglés. Si el usuario escribe en otro idioma, traduce los encabezados del informe, las líneas «Por qué es importante para los leads» y «Arreglo». Mantén las URL, selectores, nombres de métricas, códigos HTTP y etiquetas P0 a P3 tal como están.
4. Entrega
Responde con: puntuación general, recuentos de P0 / P1, la lista «Arreglar primero», qué áreas se omitieron y por qué, y la ruta al informe. Ofrece volver a ejecutar en el nuevo sitio más tarde con el mismo límite para llenar la columna «después» de la instantánea.
Si el usuario desea que se vuelva a renderizar después de editar umbrales:
node <skill-dir>/scripts/report.mjs <ruta-de-ejecucion>.json reescribe el markdown a partir del JSON.
Qué cubre cada área
Los detalles, umbrales y reglas de prioridad están en <skill-dir>/references/checks.md. En resumen:
| Área | Cómo |
|---|---|
| Diseño móvil | cada página a 360 / 390 / 768 px: desplazamiento lateral, elementos más allá del borde, meta viewport, objetivos táctiles, texto pequeño |
| Bugs | errores y excepciones de consola, solicitudes 4xx/5xx y fallidas, contenido mixto, imágenes rotas, enlaces internos (HEAD/GET), destinos de formularios (solo HEAD) |
| Accesibilidad | axe-core inyectado en cada página, etiquetas WCAG 2.0/2.1 A + AA |
| Rendimiento | Lighthouse móvil en la página de inicio; temporización del navegador (TTFB, LCP, CLS, peso, solicitudes) en cada página |
| Ruta de conversión | CTA en la primera pantalla en escritorio y teléfono, clics para contacto, correo electrónico / teléfono / reserva / formulario de leads, testimonios, casos, logotipos, números |
| Fundamentos de SEO | título, descripción, un H1, canónica, Open Graph, noindex, robots.txt, sitemap.xml |
Reglas
- Nunca envíes, rellenes ni hagas clic en formularios; nunca inicies sesión; nunca evites la protección contra bots o un CAPTCHA. Si el sitio muestra una página de desafío, repórtalo y detente.
- Respeta las reglas de desautorización de robots.txt; mantén el retraso predeterminado a menos que el usuario sea el propietario del sitio y solicite una ejecución más rápida.
- Los hallazgos marcados como «verificar manualmente» son hipótesis hasta que mires la captura de pantalla.
- No publiques el informe en ningún lugar por tu cuenta; puede describir puntos débiles de un cliente.
No es esta habilidad
- Crítica de copia, posicionamiento y mensajes →
website-copy-reframe. - Una marca / sistema de diseño a partir de un sitio →
design-system-generator. - Posiciones de palabras clave, backlinks, estimaciones de tráfico → una herramienta de datos SEO.