Communitygithub.com

xenxorowdy/product-landing-site

Construye un sitio de marketing de una página distintivo y accesible para un producto de software — Next.js App Router, componentes servidor, módulos CSS, un sistema tipográfico serifa más sans ancha, un color de señal, una maqueta del producto en vivo en el héroe, una historia del producto impulsada por scroll, una demostración interactiva, precios, FAQ y un pie de página con marca grande. Úsalo cuando el usuario solicite una landing page, sitio de marketing, página de producto, página de lanzamiento, página de descarga o 'un sitio como el de Kesami' para una app, herramienta o SaaS, incluso si nunca dice 'skill' o menciona la pila. También úsalo para reestilizar o extender un sitio existente que siga este patrón.

¿Qué es product-landing-site?

Este skill proporciona una receta completa para construir un sitio de marketing de una página para un producto de software, inspirado en el sitio de Kesami. Está diseñado para desarrolladores que desean una página estática, rápida, accesible y con diseño cuidado, sin depender de bibliotecas de UI pesadas o Tailwind. El flujo de trabajo guía al usuario desde la recopilación de información del producto (nombre, promesa, precio, color de marca) hasta la generación del sitio con Next.js App Router, componentes de servidor, módulos CSS y un sistema de diseño con un solo color de acento. El skill incluye un scaffold completo, scripts para derivar tonos de acento accesibles, capturas de pantalla automatizadas y referencias detalladas sobre diseño, secciones, animación, accesibilidad y redacción. Las secciones del sitio se construyen con un patrón consistente: etiqueta, título decorativo, párrafo opcional y un llamado a la acción. La interactividad se limita a pequeñas 'islas' de cliente que manipulan atributos DOM o variables CSS, evitando re-renders. El skill es ideal para contextos donde el usuario necesita una landing page atractiva y funcional de forma rápida, garantizando buena relación de contraste, navegación por teclado y contenido veraz sobre el producto.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add xenxorowdy/product-landing-site

Preguntar en tu IA favorita

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

Documentación

Sitio de landing page de producto

Una receta, destilada del sitio de marketing de Kesami, para una única página estática que parece diseñada en lugar de basada en plantillas y que resiste el escrutinio: contraste verificado, amigable con el teclado, honesta sobre el producto, rápida.

El resultado es una página de Next.js compuesta por secciones renderizadas en el servidor. La interactividad se limita a unas pocas pequeñas "islas" de cliente que modifican atributos DOM o variables CSS en lugar de re-renderizar. No hay biblioteca de UI, ni Tailwind, ni biblioteca de animación.

Qué se incluye

RutaUso
assets/scaffold/Un sitio completo y construible (verificado con typecheck y next build). Cópialo, no lo reescribas. Contenido de relleno, sistema de diseño funcional.
assets/optional-sections/Tres secciones adicionales del sitio original (una comparación antes/después, un árbol de archivos de límite de datos, un muro de scripts) como ejemplos prácticos. No están conectadas.
scripts/accent.mjsDeriva los tonos de acento seguros para contraste de cualquier color de marca.
scripts/capture.cjsCaptura pantallas del sitio en ejecución en tamaños de escritorio y móvil, avanzando a través del scroll, mediante una ventana de Electron fuera de pantalla.
references/design-system.mdTokens, temas, tipografía, espaciado, la lógica de contraste de acento y por qué existe cada uno. Léelo antes de cambiar colores o tipografía.
references/section-patterns.mdCada sección: para qué sirve, cómo se construye, el truco que la hace económica. Léelo antes de añadir o modificar una sección.
references/motion-and-a11y.mdPresupuesto de movimiento, movimiento reducido, sin JS, objetivos táctiles, trampas de hidratación. Léelo antes de añadir cualquier animación o código de cliente.
references/copy-and-facts.mdVoz, la regla de un solo escenario y cómo mantener las afirmaciones verdaderas. Léelo antes de redactar el copy.
references/verify.mdLa lista de verificación y comandos para ejecutar antes de dar el sitio por terminado.

Flujo de trabajo

1. Recopilar entradas (mira antes de preguntar)

Primero lee el README del producto, el manifiesto del paquete, el código de precios/planes y el flujo de trabajo de lanzamiento; la mayoría de las respuestas están ahí. Pregunta al usuario solo por lo que no se puede encontrar. Necesitas:

  • Nombre del producto, promesa en una frase, para quién es y la única cosa que lo diferencia.
  • Plataformas, precios y límites de planes, cada uno con el archivo que es la fuente de verdad.
  • Un color de marca (cualquier hex), o permiso para elegir uno. Elige un solo color y úsalo como el único color de señal.
  • Si existe una fuente de visualización con licencia. Si no, el sustituto de licencia abierta del scaffold (Instrument Serif) está bien.
  • Qué secciones aplicar. Conjunto por defecto: Hero, ticker, Cómo funciona, Pregunta/demo, Precios, FAQ, Cierre, Pie de página. Añade Privacidad, Idiomas o una comparación antes/después cuando el producto tenga una historia que lo requiera.
  • Dónde vive el sitio. Por defecto: una carpeta website/ en el repositorio del producto, un paquete independiente fuera de cualquier espacio de trabajo npm para que las instalaciones de la app y el archivo de bloqueo no se toquen.

2. Scaffold

cp -R ~/.claude/skills/product-landing-site/assets/scaffold <target>/website
cd <target>/website && npm install && npx tsc --noEmit && npx next build

Ejecuta la compilación una vez antes de editar para asegurarte de que la línea base esté en verde. Mona Sans se obtiene de Google Fonts en tiempo de compilación y luego se sirve desde el propio sitio, por lo que la primera compilación necesita red.

3. Marca

  1. node ~/.claude/skills/product-landing-site/scripts/accent.mjs <brand-hex> imprime --accent, --accent-display, el tinte plano y si la etiqueta del botón debe ser tinta o blanco. Ponlos en app/globals.css (--brand, --brand-hover, --brand-tint, --accent, --accent-display) y reemplaza los valores fijos #ff5e00 / #e25300 en app/icon.svg y app/opengraph-image.tsx.
  2. Redibuja la marca en components/Logo.tsx y Logo.module.css (el marcador de posición son cuatro barras de voz). Mantenlo como divs o SVG en línea, nunca un ráster.
  3. Establece SITE en lib/site.ts (nombre, slug, marca, titular, lead, CTA, nota). El slug también asigna un espacio de nombres a la preferencia de moneda en localStorage.

Por qué el script en lugar de hacerlo a ojo: un color de marca saturado casi nunca alcanza 4.5:1 como texto sobre un fondo claro, por lo que la página necesita el color de marca para rellenos y un tono más oscuro para el texto. Adivinar el tono hermano es cómo los sitios terminan con contraste fallido.

4. Hechos antes del copy

Llena lib/site.ts (planes, plataforma, enlaces, FAQ) a partir de los propios archivos fuente del producto, y registra la fuente de cada hecho en el README.md del sitio bajo "De dónde vienen los hechos". Mantén la procedencia en el README en lugar de en comentarios de código, para que el scaffold se mantenga libre de comentarios. Si el repositorio objetivo o el usuario solicita comentarios explicativos, sigue eso en su lugar.

Luego lee references/copy-and-facts.md y redacta el copy.

5. Un escenario, compartido en todas partes

lib/demo.ts contiene un único escenario ficticio del cual se alimentan la maqueta del héroe, la historia del producto y la demostración interactiva. Reemplázalo con un escenario del propio dominio del producto (tickets de soporte, un pull request, un calendario, una hoja de cálculo, una reunión). Debido a que cada sección lee los mismos datos, la página nunca se contradice, y la demo puede mostrar honestamente el contrato real del producto (por ejemplo, cada afirmación cita su fuente).

6. Secciones

Comienza con las nueve del scaffold. Para cada sección decide: ¿qué única idea lleva, y cuál es la única imagen que la prueba en lugar de describirla? Lee references/section-patterns.md. Sigue la gramática de la sección:

  • chip de etiqueta (.label, con data-scramble), luego un h2.display.h2 con las últimas palabras en .em, luego un .lead opcional
  • las secciones alternan data-theme="light" / "paper" para que cada una comience en un borde de color, no en una línea de regla
  • un botón relleno por viewport; todo lo demás es un enlace de texto con el subrayado de la marca
  • las maquetas de producto usan data-theme="dark" y tamaños en px, porque representan capturas de pantalla de la app (oscura). Si la app es clara, haz las maquetas claras.

7. Verificar

Sigue references/verify.md. En resumen: typecheck, compilación, capturas de pantalla a 1440 y 390 con scripts/capture.cjs, léelas, avanza por el scroll para confirmar que las revelaciones se activan, verifica el modo de movimiento reducido y sin JS, vuelve a ejecutar accent.mjs --check para cualquier nuevo color de texto. Informa cualquier cosa no verificada en lugar de insinuar que lo fue.

No negociables, y por qué

  • Componentes de servidor por defecto; islas de cliente solo para comportamiento. La página es HTML estático que funciona sin JS y cuesta casi nada de hidratar. Las islas escriben atributos data-* o variables CSS y dejan que CSS haga el trabajo visual.
  • Solo tokens semánticos en los componentes. Los componentes leen --bg, --fg, --accent; el data-theme de una sección los intercambia. Así es como un componente puede estar en Canvas, blanco, el tinte o una maqueta oscura sin ediciones.
  • Tamaños de texto en rem, maquetas en px. El tamaño de texto del navegador del lector debe aplicarse a la página; las maquetas son representantes de capturas de pantalla.
  • El texto atenuado retrocede por color, nunca por opacidad. La opacidad reduce silenciosamente el contraste por debajo de 4.5:1.
  • El copy nunca supera al producto. Sin plataformas no lanzadas, sin dirección de soporte que no exista, sin "nada sale de tu dispositivo" si el audio se transmite a un servidor. Una página de marketing que promete de más es un error.
  • No hay control de pausa de animación incorporado. El movimiento en bucle se detiene para prefers-reduced-motion. La revisión de diseño de Kesami declinó deliberadamente un control de pausa, por lo que el scaffold no tiene ninguno; ofrece uno si el usuario lo desea.

Extender más allá del scaffold

Inventa nuevas secciones con los mismos primitivos en lugar de importar una biblioteca: propiedades personalizadas de CSS para estado, un IntersectionObserver por comportamiento, details/summary para divulgación, position: sticky para scrollytelling, @property para animar variables. Si te encuentras recurriendo a framer-motion o un paquete de carrusel, relee references/motion-and-a11y.md primero; la respuesta es casi siempre una variable CSS y un atributo.

Skills relacionados