Communitygithub.com

Neus Landing Genérica

Genera una landing page flexible y de uso general con sección hero, bloques de contenido y CTA. Produce un archivo .tsx utilizando los componentes Button, Card y Link de Neus UI. Sin AppTemplate.

¿Qué es Neus Landing Genérica?

Esta skill genera una landing page adaptable para propósitos generales como portafolios, empresas, agencias, eventos o blogs. Utiliza componentes de Neus UI como Button, Card y Link para construir una página pública sin AppTemplate. El proceso se divide en fases: recopilación de datos del usuario (nombre, headline, secciones, CTA, tema, modo claro/oscuro y personalidad visual), resolución visual (mapeo de paletas y personalidad), verificación de calidad P0 y generación de tres archivos: tipos TypeScript, componente React y estilos CSS. Soporta modos claro y oscuro, con recetas específicas para superficies y patrones de layout. Es ideal cuando se solicita una landing genérica (no SaaS) y se adapta automáticamente a la intención del usuario mediante directivas visuales y reglas compartidas.

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

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Neus Landing Genérica?

Genera una landing page de uso general con sección hero, bloques de contenido y CTA. Se adapta al propósito del usuario.

IMPORTANTE: Sin AppTemplate. Página pública.


Antes de empezar

La sección "Reglas Compartidas" a continuación está siempre activa. Además, lee TODAS estas antes de la Fase 0:

  • .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 de Button, Card, Link, Input
  • .agents/skills/_shared/design-personality.md — ejes de personalidad, formato DIRECTIVA VISUAL, recetas de superficies en modo oscuro de la Sección 9
  • .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/checklist.md — compuertas P0/P1/P2
  • .agents/skills/_shared/layout-patterns.md — patrones de landing (fila de estadísticas, división sección-cabecera, pastilla hero, navegación adaptable al modo)
  • .agents/skills/neus-landing-generic/references/dark-landing-patterns.md — anatomía del layout de secciones y patrones JSX para landings en modo oscuro

Fase 0 — Recopilar datos

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


  1. ¿Qué tipo de página es? (portafolio, empresa, evento, agencia, blog, personal, otro)
  2. Nombre de la página / marca
  3. Titular principal (H1) — puede incluir una palabra destacada para efecto degradado
  4. Subtítulo o tagline
  5. Secciones a incluir (enumera exactamente — no añadas más)
  6. CTA principal: etiqueta + acción
  7. CTA secundaria (opcional): etiqueta + acción
  8. Color de tema principal (hex o descripción)
  9. Modo: claro u oscuro?
  10. Personalidad: limpia/aireada, editorial/capas, audaz/cinética, o estructurada? (si no sabes, describe la vibra)
  11. ¿Incluye formulario de contacto o newsletter? (sí/no — especifica cuál)

Fase 1 — Resolución Visual

Antes de escribir cualquier código, resuelve la DIRECTIVA VISUAL a partir de las respuestas obtenidas.

Mapeo de paleta:

  • Colores vibrantes / enérgicos → Vibrante
  • Tonos neutros / apagados / grises → Neutro
  • Azules / verdes corporativos → Corporativo
  • Púrpura / rosa / creativo → Creativo

Mapeo de personalidad desde la Q10:

  • limpio / minimalista / aireado → Aireado
  • editorial / capas / asimétrico → Capas
  • audaz / fuerte / cinético → Cinético
  • estructurado / formal / denso en datos → Estructurado

Construye este bloque y llévalo a la Fase 2:

DIRECTIVA VISUAL:
- Paleta: [Vibrante / Neutro / Corporativo / Creativo]
- Personalidad: [Cinético / Aireado / Estructurado / Capas]
- Modo: [claro / oscuro]
- Animación: [neus-fade-up en .hero-copy / ninguno]
- Layout: [hero asimétrico 2 columnas 1.4fr/0.6fr / hero centrado]
- H1: [clamp(2.5rem,6vw,4rem) weight-800 / clamp(2rem,4vw,3rem) weight-700]
- Texto degradado: [sí — palabra destacada: "[palabra]" / no]
- Superficies: [glass (dark-surfaces.md) / estándar var(--color-white)]
- Nav: [glass sticky / estándar sticky / ninguno]

Regla de modo oscuro: Si Modo: oscuro, TODAS las superficies usan las recetas de dark-surfaces.md. Nunca uses var(--color-white) como fondo de página o sección. Usa <Card variant="glass"> para tarjetas de contenido — es la superficie glass de Neus UI. Nunca lo reemplaces por un <div> plano + CSS personalizado.

Regla de modo claro: Si Modo: claro, usa <Card> de Neus UI para tarjetas de contenido, var(--color-primary-light) para fondos de secciones alternas, var(--color-white) para la raíz de la página.


Fase 2 — Verificación P0

  • Secciones de salida == secciones de la recopilación (Q5). Cero extras.
  • Sin texto inventado — todo el texto proviene de la recopilación o está explícitamente impulsado por props
  • Sin AppTemplate ni barra lateral
  • DIRECTIVA VISUAL construida y llevada adelante
  • Modo oscuro: todas las superficies usan recetas glass, sin fondos var(--color-white)
  • Modo claro: <Card> de Neus UI usado para contenido, primary-light para secciones alternas

Fase 3 — Generar Artefacto

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


NombrePagina.types.ts

import type { BadgeColor } from 'neus-ui';

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

// Añadir tipos específicos de sección derivados solo de la recopilación
export type Article = {
  id: string;
  title: string;
  href?: string;
  excerpt?: string;
  author?: string;
  meta?: string;
  categories?: string[];
};

// Categoría → mapeo de color de Badge (modo oscuro: 4 colores visualmente distintos)
export const BADGE_COLOR: Record<string, BadgeColor> = {
  systems:  "primary",
  design:   "error",
  craft:    "neutral",
  tools:    "success",
  featured: "primary",
};

export type NombrePaginaProps = {
  // Props solo para datos que vienen de fuera (lista de artículos, manejadores de formularios, etc.)
  // El texto de marketing estático está hardcodeado en el componente — nunca como prop
};

NombrePagina.tsx

Estructura de modo oscuro — uso correcto de componentes:

import { useState } from 'react';
import { Button, Card, Link, Input, Badge } from 'neus-ui';
import './NombrePagina.styles.css';
import type { NombrePaginaProps, Article } from './NombrePagina.types';
import { BADGE_COLOR } from './NombrePagina.types';

export const NombrePagina = ({ articles, onSubscribe }: NombrePaginaProps) => {
  const [email, setEmail] = useState('');
  const [subscribed, setSubscribed] = useState(false);
  const [loading, setLoading] = useState(false);

  const handleSubscribe = () => {
    setLoading(true);
    onSubscribe?.(email);
    setSubscribed(true);
    setLoading(false);
  };

  return (
    <div className="nombre-pagina">
      {/* Capas decorativas de fondo — aria-hidden, sin interacción */}
      <div className="nombre-pagina__mesh" aria-hidden="true" />
      <div className="nombre-pagina__grid" aria-hidden="true" />

      <div className="nombre-pagina__content">
        {/* Nav glass sticky — los enlaces usan <Link type="secondary"> */}
        <nav className="nombre-pagina__nav">
          <div className="nombre-pagina__nav-brand">
            <div className="nombre-pagina__brand-mark" aria-hidden="true">P</div>
            <span className="nombre-pagina__brand-name">NombrePagina</span>
          </div>
          <div className="nombre-pagina__nav-links">
            {navItems.map(item => (
              <Link key={item.href} type="secondary" href={item.href} label={item.label} />
            ))}
          </div>
          <Button label="Suscribirse" variant="solid" color="primary" size="small" onClick={() => {}} />
        </nav>

        <main>
          {/* Hero — asimétrico 2 columnas */}
          <section className="nombre-pagina__hero" aria-labelledby="nombre-pagina-title">
            <div className="nombre-pagina__hero-copy">
              {/* Pastilla eyebrow — div plano (sin equivalente en Neus UI) */}
              <div className="nombre-pagina__eyebrow-pill">
                <span className="nombre-pagina__eyebrow-dot" aria-hidden="true" />
                NOMBREPAGINA
                <span aria-hidden="true">/</span>
                PALABRACLAVE
              </div>
              <h1 id="nombre-pagina-title">
                Titular{" "}
                <span className="gradient-text">destacado</span>
              </h1>
              <p className="nombre-pagina__hero-sub">Tagline de la recopilación.</p>
              <div className="nombre-pagina__hero-cta">
                <Button label="CTA Principal" variant="solid" color="primary" onClick={() => {}} />
                <Button label="CTA Secundaria" variant="outlined" color="primary" onClick={() => {}} />
              </div>
            </div>
            <div className="nombre-pagina__hero-visual">
              {/* Card destacado o panel de arte — ver dark-landing-patterns.md §4 */}
            </div>
          </section>

          {/* Secciones de contenido de la recopilación — usa <Card variant="glass"> para tarjetas */}
          {/* Ejemplo de sección de cuadrícula de artículos: */}
          <section className="nombre-pagina__articles">
            <div className="nombre-pagina__article-grid">
              {articles?.map(article => (
                <Card variant="glass" key={article.id} onClick={() => {}}>
                  <div className="nombre-pagina__article-inner">
                    <div className="nombre-pagina__pill-row">
                      {article.categories?.map(cat => (
                        <Badge
                          key={cat}
                          variant="solid"
                          color={BADGE_COLOR[cat] ?? "neutral"}
                          label={cat}
                        />
                      ))}
                    </div>
                    <h3>{article.title}</h3>
                    {article.excerpt && <p className="nombre-pagina__article-dek">{article.excerpt}</p>}
                  </div>
                </Card>
              ))}
            </div>
          </section>

          {/* Sección de newsletter (si se solicita) */}
          <section className="nombre-pagina__newsletter" aria-labelledby="nombre-pagina-nl-title">
            <div className="nombre-pagina__nl-card">
              <p className="nombre-pagina__sec-eyebrow">Newsletter</p>
              <h2 id="nombre-pagina-nl-title">
                Mantente al día.{" "}
                <span className="gradient-text">Sin ruido.</span>
              </h2>
              {subscribed ? (
                <p className="nombre-pagina__nl-success">✓ ¡Estás suscrito — gracias!</p>
              ) : (
                <div className="nombre-pagina__nl-form">
                  <Input
                    name="newsletter-email"
                    type="email"
                    label="Correo electrónico"
                    placeholder="[email protected]"
                    value={email}
                    onChange={setEmail}
                    required
                  />
                  <Button
                    label="Suscribirse"
                    type="submit"
                    variant="solid"
                    color="primary"
                    loading={loading}
                    onClick={handleSubscribe}
                  />
                </div>
              )}
            </div>
          </section>
        </main>

        {/* Footer — enlaces usan <Link type="secondary"> */}
        <footer className="nombre-pagina__footer">
          <span>© {new Date().getFullYear()} NombrePagina.</span>
          <div className="nombre-pagina__footer-links">
            <Link type="secondary" href="/privacidad" label="Privacidad" />
            <Link type="secondary" href="/contacto" label="Contacto" />
          </div>
        </footer>
      </div>
    </div>
  );
};

Estructura de modo claro: Omite los divs de mesh/grid y el contenedor de contenido. Usa <Card> (sin variant) para tarjetas de contenido. Alterna fondos de sección con background: var(--color-primary-light). Usa <Link type="primary"> para enlaces principales, <Link type="secondary"> para nav/footer. Las pastillas de categoría siguen usando <Badge>.

Tile de características (ambos modos):

  • <Card variant="glass" icon={...} title="..." description="..." /> (oscuro)
  • <Card icon={...} title="..." description="..." /> (claro)

Formulario de contacto (si se solicita): Usa campos <Input> de Neus UI + <Button type="submit">. Mismo patrón que el newsletter pero sin el wrapper de tarjeta con brillo.


NombrePagina.styles.css

Modo oscuro: Comienza con las recetas de canvas + mesh + grid + contenido de dark-surfaces.md §1. Luego añade nav glass (§3), nl-card (§4), pastilla eyebrow (§5), texto degradado (§6), panel de arte (§8 si se destaca), fila meta (§9 si hay artículos), footer (§10). Sin CSS personalizado para tarjetas — <Card variant="glass"> lo maneja. Aplica el layout de dark-landing-patterns.md.

Modo claro: Comienza con background: var(--color-white); color: var(--color-gray-900). Usa var(--color-primary-light) para fondos de secciones alternas. Sigue design-personality.md Secciones 4–5 para tipografía y espaciado.

Ambos modos:

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

.nombre-pagina__hero-copy {
  animation: neus-fade-up 0.5s ease both;
}

/* Utilidad de texto degradado */
.gradient-text {
  background: linear-gradient(135deg, #22d3ee 0%, #818cf8 45%, #d946ef 100%);
  -webkit-background-clip: text;
  -webkit-text-fill-color: transparent;
  background-clip: text;
}

/* Contenedores de ancho máximo */
.nombre-pagina__hero,
.nombre-pagina__articles,
.nombre-pagina__newsletter,
.nombre-pagina__footer {
  max-width: min(72rem, 100%);
  margin: 0 auto;
}

/* Padding de secciones */
.nombre-pagina__hero       { padding: 6rem 2rem; }
.nombre-pagina__articles   { padding: 6rem 2rem; }
.nombre-pagina__newsletter { padding: 5rem 2rem; }

/* Cuadrícula del hero */
.nombre-pagina__hero {
  display: grid;
  grid-template-columns: 1.4fr 0.6fr;
  gap: 3rem;
  align-items: center;
}

/* H1 */
.nombre-pagina__hero h1 {
  font-family: var(--font-display);
  font-size: clamp(2.5rem, 6vw, 4rem);
  font-weight: 800;
  letter-spacing: -0.04em;
  line-height: 0.98;
  margin: 0.5rem 0 1rem;
}

/* Formulario de newsletter — fila flex */
.nombre-pagina__nl-form {
  display: flex;
  gap: 1rem;
  align-items: flex-end;
  max-width: 520px;
  margin: 0 auto;
}

/* Cuadrícula de artículos */
.nombre-pagina__article-grid {
  display: grid;
  grid-template-columns: repeat(3, 1fr);
  gap: 1.5rem;
}

/* Fila de pastillas */
.nombre-pagina__pill-row {
  display: flex;
  flex-wrap: wrap;
  gap: 0.5rem;
  margin-bottom: 0.75rem;
}

/* Responsivo */
@media (max-width: 960px) {
  .nombre-pagina__hero { grid-template-columns: 1fr; }
  .nombre-pagina__article-grid { grid-template-columns: 1fr; }
}
@media (max-width: 640px) {
  .nombre-pagina__hero,
  .nombre-pagina__articles,
  .nombre-pagina__newsletter { padding: 5rem 1.25rem; }
}

Reglas Compartidas (Incrustadas)

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

Salida — siempre tres archivos

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

Importaciones

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

Nunca …

Individual skills in this repo

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

Skills relacionados