Communitygithub.com

Im-Fran/landing-skills

Utilícelo al revisar, auditar o criticar una página de aterrizaje, antes de dar por terminado el trabajo en una página de aterrizaje, o cuando se le pregunte si una página parece generada por IA, plantilla o poco profesional.

¿Qué es landing-skills?

Esta habilidad está diseñada para auditar de forma exhaustiva una landing page y generar un informe detallado en `landing/review.md`. Su propósito es detectar fallos comunes que pasan desapercibidos en páginas que aparentan estar terminadas, como formularios que descartan clientes potenciales, promesas no validadas con el cliente o páginas 3D que fallan sin WebGL. El proceso consta de varias fases: una pasada estática que escanea el código fuente en busca de patrones sospechosos, una revisión visual que captura la página renderizada en cuatro anchos diferentes (360, 768, 1280 y 1440 píxeles) y, opcionalmente, una prueba de movimiento y 3D. Finalmente, se evalúa cada aspecto contra una rúbrica detallada y se genera un veredicto. La habilidad es compatible con cualquier página, ya sea un directorio de proyecto, un archivo HTML único o una URL desplegada, y se integra con frameworks como Astro, Next.js o Vite. Los revisores deben ejecutar todos los pasos en orden, documentar cada hallazgo con evidencia y evitar saltarse cualquier comprobación, incluso si un fallo ya es evidente, para garantizar una auditoría completa y profesional.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Im-Fran/landing-skills/tree/HEAD/skills/landing-review

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Revisión de landing page

Auditas una página de aterrizaje y escribes un veredicto en landing/review.md. La página puede provenir del pipeline de landing-skills o de cualquier otro lugar. Lees el código fuente, observas la página renderizada en cuatro anchos, pruebas la animación y el 3D cuando los hay, y juzgas todo contra una rúbrica.

Las páginas que parecen terminadas a menudo tienen fallos que nadie buscó: un formulario que descarta cada cliente potencial mientras agradece al visitante, especificaciones y promesas que el cliente nunca dio, una página 3D que se queda en blanco cuando WebGL no está disponible, un padding de sección cancelado por otra regla en cada ancho. Los revisores que capturan cuatro anchos y miran dos se pierden lo que aparece solo en uno. Tu trabajo es mirar todo e informar solo lo que has confirmado.

<skill-dir> a continuación significa el directorio que contiene este SKILL.md; los scripts están en su carpeta scripts/. Cuando la habilidad se cargó desde un plugin, la ruta de este archivo se te proporcionó cuando se cargó; si no, encuéntrala con find ~ -path '*landing-review/scripts/detect-tells.mjs' 2>/dev/null. Ejecuta cada comando desde el proyecto que se está revisando, con los scripts nombrados por su ruta completa.

Entradas

Necesitas la página y usas cualquier contexto que exista.

  1. La página. Un directorio de proyecto, un único archivo HTML o una URL desplegada. Encuentra el archivo de entrada: index.html, src/pages/index.astro, src/App.jsx, app/page.tsx o lo que use el stack. Anota el stack; esto determina cómo sirves la página en la pasada visual.
  2. landing/brief.md: producto, audiencia, acción de conversión, los hechos y las pruebas que el cliente proporcionó, los recursos proporcionados, el idioma. Esta es tu fuente de verdad sobre lo que la página puede afirmar.
  3. landing/copy.md: el texto aprobado. Compara la página con él.
  4. landing/direction.md y landing/tokens.css: la dirección visual con sus razones y los tokens. Una elección que parece un valor predeterminado es aceptable cuando la dirección da una razón específica para el cliente.

Cuando faltan archivos:

  • Sin brief. Pregunta al usuario cuatro cosas antes de juzgar afirmaciones: cuál es el producto, para quién es, cuál es la única acción de conversión y qué hechos, números, testimonios y logotipos son reales. Si no puedes preguntar, toma los hechos de lo que la página misma dice sobre el negocio y trata cada testimonio, nombre de cliente, logotipo, calificación y métrica como no verificado: informa cada uno como un bloqueante con la solución "confirma que esto es real y proporcionado por el cliente, o elimínalo". Pruebas no verificadas que se publican corren el mismo riesgo que pruebas inventadas.
  • Sin copy.md o direction.md. Revisa el texto y los elementos visuales por sus propios méritos con la rúbrica. Pierdes la capacidad de decir "esto difiere del texto aprobado", nada más. No preguntes por estos archivos.
  • Sin carpeta landing/. Crea landing/ y landing/shots/ en el proyecto; el informe y las capturas de pantalla van allí.
  • La página no se compila o no se sirve. Infórmalo bajo la fila B15 de la rúbrica, con el error. Si no se puede obtener ninguna página renderizada de otro modo (una URL desplegada, una compilación anterior), la pasada visual no se puede ejecutar y el veredicto es incompleto (consulta Veredicto).

Lee references/rubric.md antes de comenzar las pasadas. Contiene cada comprobación con cómo se ve una pasada y la gravedad cuando falla. Lee references/report-format.md antes de escribir landing/review.md. references/snippets.md contiene los scripts que ejecutan las pasadas.

Proceso

Ejecuta las pasadas en este orden y luego escribe el informe:

  1. Pasada estática: escanea el código fuente y luego léelo.
  2. Pasada visual: renderiza la página y mírala en cuatro anchos.
  3. Pasada de animación y 3D: solo cuando la página tenga animación o una escena 3D.
  4. Recorre toda la rúbrica en references/rubric.md, área por área: texto, dirección de arte, compilación, animación, preparación para el lanzamiento. Escribe una lista de verificación de trabajo en landing/review-checklist.md con una línea para cada identificador de fila: fail con la ubicación, pass con evidencia, o n/a con la razón. Un pass cuenta solo cuando su evidencia es la salida de la propia "Cómo comprobar" de esa fila: la lista donde dice lista, el recuento donde dice recuento, y cada sección, encabezado y pie de página incluido, donde cubre cada sección. Una fila marcada desde la memoria de la página no se recorre. Lee el texto y la dirección de arte con tanto cuidado en una página estática corta como en una compleja, y recorre cada fila incluso cuando un bloqueante ya es obvio: la revisión enumera todo lo que la siguiente ronda debe corregir, no solo lo que decide el veredicto.
  5. Escribe landing/review.md como lo describe references/report-format.md: fallos en la tabla, aciertos con su evidencia en "Comprobado y correcto". Luego ejecuta la autocomprobación al final de este archivo.

Toma notas a medida que avanzas: para cada hallazgo, dónde lo viste (archivo y línea, o ancho y sección) y cómo lo confirmaste.

Pasada estática

Apunta el escáner a las rutas de código fuente de la página, no a un repositorio completo:

node <skill-dir>/scripts/detect-tells.mjs index.html styles.css
node <skill-dir>/scripts/detect-tells.mjs src --json

Lo que lee: cualquier archivo que nombres directamente, independientemente de su extensión. En un directorio, lee archivos .html, .htm, .css, .scss, .js, .jsx, .mjs, .ts, .tsx, .astro, .vue, .svelte, .md y .mdx, omite las carpetas node_modules, .git, dist, build, .next, .astro, .output, .vercel y .wrangler, y omite cualquier archivo de más de 1 MB. Cada línea se verifica con 25 reglas. Un hallazgo se imprime como archivo:línea [id-regla] mensaje seguido de una línea fix:. El código de salida 1 significa que encontró algo, 0 significa que no encontró nada, 2 significa una ruta o uso incorrecto. --self-test verifica el propio escáner.

Debido a que lee Markdown, también informa frases citadas en notas, informes, el brief y revisiones anteriores. Ignora todo hallazgo en un archivo que no sea código fuente de la página: landing/*.md, README, notas, archivos review.md anteriores.

Trata cada hallazgo como una indicación para mirar, nunca como un veredicto. Abre la línea, observa lo que realmente contiene y lo que la página hace con él, y solo entonces decide. Describe lo que coincidió con la regla: un acierto de paleta en un color de etiqueta no es un hallazgo sobre el fondo de la página. Ejemplos de lo que decide la mirada:

  • dead-anchor en un enlace de logotipo es un fallo menor de compilación. En la llamada a la acción principal significa que la conversión no funciona: un bloqueante.
  • overused-font significa que una fuente común lidera el stack. Es un hallazgo solo cuando direction.md no da ninguna razón y la fuente no está emparejada con una fuente de visualización o mono distinta.
  • palette-cream-terracotta se activa con dos valores hex exactos. Solo crema nunca es una señal reveladora; el conjunto de crema, acento terracota y una serifa moderna lo es.

Un escaneo limpio no prueba nada. Afirmaciones inventadas, una página que está en blanco sin JavaScript, un paquete sobredimensionado y una llamada a la acción que enlaza a un id válido dentro de la página pero nunca lleva a una compra: todo eso no deja patrón en el código fuente. La mayoría de los fallos son ausencias, recuentos, contradicciones, composición y comportamiento roto, que una expresión regular línea por línea no puede ver. Una página puede escanear limpia y fallar en todas las demás pasadas.

Así que después del escaneo, lee el código fuente tú mismo. Las comprobaciones a realizar leyendo están en references/rubric.md, marcadas como "fuente". Las que detectan más:

  • El <head>: título, lang, meta descripción, favicon, etiquetas Open Graph.
  • Cada formulario: dónde se envía, qué hace el controlador con los datos y si el mensaje de éxito espera al servidor.
  • Cada href de llamada a la acción: a dónde lleva realmente.
  • Fuentes: ¿cada font-family se carga mediante un @font-face, un enlace de hoja de estilo o una importación de fuente del framework, o es solo un stack del sistema?
  • Cada afirmación, número, nombre, especificación y promesa en la página, verificada contra el brief. Cada recurso que el brief dice que se proporcionó, verificado contra lo que la página muestra.
  • CSS que se cancela a sí mismo, como una clase de contenedor cuyo shorthand padding es más específico que la regla de sección y silenciosamente restablece el padding vertical de la sección a cero. Confírmalo en el navegador leyendo el padding calculado.
  • prefers-reduced-motion: presente o ausente, y qué hace.
  • El cuerpo del HTML compilado: si es un <div id="root"> vacío sin <noscript>, la página está en blanco sin JavaScript.

Pasada visual

Necesitas una página renderizada. El escáner y el código fuente no pueden mostrarte superposiciones, mitades vacías de un diseño, titulares envueltos, espaciado colapsado o texto superpuesto a una escena 3D.

Servir la página

Siempre revisa a través de HTTP, incluso HTML simple. Varias comprobaciones necesitan un servidor: las rutas de recursos relativas a la raíz (/styles.css, /assets/...) fallan sobre file://, y la fila L7 de la rúbrica solicita una ruta faltante, /robots.txt y /sitemap.xml. Instala las dependencias primero si falta node_modules.

  • URL desplegada: úsala directamente.
  • HTML y CSS simples: en la carpeta que contiene index.html, ejecuta python3 -m http.server 8000 y abre http://localhost:8000/.
  • Vite: npm run build, luego npx vite preview (puerto 4173 por defecto).
  • Astro: npm run build, luego npx astro preview (puerto 4321 por defecto).
  • Next.js: npm run build, luego npm run start (puerto 3000 por defecto).
  • Cualquier otra compilación: compílala, luego ejecuta el mismo comando python3 -m http.server en la carpeta de salida.

Escribe la URL que revisaste en Pasadas. Abre una ruta file:// solo como último recurso, cuando no se pueda servir nada; entonces L7 no se ejecuta y cualquier recurso con una ruta relativa a la raíz puede faltar solo por esa razón. Enumera ambos bajo Pasadas y no informes un recurso faltante que el servidor habría encontrado.

Revisa una salida de compilación existente solo cuando esté actualizada con el código fuente. find src index.html -newer dist/index.html (con las rutas de código fuente y salida del stack) enumera los archivos de código fuente cambiados desde la compilación; si enumera alguno, o no hay compilación, recompila. Indica bajo Pasadas cuál revisaste y por qué.

Elegir el método de captura, en este orden

  1. Una herramienta de navegador, si el entorno tiene una. Necesitas estas capacidades: navegar a una URL, establecer el ancho del viewport, tomar una captura de pantalla de página completa, ejecutar un script en la página y emular funciones multimedia (esquema de color, movimiento reducido) y JavaScript desactivado.

  2. El script de respaldo, cuando no hay herramienta de navegador o no puede capturar. Ejecútalo incluso si te dijeron que no hay navegador disponible: inicia su propio navegador a través de npx y puede funcionar de todos modos.

    node <skill-dir>/scripts/screenshot.mjs <url-o-archivo> landing/shots
    node <skill-dir>/scripts/screenshot.mjs <url-o-archivo> landing/shots --dark
    

    Escribe 360.png, 768.png, 1280.png y 1440.png (con --dark, 360-dark.png y así sucesivamente), página completa, después de una espera de 1.5 segundos, e imprime cada ruta de archivo. Si falla con "El ejecutable no existe", ejecuta npx playwright install chromium y reintenta. Ha fallado cuando sale con un código distinto de cero, imprime "captura fallida en px" o no escribe ninguna imagen.

  3. Ninguno funciona. Solo entonces la pasada visual no se ha ejecutado. Haz la pasada estática y la lectura del código fuente de todos modos, luego sigue la regla de Veredicto para incompleto.

El script de respaldo no puede ejecutar scripts en la página, emular movimiento reducido, desactivar JavaScript o WebGL, ni desplazarse. Con él, juzga lo que puedas de las imágenes, verifica el movimiento reducido, JavaScript desactivado y WebGL desactivado leyendo el código fuente, y enumera bajo Pasadas cada comprobación que no pudiste ejecutar en vivo, con el motivo.

Capturar los cuatro anchos

Para cada ancho, 360, 768, 1280 y 1440 (altura 800 está bien):

  1. Establece el ancho, carga la página, espera fuentes e imágenes.
  2. Confirma el ancho real con la comprobación de viewport en references/snippets.md. Algunas herramientas no reducirán una ventana por debajo de un mínimo y silenciosamente te darán una página más ancha; usa la emulación de dispositivo o viewport de la herramienta en su lugar, y vuelve a comprobarlo.
  3. Toma una captura de pantalla de página completa en landing/shots/.
  4. Ejecuta el script de medición de references/snippets.md y lee sus advertencias: desbordamiento, elementos más anchos que el viewport, cambio de diseño, recuento de canvas.
  5. Desplázate por la página en el navegador en vivo, de arriba a abajo.

Luego abre y lee cada imagen: los cuatro anchos, y los oscuros si los tomaste. Escribe una línea por ancho en tus notas diciendo lo que viste antes de seguir adelante. Mirar dos anchos y asumir los otros es cómo se pasan por alto los fallos que aparecen solo en algunos anchos: un bloque estrecho que deja la mitad de la fila vacía solo en los anchos grandes, o enlaces de sección ocultos sin menú solo en el más estrecho.

Si una captura de página completa falla o vuelve cortada, lo que sucede en páginas altas con lienzos (canvas), captura el viewport en su lugar en la parte superior y en varias posiciones de desplazamiento (un cuarto, la mitad, tres cuartos, la parte inferior) en cada ancho, y dilo en Pasadas. El script de respaldo solo toma capturas de página completa; si falla de esa manera, registra qué anchos faltan.

Las capturas de página completa de páginas impulsadas por desplazamiento pueden mostrar bandas en blanco donde las secciones de paralaje o fijas están fuera de la pantalla en la posición de desplazamiento cero. Antes de informar de un área en blanco, desplázate hasta ella en la página en vivo. Si se renderiza allí, es un artefacto de captura, no un defecto.

Buscar

En cada ancho, con la rúbrica abierta:

  • Desplazamiento horizontal, texto recortado, elementos superpuestos, texto sobre una imagen o lienzo donde se vuelve difícil de leer.
  • Espaciado: secciones sin padding vertical, encabezados pegados al bloque de arriba, bordes que sobresalen más allá del contenido.
  • Composición: filas medio vacías en 1280 y 1440, titulares que envuelven a cuatro líneas o dejan una sola palabra en la última línea, cejas, etiquetas y botones que envuelven a 360, tarjetas de altura desigual.
  • Navegación a 360: ¿los enlaces de sección siguen siendo accesibles?, ¿los botones tienen al menos 44 por 44 px?, ¿un encabezado fijo cubre el título?
  • Orden a 360: ¿el producto es visible sobre el formulario o está empujado debajo de él?
  • Imágenes: ¿recursos reales o marcadores de posición etiquetados con la relación de aspecto correcta para recursos que aún no existen?
  • Teclado: Tab a través de la página una vez a 1280. El foco debe ser

...

[truncado para traducción]

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

Skills relacionados