Communitygithub.com

KazmerMaximiliano/neus-ui

Genera una página de aterrizaje SaaS completa con héroe, características, prueba social, precios y CTA en el pie de página.

¿Qué es neus-ui?

Este skill genera automáticamente una página de aterrizaje (landing page) completa para productos SaaS, utilizando la biblioteca de componentes Neus UI (Button, Card, Link). La página incluye secciones clave como héroe (hero), características (features), prueba social opcional (testimonios o métricas), precios opcionales (pricing) y un llamado a la acción (CTA) en el pie de página. Es importante destacar que esta página es de marketing público y no utiliza AppTemplate ni componentes de dashboard. El skill sigue un proceso estructurado en fases: primero recopila datos del usuario (nombre del producto, características, CTAs, modo claro/oscuro, personalidad visual), luego resuelve la dirección visual (modo claro u oscuro) y finalmente genera tres archivos: ProductLanding.types.ts (tipos), ProductLanding.tsx (componente React) y ProductLanding.styles.css (estilos). Está diseñado para usarse siempre que el usuario solicite una

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/KazmerMaximiliano/neus-ui/tree/HEAD/.agents/skills/neus-landing-saas

Preguntar en tu IA favorita

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

Documentación

Neus Landing SaaS

Genera una página de aterrizaje de producto con héroe, características, prueba social opcional, precios opcional y CTA en el pie de página.

IMPORTANTE: Esta página NO utiliza AppTemplate. Es una página de marketing pública.

Antes de comenzar

La sección "Reglas Compartidas" más abajo está siempre activa. Además, lee:

  • .agents/skills/_shared/anti-slop.md — reglas de calidad obligatorias (sección "Páginas de Marketing")
  • .agents/skills/_shared/prop-constraints.md — props prohibidas y componentes inexistentes
  • .agents/skills/_shared/component-catalog.md — secciones Button, Card, Link
  • .agents/skills/_shared/theme-config.md — configuración de ThemeProvider
  • .agents/skills/_shared/design-personality.md — formato DIRECTRIZ VISUAL, eje de personalidad
  • .agents/skills/_shared/checklist.md — compuertas P0/P1/P2
  • .agents/skills/_shared/dark-surfaces.md — recetas CSS para modo oscuro (leer cuando el Modo sea: oscuro)
  • .agents/skills/_shared/light-surfaces.md — recetas CSS para modo claro (leer cuando el Modo sea: claro)
  • .agents/skills/_shared/layout-patterns.md — patrones avanzados opcionales para landing
  • references/landing-sections.md — patrones de secciones

Fase 0 — Recopilar Datos

Haz al usuario estas preguntas y espera su respuesta completa antes de generar:


Precios — ¿La página de aterrizaje incluirá una sección de precios?

  • Sí, con planes y precios (recomendado) — sección con tarjetas de plan de precios
  • No, solo héroe + características + CTA — landing sin precios

Prueba social — ¿Incluirá prueba social (testimonios o métricas)?

  • Sí, testimonios/métricas reales — el usuario las proporcionará
  • Sin prueba social — omitir completamente la sección de testimonios

Incluye también en tu respuesta:

  • Nombre del producto y eslogan (1 línea)
  • Características a destacar (máximo 6, exactas: título + descripción breve)
  • CTA principal: texto del botón + destino
  • Si hay precios: planes (nombre + precio + período + características incluidas — exactas)
  • Si hay prueba social: testimonios o métricas exactas (si dijo "no", omitir completamente)
  • Color primario del tema (hex o "usar predeterminado")
  • Elementos de navegación del encabezado (enlaces de navegación)
  • Modo del tema: claro u oscuro? (predeterminado: claro)
  • Personalidad visual: limpia/aireada, editorial/capas, audaz/cinética, o estructurada? (opcional)

Fase 1 — Resolución Visual

Antes de escribir cualquier código, resuelve la DIRECTRIZ VISUAL:

  • Modo: oscuro → lee dark-surfaces.md; usa canvas #0a0a14, navegación tipo vidrio, <Card variant="glass"> para características, botones con color="white" en el héroe
  • Modo: claro → lee light-surfaces.md; usa canvas var(--color-white), <Card> estándar, botones con color="primary"

Declara:

DIRECTRIZ VISUAL
  Modo: oscuro | claro
  Personalidad: [de la captura o predeterminado: Estructurada]
  Archivo de superficie: dark-surfaces.md | light-surfaces.md

Fase 1b — Verificación P0

  • CERO datos inventados — todo proviene de la captura o el usuario indicó explícitamente qué usar
  • Sin AppTemplate, sin Sidebar
  • Características exactas de la captura (no agregar extras "intuitivos")
  • Si dijo "sin prueba social" → cero testimonios en la salida

Fase 2 — Generar Artefacto

Lee references/landing-sections.md para los patrones de cada sección.

Produce tres archivos en este orden: ProductLanding.types.ts → ProductLanding.tsx → ProductLanding.styles.css.

ProductLanding.types.ts

export type NavItem = {
  label: string;
  href: string;
};

export type Feature = {
  icon: string;
  title: string;
  description: string;
};

export type PricingPlan = {
  name: string;
  price: string;
  period: string;
  features: string[];
  cta: string;
  highlighted?: boolean;
};

export type ProductLandingProps = {
  // Contenido de marketing estático — sin props de API
  onGetStarted?: () => void;
};

Estructura base del componente

import { Button, Card, Link } from 'neus-ui';
import './ProductLanding.styles.css';
import type { ProductLandingProps } from './ProductLanding.types';

export const ProductLanding = ({ onGetStarted }: ProductLandingProps) => {
  return (
    <div className="landing">
      {/* 1. Encabezado de navegación */}
      <header className="landing__nav">...</header>

      {/* 2. Héroe */}
      <section className="landing__hero">
        <h1>[Nombre del Producto] — [Eslogan de la captura]</h1>
        <p>[Subtítulo de la captura]</p>
        <div className="landing__hero-cta">
          <Button label="[CTA de la captura]" variant="solid" color="primary" />
          {/* Enlace secundario en el héroe: usar type="primary" — el héroe tiene fondo claro */}
          <Link label="Ver cómo funciona" type="primary" href="#features" />
        </div>
      </section>

      {/* 3. Características (características exactas de la captura) */}
      <section className="landing__features">
        <h2>Características</h2>
        <div className="landing__features-grid">
          {/* Card por característica — exactamente como se especificó */}
        </div>
      </section>

      {/* 4. Prueba social (solo si se solicitó y se proporcionaron datos) */}
      {/* 5. Precios (solo si se solicitó) */}
      {/* 6. Pie de página CTA */}
      {/* 7. Pie de página */}
    </div>
  );
};

Tarjeta de Característica

Usa Card con los slots icon, title y description:

<Card
  icon={<SomeIcon size={24} color="var(--color-primary)" />}
  title="[Título de característica de la captura]"
  description="[Descripción de característica de la captura]"
/>

Tarjeta de Precios

Usa Card con la prop highlighted. Compón el contenido completo en children:

<Card highlighted={plan.highlighted}>
  {plan.highlighted && <span className="pricing__badge">Más popular</span>}
  <p className="pricing__name">{plan.name}</p>
  <div className="pricing__amount">
    <span className="pricing__price">{plan.price}</span>
    <span className="pricing__period">{plan.period}</span>
  </div>
  <ul className="pricing__features">
    {plan.features.map((f) => (
      <li key={f}><span aria-hidden="true">✓</span> {f}</li>
    ))}
  </ul>
  <Button
    label={plan.cta}
    variant={plan.highlighted ? "solid" : "outlined"}
    color="primary"
    fullWidth
  />
</Card>

Componentes Faltantes de Neus UI

  • NavigationBar: <header> con navegación flex — documentar como pendiente
  • TestimonialCard: Usar Card con avatarImage + contenido blockquote (si se solicita)

Fase 3 — ProductLanding.styles.css

Aplica el Modo de la DIRECTRIZ VISUAL. Consulta la sección sobre landing de .agents/skills/_shared/layout-patterns.md para patrones avanzados opcionales (fila de estadísticas, división encabezado-sección, cuadrícula showcase del héroe, cuadrícula compacta de tarjetas, píldora tipo ceja).

@keyframes neus-fade-up {
  from { opacity: 0; transform: translateY(16px); }
  to   { opacity: 1; transform: translateY(0); }
}

/* Modo claro (predeterminado) */
.landing { font-family: var(--font-display); }
.landing__nav {
  position: sticky;
  top: 0;
  z-index: 100;
  display: flex;
  justify-content: space-between;
  align-items: center;
  padding: 1rem 2rem;
  /* Navegación tipo vidrio clara */
  background: rgba(255, 255, 255, 0.85);
  backdrop-filter: blur(20px);
  -webkit-backdrop-filter: blur(20px);
  border-bottom: 1px solid rgba(0, 0, 0, 0.06);
}
/* Navegación modo oscuro — aplicar cuando Modo: oscuro */
/* .landing__nav { background: rgba(10, 10, 20, 0.8); border-bottom: 1px solid rgba(255,255,255,0.06); } */
.landing__hero {
  display: grid;
  grid-template-columns: 1.4fr 0.6fr;
  align-items: center;
  gap: 3rem;
  padding: 6rem 2rem;
  max-width: 1200px;
  margin: 0 auto;
}
/* Si no hay elemento visual en el lado derecho, usar centrado de una columna: */
/* .landing__hero { text-align: center; padding: 6rem 2rem; max-width: 800px; margin: 0 auto; } */
.landing__hero h1 {
  font-family: var(--font-display);
  font-size: clamp(2.5rem, 6vw, 4rem);
  font-weight: 800;
  letter-spacing: -0.03em;
  color: var(--color-gray-900);
  margin-bottom: 1rem;
  animation: neus-fade-up 0.5s ease forwards;
}
/* H1 modo oscuro — opción de texto degradado */
/* .landing__hero h1 { color: #e2e8f0; }
   Aplicar .neus-gradient-text en el elemento H1 para efecto de texto degradado */
.landing__hero p {
  font-size: 1.25rem;
  color: var(--color-gray-600);
  margin-bottom: 2rem;
  animation: neus-fade-up 0.5s 0.1s ease both;
}
.landing__hero-cta {
  display: flex;
  gap: 1rem;
  align-items: center;
  margin-top: 1.5rem;
  animation: neus-fade-up 0.5s 0.2s ease both;
}
.landing__features { padding: 6rem 2rem; max-width: 1200px; margin: 0 auto; }
.landing__features h2 {
  font-family: var(--font-display);
  text-align: center;
  font-size: 2rem;
  font-weight: 700;
  margin-bottom: 3rem;
  color: var(--color-gray-900);
}
/* Característica principal: primera tarjeta ocupa todo el ancho */
.landing__features-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(280px, 1fr)); gap: 2rem; }
.landing__features-grid > *:first-child { grid-column: 1 / -1; }
/* Animación escalonada de tarjetas */
.landing__features-grid > *:nth-child(1) { animation: neus-fade-up 0.5s 0.05s ease both; }
.landing__features-grid > *:nth-child(2) { animation: neus-fade-up 0.5s 0.15s ease both; }
.landing__features-grid > *:nth-child(3) { animation: neus-fade-up 0.5s 0.25s ease both; }
.landing__features-grid > *:nth-child(4) { animation: neus-fade-up 0.5s 0.35s ease both; }
/* Fondos de sección alternados */
.landing__features-alt { background: var(--color-primary-light); }
/* Pie de página CTA */
.landing__cta-section { background: var(--color-primary-light); padding: 6rem 2rem; text-align: center; }

/* Anulaciones de modo oscuro en la página — aplicar cuando Modo: oscuro */
/* .landing { background: #0a0a14; color: #e2e8f0; } */
/* .landing__features h2 { color: #e2e8f0; } */
/* .landing__features-alt { background: rgba(20,20,40,0.4); } */
/* .landing__cta-section { background: rgba(99,102,241,0.1); border-top: 1px solid rgba(129,140,248,0.2); } */

Reglas Compartidas (Incrustadas)

Estas reglas están siempre activas. Se aplican incluso si los archivos _shared/ no se leen.

Salida — siempre tres archivos

Cada salida de skill: NombreComponente.types.ts → NombreComponente.tsx → NombreComponente.styles.css. Sin estilos en línea (style={{}}). Sin etiquetas <style> dentro de componentes. CSS solo en .styles.css.

Importaciones

import { Button, Card, Input, Badge, Link, Select, Modal, DataTable } from 'neus-ui';

Nunca importar desde rutas internas como ../../components/Button/Button.

Tipos

Todas las declaraciones type / interface → NombreComponente.types.ts. Nunca declarar tipos en .tsx.

React 19 — Sin FormEvent

Nunca import { FormEvent } from 'react'. Usar <Button type="submit" onClick={...} /> en su lugar.

Restricciones de Props de Componentes

  • Button variant: "solid" | "outlined" | "text" — "ghost" NO existe
  • Button color: "primary" | "success" | "error" | "info" | "white" — "white" solo para canvas oscuro
  • Button size: "small" | "medium" | "large"
  • Card variant: "default" | "glass" — "glass" para canvas oscuro
  • Badge color: "primary" | "success" | "error" | "info" | "neutral"
  • Link type: "primary" (marca) | "secondary" (gris apagado)
  • Select: sin prop required — manejar validación externamente
  • FormTemplate: solo children, submitLabel, loading — sin onSubmit/onCancel

Lista Negra de Slop

  • Sin estilos en línea / style={{}} / etiquetas <style>
  • Sin arreglos de datos hardcodeados cuando los datos provienen de API — usar props tipadas
  • Sin copia inventada (testimonios falsos, nombres de marcador de posición, métricas falsas)
  • Sin tipo TypeScript any
  • Sin etiquetas <a>, <span>, <input>, <button> sin procesar cuando exista un componente Neus UI
  • Sin pilas de fuentes hardcodeadas — usar var(--font-display) / var(--font-mono)
  • En modo oscuro: sin var(--color-primary-light) como fondo de sección; sin tarjetas div sin procesar — usar <Card variant="glass">

Individual skills in this repo

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

Skills relacionados