Communitygithub.com

Im-Fran/landing-skills

Úsalo cuando te pidan construir, crear, diseñar o rediseñar una página de aterrizaje, página de marketing, página de producto, página de lista de espera o página de inicio, o cuando empieces a trabajar en una página de aterrizaje sin un brief, texto aprobado o una dirección de diseño definida.

¿Qué es landing-skills?

Este skill define un flujo de trabajo estructurado para crear páginas de aterrizaje, desde la definición del brief hasta el lanzamiento. Es útil porque garantiza que el contenido, el diseño y el código se desarrollen en el orden correcto, evitando retrabajos y asegurando que la página final cumpla con los requisitos del usuario. Está diseñado para agentes de IA como Claude Code o Cursor que necesitan construir páginas web de forma autónoma. El skill se compone de seis sub-skills que se ejecutan en un orden fijo: contenido (copia), dirección de arte, construcción, movimiento, revisión y lanzamiento. Cada skill lee y escribe archivos específicos en la carpeta `landing/`, y puede ejecutarse de forma independiente, aunque la secuencia completa asegura que el diseño no se construya antes de tener el texto, ni el código antes de tener la dirección visual. El brief captura campos críticos como el tipo de página, idioma, producto, audiencia, acción de conversión, precios, pruebas disponibles, activos, restricciones de marca, stack técnico, dominio, rutas de contacto y efectos deseados. Si falta información, el skill pregunta de forma estructurada, pero nunca inventa datos que puedan ser engañosos.

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

Preguntar en tu IA favorita

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

Documentación

Página de aterrizaje

Este es el punto de entrada para el trabajo en una página de aterrizaje. Define el brief en landing/brief.md, luego ejecuta las seis habilidades de este plugin en un orden fijo, de modo que la página nunca se maqueta antes de tener el texto ni se codifica antes de tener la dirección.

Empieza así. Si landing/brief.md existe, léelo y pregunta solo por lo que le falta. De lo contrario, pregunta primero (ver "Cuando falta información"), luego escríbelo. Lee también el proyecto (README, package.json, un sitio existente) y no preguntes por lo que ya responde. Nada de texto, diseño ni código antes de que el brief esté escrito.

El brief

Una línea por campo, en las palabras del usuario:

  1. Tipo: SaaS, producto, servicio o estudio, lista de espera, evento, o una combinación.
  2. Idioma: el idioma con su variante regional o de país (es-CL, en-GB). Para español, también la forma de tratamiento (tú, usted, vos), porque el vocabulario, el formato de números y la moneda cambian según el país.
  3. Producto: qué hace, con todos los datos que el usuario proporcione: características, números, lugares, fechas.
  4. Audiencia: para quién es, y qué usan o hacen hoy.
  5. Acción de conversión: la única acción, y qué hace el clic. O envía un formulario (qué campos, y el endpoint si existe, o ninguno aún), o abre una página externa (checkout, reserva, tienda de aplicaciones) en una URL determinada.
  6. Precios: los precios en la estructura que ofrece el negocio.
  7. Pruebas disponibles: testimonios, métricas, nombres de clientes, logotipos, prensa, exactamente como se proporcionan.
  8. Activos disponibles: fotos, capturas de pantalla, logotipo, video, modelos 3D, con las rutas.
  9. Restricciones de marca: colores, tipografías, reglas del logotipo, material de voz, y cualquier cosa requerida o descartada.
  10. Stack: el stack que nombró el usuario. Si no nombró ninguno, escribe detectar; landing-skills:landing-build lo detecta a partir de los archivos del proyecto, es dueño de esa tabla, y escribe el stack resuelto de vuelta en este campo.
  11. Dominio: el dominio de producción. landing-skills:landing-build escribe la URL canónica, og:url, og:image y el mapa del sitio solo cuando se conoce.
  12. Rutas de contacto: correo electrónico, teléfono, dirección, canal de mensajería, horario, según se indique. Van en el pie de página y en la página de error del formulario.
  13. Efectos deseados: movimiento, 3D o efectos de desplazamiento que el usuario pidió, en sus palabras. No son afirmaciones para el texto: la dirección decide su función y landing-skills:landing-motion los construye.

Escribe ninguno cuando el usuario dijo que no hay, y desconocido cuando nadie respondió. Un ejemplo inventado:

# Brief: Afinación Keyline
Tipo: servicio
Idioma: en-GB
Producto: afinación de pianos en casa del cliente en el Gran Mánchester; una afinación toma unos 90 minutos
Audiencia: personas con un piano vertical en casa que no lo han afinado en años
Acción de conversión: reservar una visita mediante un formulario (nombre, código postal, teléfono, semana preferida); endpoint: ninguno aún
Precios: desconocido
Pruebas disponibles: ninguna
Activos disponibles: ninguna
Restricciones de marca: desconocido
Stack: detectar
Dominio: desconocido
Rutas de contacto: teléfono, número desconocido
Efectos deseados: ninguno

Orden de trabajo

  1. Contenido, landing-skills:landing-copy. El texto decide las secciones, su orden y su extensión; un diseño dibujado primero es una plantilla a la que el texto debe adaptarse. Pide al usuario que apruebe landing/copy.md o que responda sus preguntas abiertas. Sin supervisión, continúa e indica que el texto no está aprobado.
  2. Diseño, landing-skills:landing-art-direction. La dirección decide los tokens; el código escrito antes de ellos codifica colores y fuentes predeterminados.
  3. Código, landing-skills:landing-build. La página estática debe funcionar con JavaScript desactivado antes de agregar movimiento, porque es la alternativa cuando un script falla, WebGL no está disponible o el visitante solicita movimiento reducido.
  4. Movimiento, landing-skills:landing-motion. Siempre pásalo por él. Bajo una intención de movimiento ninguno es una breve verificación de los estados de retroalimentación.
  5. Revisión, landing-skills:landing-review, antes de dar el trabajo por terminado. Una página que parece terminada aún puede descartar cada cliente potencial o contener una afirmación que nadie hizo. Terminado significa que landing/review.md comienza con Veredicto: aprobado.
  6. Lanzamiento, landing-skills:landing-launch. Prepara y prueba el lanzamiento localmente; los despliegues, DNS y cambios de cuenta se ejecutan solo con la aprobación explícita del usuario, una regla que esta habilidad posee. Sin supervisión, sin nadie a quien preguntar, detente después de preparar e informa qué está listo para ejecutar.

Después de un fallo, envía cada hallazgo a la habilidad nombrada por su Área (copy, art-direction, build, motion o launch: landing-skills:landing- más el Área), luego revisa de nuevo. Una corrección pasa por los pasos posteriores: una sección agregada al texto necesita una fila de diseño y marcado. Después de incompleto, sirve la página y revisa de nuevo. Después de dos rondas fallidas, detente e informa los hallazgos abiertos al usuario en lugar de repetir.

Transferencias

PasoHabilidadLeeEscribe
Brieflanding-skills:landing-pagela conversación, el proyectolanding/brief.md
Contenidolanding-skills:landing-copylanding/brief.mdlanding/copy.md: un H2 por sección en orden de página, último H2 Marcadores de posición
Diseñolanding-skills:landing-art-directionlanding/brief.md, landing/copy.mdlanding/direction.md, último H2 Intención de movimiento y 3D; landing/tokens.css
Códigolanding-skills:landing-buildlanding/brief.md, landing/copy.md, landing/direction.md, landing/tokens.cssla página estática; para un formulario, form.js, /thanks/ y /form-error/; el HTML plano va en public/ con una copia de tokens.css
Movimientolanding-skills:landing-motionIntención de movimiento y 3D en landing/direction.md, la página estática, landing/tokens.cssmovimiento en la página, en sus propios archivos; tokens.css sin cambios
Revisiónlanding-skills:landing-reviewla página, landing/brief.md, landing/copy.md, landing/direction.md, landing/tokens.csslanding/review.md, landing/review-checklist.md, capturas de pantalla en landing/shots/
Lanzamientolanding-skills:landing-launchla página construida y los nombres de sus campos de formulario; acción de conversión, dominio y rutas de contacto en landing/brief.md; mensajes del formulario en landing/copy.mdconfiguración de alojamiento; cuando el formulario no tiene endpoint, el Worker del formulario y el widget Turnstile agregados al formulario de la build; analíticas y el evento de conversión; landing/launch.md con la lista de verificación

Cada habilidad también funciona sola, para que el usuario pueda empezar desde la mitad. Ejecuta la habilidad que solicite la petición. Necesita estos archivos, y cuando falta uno, maneja el vacío por sí misma (pregunta, o trabaja provisionalmente y lo indica), así que no escribas un archivo faltante solo para desbloquearla:

  • Contenido: landing/brief.md.
  • Dirección de arte: landing/brief.md y landing/copy.md.
  • Construcción: landing/copy.md, landing/direction.md, landing/tokens.css, y landing/brief.md si existe.
  • Movimiento: la página estática, landing/direction.md, landing/tokens.css si está presente.
  • Revisión: solo la página. Revisar un sitio existente usa solo landing-skills:landing-review.
  • Lanzamiento: la página construida.

Cuando falta información

Compara la solicitud con los campos y pregunta por cada uno faltante en un solo mensaje numerado, en dos grupos:

  1. Sin lo que nada puede empezar: los datos del producto, la audiencia, la acción de conversión y qué hace el clic, el idioma y el país.
  2. Lo que tiene un valor predeterminado seguro, indicado en la pregunta para que el usuario pueda aceptarlo: el stack (detectado del proyecto, o HTML plano), efectos deseados (ninguno), el dominio (se omite de la página hasta que se conozca), y el resto.

Nunca llenes un vacío con una audiencia, precio, testimonio, métrica, nombre de cliente o fecha inventados. Una suposición plausible termina siendo una afirmación en la página, y un visitante que detecta una duda de todas las demás líneas.

Cuando el usuario no puede responder, o no se puede preguntar a nadie:

  • Un hecho sobre el negocio (precio, pruebas, audiencia, qué hace el clic, rutas de contacto) se escribe desconocido. landing-skills:landing-copy lo convierte en un [MARCADOR DE POSICIÓN: lo que se necesita] visible y lo lista.
  • Una elección funcional que la página no afirma puede escribirse como asumido: <valor> (razón): el tipo de página y el idioma del mensaje del propio usuario. Registra una variante regional solo cuando sea segura; para español, el país y la forma de tratamiento permanecen desconocidos hasta que se pregunten, porque el texto depende de ellos.

Luego continúa, e informa al usuario qué campos son desconocidos o asumidos.

Individual skills in this repo

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

Skills relacionados