Communitygithub.com

LinXueyuanStdio/viben

Página de lanzamiento mínima previa con captura de correo electrónico, logotipo de la marca y capa decorativa opcional. Lee DESIGN.md para obtener colores, tipografía y reglas de diseño.

¿Qué es viben?

Este skill especializado construye una página de espera (waitlist) previa al lanzamiento, centrada en la identidad de marca y con un único objetivo: capturar correos electrónicos de interesados. Lee el archivo `DESIGN.md` para obtener la paleta de colores, la combinación tipográfica y las reglas espaciales del proyecto, garantizando total coherencia visual. A partir de una plantilla fija (`assets/template.html`), reemplaza tokens validados de texto, colores y fuentes para generar un `index.html` listo para producción. Incluye validaciones estrictas de seguridad (escapado HTML, sanitización de SVG, gramática de colores) y una lista de verificación de calidad (P0 y P1) que debe superar antes de emitir el resultado final. Está diseñado para asistentes de IA como Claude Code o Cursor que necesiten generar landing pages honestas, sin tácticas de escasez artificial ni pruebas sociales falsas.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/LinXueyuanStdio/viben/tree/HEAD/resources/design-templates/waitlist-page

Preguntar en tu IA favorita

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

Documentación

Skill de Página de Espera

Las páginas previas al lanzamiento son tu primer apretón de manos con los futuros usuarios. Este skill construye una entrada enfocada y honesta: tu identidad de marca, lo que estás creando, un camino claro para unirse a la lista temprana. Sin escasez artificial, sin cuentas regresivas falsas, sin tácticas de inflación—solo un recipiente limpio y adaptable para el interés genuino.

Flujo de trabajo

Preparación: Cargar la plantilla sólida y la base de la marca

  1. Cargar la identidad de marca — Lee DESIGN.md para obtener el sistema de colores, la combinación tipográfica y las reglas espaciales. Esta es tu base. Una página de espera vive o muere por la coherencia con la marca que representa. Si DESIGN.md no existe, pide al usuario que proporcione uno antes de continuar.
  2. Leer y copiar la plantilla reutilizable — Lee assets/template.html. Esta plantilla es la semilla sólida para todas las salidas. Cópiala a index.html como tu base. No escribas HTML desde cero ni te desvíes de esta estructura. La plantilla incluye todo el diseño requerido, estructura de formulario, decoraciones, estilos de enfoque y andamios de accesibilidad.

Pasos: Reemplazo de tokens con validación y escapado

  1. Mapear tokens a partir de las entradas — Para cada marcador de posición en la plantilla (ej., {{PRODUCT_NAME}}, {{BG_EXPRESSION}}, {{BORDER_EXPRESSION}}, {{LOGO_MARK}}), sigue las reglas de reemplazo a continuación:
    • Tokens de texto ({{PRODUCT_NAME}}, {{TAGLINE}}): Escapa en HTML <, >, &, ", ' antes de insertarlos en nodos de texto HTML o valores de atributos.
    • Tokens HTML ({{LOGO_MARK}}): Si usas iniciales de texto, escápalas en HTML por defecto. Si usas SVG en línea, debes sanitizarlo estrictamente usando una lista blanca: elimina etiquetas <script>, manejadores de eventos (on*), <foreignObject>, referencias externas (href, xlink:href, url()) y cualquier atributo/elemento no permitido antes de la inserción. Si el SVG no se puede sanitizar de forma segura, recurre a iniciales de texto escapadas. Nunca emitas HTML arbitrario sin sanitizar. Asegúrate de que cualquier SVG escale limpiamente dentro de su contenedor.
    • Tokens de expresión de color ({{BG_EXPRESSION}}, {{FG_EXPRESSION}}, {{ACCENT_EXPRESSION}}, {{DECO_EXPRESSION}}, {{STRIPE_EXPRESSION}}, {{SUCCESS_EXPRESSION}}, {{BORDER_EXPRESSION}}, {{BTN_LABEL_EXPRESSION}}, {{TICKER_BG_EXPRESSION}}, {{TICKER_FG_EXPRESSION}}, {{DECO_STROKE_EXPRESSION}}, {{LOGO_SHADOW_EXPRESSION}}, {{LOGO_FG_EXPRESSION}}): Deben adherirse estrictamente a una gramática de color explícita (#hex, rgb/rgba, hsl/hsla, oklch o color-mix() usando solo variables locales). Rechaza de forma rotunda cualquier entrada que contenga ;, {}, <, >, comentarios (/*), @, url( o referencias externas para prevenir inyección CSS. No los envuelvas en # ni agregues comillas adicionales. Ejemplos: rgba(196, 169, 154, 0.38), color-mix(in srgb, var(--fg) 38%, transparent), #FDE8DF. Insértalos tal cual en las variables CSS :root. Deriva --success de DESIGN.md si está presente; de lo contrario, usa solo el fallback permitido #2D6A4F.
    • Tokens de nombre de fuente ({{DISPLAY_FONT_CSS}}, {{BODY_FONT_CSS}}): Estos son valores de font-family CSS, ya entrecomillados si contienen espacios (ej., 'DM Sans', Syne). Insértalos tal cual en las declaraciones --font-display y --font-body; NO agregues comillas adicionales.
    • Tokens de URL de fuente ({{DISPLAY_FONT_URL}}, {{BODY_FONT_URL}}): Los espacios deben codificarse como + para la URL de Google Fonts (ej., DM+Sans, IBM+Plex+Serif). Valida que la URL esté bien formada antes de insertarla.
  2. Verificar las reglas de mapeo de tokens — Todos los tokens de color ahora están en variables CSS:
    • --bg = {{BG_EXPRESSION}} (ej., #FDE8DF)
    • --fg = {{FG_EXPRESSION}} (ej., #1A1410)
    • --accent = {{ACCENT_EXPRESSION}} (insignia de marca)
    • --deco = {{DECO_EXPRESSION}} (decoración principal)
    • --deco-stripe = {{STRIPE_EXPRESSION}} (franja de acento)
    • --input-border = {{BORDER_EXPRESSION}} (expresión CSS completa con opacidad)
    • --success = {{SUCCESS_EXPRESSION}} o fallback #2D6A4F
    • --btn-label = {{BTN_LABEL_EXPRESSION}} (color del texto del botón para contraste)
    • --ticker-bg = {{TICKER_BG_EXPRESSION}} (fondo del ticker animado)
    • --ticker-fg = {{TICKER_FG_EXPRESSION}} (texto del ticker animado)
    • --deco-stroke = {{DECO_STROKE_EXPRESSION}} (trazos SVG, típicamente atenuados con opacidad del 12–15%)
    • --logo-shadow = {{LOGO_SHADOW_EXPRESSION}} (sombra del contenedor del logotipo, tono de primer plano sutil)
    • --logo-fg = {{LOGO_FG_EXPRESSION}} (color de texto contrastante para las iniciales del logotipo)
  3. Diseño adaptable — La plantilla incluye escalado móvil primero:
    • 375px: el formulario se apila en una sola columna, el logotipo se reduce a 40px, la decoración se comprime, sin desplazamiento horizontal.
    • 768px: espacio cómodo de dos columnas.
    • 1440px+: diseño centrado con espacios generosos.
    • Verifica que todo el texto siga siendo legible y que la entrada de correo electrónico y el botón sean completamente visibles (sin recortes) a 375×667 y 390×844.

Validación: Ejecutar controles de calidad sólidos antes de emitir

  1. Ejecutar la lista de verificación de calidad — Lee references/checklist.md. Valida cada control P0 antes de emitir:
    • Exactamente una CTA (formulario de correo electrónico)
    • Sin contador regresivo, sin prueba social falsa, sin emojis
    • Sin desplazamiento horizontal a 375px
    • La entrada de correo electrónico tiene type="email" y required; el nombre no tiene required
    • El formulario NO usa novalidate; JS usa la protección checkValidity()
    • El mensaje de éxito tiene role="status" o aria-live="polite"
    • Todos los colores provienen de DESIGN.md o del fallback permitido; sin valores hex inventados
    • Todo el texto del usuario está escapado en HTML; los tokens de color se adhieren a una gramática estricta; las fuentes están codificadas en URL
    • Supera P0 o no emitas. Si falla algún control P0, pregunta al usuario o corrige los mapeos de tokens e inténtalo de nuevo.
  2. Verificar controles P1 para una presentación de calidad (recomendado):
    • Estados hover y active en el botón de envío
    • Validación del formulario con comentarios claros
    • La animación del ticker respeta prefers-reduced-motion: reduce
    • Todos los elementos interactivos tienen estilos de enfoque visibles (input:focus incluye outline)
    • Soporte de teclado Tab/Enter
    • Contraste WCAG AA para el texto del cuerpo (≥4.5:1) y la etiqueta del botón (≥4.5:1)
    • El logotipo tiene alt/aria-label presente; el ticker tiene aria-hidden="true"
    • <html lang=""> está configurado

Salida

  1. Emitir HTML limpio — Archivo único, CSS en línea, SVG para gráficos. Marca los elementos interactivos con data-od-id (titular, formulario, logotipo, ticker, cuadrícula, etc.) para que los agentes puedan personalizar sin analizar.

Controles de calidad

Este skill aplica un flujo de trabajo basado en plantillas y sólido para garantizar el cumplimiento. Debes seguir esta ruta de ejecución; desviarte de la plantilla descalifica la salida.

Ejecución obligatoria basada en plantilla:

  • Lee assets/template.html como tu base; no escribas HTML desde cero.
  • Cópialo a index.html y reemplaza solo los tokens {{PLACEHOLDER}} con valores validados/escapados.
  • Ejecuta cada control P0 en references/checklist.md antes de emitir; si alguno falla, corrige y vuelve a validar.

Controles P0 (deben pasar):

  • CTA única: El formulario de correo electrónico es el único elemento interactivo. Sin navegación, sin botones secundarios, sin enlaces a redes sociales.
  • Ubicación del logotipo: Fijo en la esquina superior izquierda, coincide con el color de acento de DESIGN.md, se reduce en móvil (50px → 40px).
  • Consistencia de color: Cada color de la paleta de DESIGN.md. Única excepción codificada permitida: #2D6A4F para --success.
  • Sin antipatrones: Sin contador regresivo, sin prueba social falsa, sin iconos emoji, sin lorem ipsum.
  • Integridad del contenido: El titular y la copia se vinculan directamente a las entradas product_name y tagline—sin copia de relleno.
  • Ajuste móvil: Sin desplazamiento horizontal a 375px. La entrada de correo electrónico y el botón de envío son completamente visibles (sin recortes) a 375×667 y 390×844. El desbordamiento vertical es desplazable, no oculto.
  • Disciplina tipográfica: Solo fuentes display + body (regla de 2 fuentes). Tamaño consistente en todas las secciones.
  • Estructura del formulario: Dos campos (nombre opcional, correo electrónico obligatorio), protección checkValidity(), mensaje de éxito con role="status".
  • Escapado de tokens: Todo el texto proporcionado por el usuario escapado en HTML; los tokens de color se adhieren a una gramática estricta y no contienen caracteres inseguros (;, {}, <, >, /*, @, url(); los nombres de fuente están codificados en URL; {{LOGO_MARK}} son iniciales de texto escapadas o SVG en línea estrictamente sanitizado (sin scripts, sin manejadores de eventos, sin foreignObject, sin hrefs externos).

Controles P1 (deben pasar para una presentación de calidad):

  • La sección hero es visualmente distinta y está en la mitad superior de la página.
  • El botón de envío de correo electrónico tiene estados hover y active.
  • La validación del formulario proporciona comentarios claros.
  • La página se puede desplazar (no recortada) en todos los viewports móviles; la CTA es visible sin desplazamiento.
  • La animación del ticker se pausa/elimina bajo prefers-reduced-motion: reduce.
  • Todos los elementos interactivos tienen estilos de enfoque visibles (outline, no solo outline:none).
  • Teclado: Tab llega a cada campo del formulario; Enter envía.
  • Contraste WCAG AA: Texto del cuerpo ≥4.5:1, etiqueta del botón ≥4.5:1.
  • El logotipo tiene alt/aria-label presente; el ticker tiene aria-hidden="true".
  • <html lang=""> está configurado con el código de idioma correcto.

Restricción de decoración:

  • La zona inferior mejora sin distraer. Opacidad, trazos sutiles, animación atenuada.
  • Sin degradado que abarque más del 20% de la altura del viewport.
  • Espiral, franja, cuadrícula o ticker usan solo colores de DESIGN.md.

Salida

Emitir solo después de que todos los controles P0 en references/checklist.md pasen.

Emitir el artefacto entre etiquetas:

<artifact identifier="waitlist-id" type="text/html" title="Coming Soon — {{PRODUCT_NAME}}">
<!doctype html>
<html lang="es">
...
</html>
</artifact>

Una línea de descripción sobre el artefacto; nada debajo.

Post-emisión: Si el usuario solicita cambios, actualiza el index.html en el lugar y vuelve a ejecutar los controles de la lista P0 antes de emitir la siguiente versión. No omitas la validación en iteraciones.

Skills relacionados