Communitygithub.com

KazmerMaximiliano/neus-ui

Genera un esqueleto de página de marketing sin barra lateral — encabezado fijo, área de contenido principal, pie de página. Produce un wrapper .tsx para landing pages y páginas públicas. Sin AppTemplate.

¿Qué es neus-ui?

Esta habilidad permite crear rápidamente la estructura visual completa de una página de marketing o landing page, proporcionando un layout básico con encabezado fijo, área de contenido principal y pie de página, todo sin barra lateral y sin depender de AppTemplate. Es ideal para desarrolladores que trabajan con el ecosistema Neus UI y necesitan un punto de partida limpio y profesional para páginas públicas. La habilidad soporta tanto modo claro como oscuro, y utiliza recetas CSS específicas para cada modo, garantizando una apariencia coherente y moderna. Durante su ejecución, recopila información clave del usuario (nombre de marca, elementos de navegación, llamado a la acción, color primario, etc.) y genera tres archivos: tipos TypeScript, componente React y estilos CSS. Además, aplica reglas compartidas de calidad, restricciones de propiedades, catálogo de componentes y configuración de tema, todo definido en archivos de reglas auxiliares. Esto asegura que el código generado sea consistente, evita props prohibidas y componentes inexistentes, y sigue las mejores prácticas del ecosistema Neus UI.

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

Preguntar en tu IA favorita

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

Documentación

Neus Layout Landing

Genera un esqueleto de página pública: encabezado fijo + contenido principal + pie de página. Sin AppTemplate, sin barra lateral.

Antes de empezar

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

  • .agents/skills/_shared/anti-slop.md — reglas de calidad obligatorias
  • .agents/skills/_shared/prop-constraints.md — props prohibidas y componentes inexistentes
  • .agents/skills/_shared/component-catalog.md — secciones Button, Link
  • .agents/skills/_shared/theme-config.md — configuración de ThemeProvider
  • .agents/skills/_shared/checklist.md — compuertas P0/P1/P2
  • .agents/skills/_shared/dark-surfaces.md — recetas CSS para modo oscuro (leer cuando Mode: dark)
  • .agents/skills/_shared/light-surfaces.md — recetas CSS para modo claro (leer cuando Mode: light)

Fase 0 — Recopilar Datos

Pregunta en texto libre:

  1. Nombre de la marca/producto (para el logo en el encabezado)
  2. Elementos de navegación del encabezado (enlaces exactos)
  3. ¿CTA en el encabezado? (texto del botón — ej.: "Empieza gratis")
  4. Pie de página: ¿columnas de enlaces o solo derechos de autor?
  5. Color primario del tema
  6. Modo de tema: ¿claro u oscuro? (por defecto: claro)

Fase 1 — Resolución Visual

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

  • Modo: dark → lee dark-surfaces.md; usa lienzo oscuro #0a0a14, navegación tipo vidrio, superficies de vidrio
  • Modo: light → lee light-surfaces.md; usa lienzo var(--color-white), navegación blanca sólida

Declara la directiva:

DIRECTIVA VISUAL
  Modo: dark | light
  Archivo de superficie: dark-surfaces.md | light-surfaces.md

Fase 2 — Generar

Genera tres archivos en este orden: LandingLayout.types.ts → LandingLayout.tsx → LandingLayout.styles.css.

LandingLayout.types.ts

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

export type LandingLayoutProps = {
  children: React.ReactNode;
};

LandingLayout.tsx

import { Button, Link, ThemeProvider } from 'neus-ui';
import './LandingLayout.styles.css';
import type { LandingLayoutProps } from './LandingLayout.types';

export const LandingLayout = ({ children }: LandingLayoutProps) => (
  <ThemeProvider initialTheme={{ primaryColor: '[hex del intake]' }}>
    <div className="landing-layout">
      {/* Encabezado de navegación fijo */}
      <header className="landing-layout__header">
        <div className="landing-layout__header-inner">
          <span className="landing-layout__brand">[NombreDeMarca]</span>
          <nav className="landing-layout__nav">
            {/* Elementos de navegación del intake — type="primary" sobre fondo blanco del encabezado */}
            <Link label="[NavItem1]" type="primary" href="#[sección]" />
          </nav>
          <Button label="[CTA del encabezado]" variant="solid" color="primary" onClick={() => {}} />
        </div>
      </header>

      {/* Contenido de la página */}
      <main className="landing-layout__main">
        {children}
      </main>

      {/* Pie de página */}
      <footer className="landing-layout__footer">
        <span>[NombreDeMarca] © {new Date().getFullYear()}</span>
        <div className="landing-layout__footer-links">
          <Link label="Términos" type="secondary" href="/terminos" />
          <Link label="Privacidad" type="secondary" href="/privacidad" />
        </div>
      </footer>
    </div>
  </ThemeProvider>
);

LandingLayout.styles.css

Aplica el Modo de la DIRECTIVA VISUAL. Usa las recetas de superficie del archivo de superficie resuelto.

Modo claro (Mode: light):

.landing-layout { min-height: 100vh; display: flex; flex-direction: column; background: var(--color-white); }
.landing-layout__header {
  position: sticky;
  top: 0;
  z-index: 100;
  background: rgba(255, 255, 255, 0.85);
  backdrop-filter: blur(20px);
  -webkit-backdrop-filter: blur(20px);
  border-bottom: 1px solid var(--color-border-light);
}
.landing-layout__header-inner {
  max-width: 1200px;
  margin: 0 auto;
  padding: 1rem 2rem;
  display: flex;
  justify-content: space-between;
  align-items: center;
  gap: 2rem;
}
.landing-layout__brand {
  font-family: var(--font-display);
  font-size: 1.25rem;
  font-weight: 700;
  color: var(--color-primary);
}
.landing-layout__nav { display: flex; gap: 1.5rem; align-items: center; }
.landing-layout__main { flex: 1; }
.landing-layout__footer {
  padding: 1.5rem 2rem;
  display: flex;
  justify-content: space-between;
  align-items: center;
  border-top: 1px solid var(--color-border-light);
  font-size: 0.9rem;
  color: var(--color-gray-500);
}
.landing-layout__footer-links { display: flex; gap: 1rem; }

Modo oscuro (Mode: dark) — usar en lugar de las reglas de modo claro:

.landing-layout { min-height: 100vh; display: flex; flex-direction: column; background: #0a0a14; color: #e2e8f0; }
.landing-layout__header {
  position: sticky;
  top: 0;
  z-index: 100;
  background: rgba(10, 10, 20, 0.8);
  backdrop-filter: blur(20px);
  -webkit-backdrop-filter: blur(20px);
  border-bottom: 1px solid rgba(255, 255, 255, 0.06);
}
/* (header-inner, brand, nav, main — igual que en modo claro) */
.landing-layout__brand { color: #818cf8; }
.landing-layout__footer {
  padding: 1.5rem 2rem;
  display: flex;
  justify-content: space-between;
  align-items: center;
  border-top: 1px solid rgba(255, 255, 255, 0.08);
  font-size: 0.9rem;
  color: #64748b;
}

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 componentes. CSS solo en .styles.css.

Importaciones

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

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

Tipos

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

React 19 — Sin FormEvent

Nunca import { FormEvent } from 'react'. Usa <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 lienzo oscuro
  • Button size: "small" | "medium" | "large"
  • Card variant: "default" | "glass" — "glass" para lienzo oscuro
  • Badge color: "primary" | "success" | "error" | "info" | "neutral"
  • Link type: "primary" (marca) | "secondary" (gris atenuado)
  • 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 arrays de datos hardcodeados cuando los datos provienen de API — usar props tipadas
  • Sin contenido inventado (testimonios falsos, nombres de relleno, métricas falsas)
  • Sin tipo TypeScript any
  • Sin etiquetas HTML <a>, <span>, <input>, <button> cuando existe un componente de 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 simples — usar <Card variant="glass">

Individual skills in this repo

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

Skills relacionados