Communitygithub.com

supersite-build

Constructor quirúrgico de sitios web para agentes de IA. Lee el contrato de especificación supersite-plan.md, genera componentes React/Next.js limpios y componibles, conecta tokens de diseño y verifica la compilación con npm run build.

¿Qué es supersite-build?

supersite-build es una habilidad de agente de IA que ejecuta el plan arquitectónico definido por /supersite-plan. Lee el archivo supersite-plan.md, parsea los parámetros de diseño (como la paleta de colores, tipografía y manifiesto de rutas), y genera automáticamente componentes React/Next.js modulares. El proceso incluye la creación de tipos TypeScript, configuración centralizada, primitivas de UI como Container, Button y Card, y bloques de sección completos como Navbar, Hero y Pricing. Finalmente, ensambla las rutas, realiza una auditoría anti-slop para evitar estilos genéricos o prohibidos, y ejecuta npm run build para garantizar una compilación limpia. Es compatible con proyectos Next.js modernos y sigue un pipeline estricto de cinco pasos para producir sitios web profesionales y verificables.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/developer-mohanaditya/supersite/tree/HEAD/skills/supersite-build

Preguntar en tu IA favorita

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

Documentación

🔨 supersite-build: Constructor Quirúrgico

supersite-build ejecuta el plan arquitectónico establecido por /supersite-plan. Lee supersite-plan.md, construye componentes atómicos, conecta tokens de diseño y copia, y valida la implementación contra el motor de compilación.


El Pipeline de Ejecución

┌─────────────────────────────────────────────────────────────┐
│ 1. Leer y Validar el Contrato de Especificación            │
│ Parsear tokens, rutas y manifiesto desde supersite-plan.md │
├─────────────────────────────────────────────────────────────┤
│ 2. Andamiaje, Tipos y Configuración                         │
│ Crear src/types/site.ts, src/config/site.ts y CSS base      │
├─────────────────────────────────────────────────────────────┤
│ 3. Construir Primitivas de UI                               │
│ Container, SectionHeader, Button, Badge y Card              │
├─────────────────────────────────────────────────────────────┤
│ 4. Construir Bloques de Sección                             │
│ Navbar, Hero, Contrast, Features, Proof, Pricing y Footer   │
├─────────────────────────────────────────────────────────────┤
│ 5. Ensamblar Rutas y Verificar Compilación                   │
│ Cablear páginas, verificar accesibilidad y ejecutar npm run build │
└─────────────────────────────────────────────────────────────┘

Paso 1: Leer y Validar supersite-plan.md

  1. Buscar supersite-plan.md en la raíz del espacio de trabajo.
    • Si falta, pausar e informar al usuario:

      "No se encontró supersite-plan.md en la raíz del proyecto. Ejecute /supersite-plan para diseñar su plan de forma colaborativa, o ejecute /supersite <prompt> para generar directamente."

  2. Parsear los parámetros arquitectónicos del plan:
    • Género estético y paleta de colores (Hex/OKLCH, distribución 60-30-10).
    • Elecciones de tipografía y radio de esquina.
    • Manifiesto de rutas y componentes.
    • Copia de secciones, titulares y elementos interactivos.

Paso 2: Andamiaje, Tipos y Configuración

  1. Verificar Dependencias:
    • Asegurar que las utilidades estándar estén presentes (lucide-react, clsx, tailwind-merge). Instalar si faltan:
      npm install lucide-react clsx tailwind-merge
      
  2. Generar Contratos TypeScript (src/types/site.ts):
    • Definir tipos para NavItem, FeatureItem, PricingPlan, Testimonial y FAQItem.
  3. Generar Configuración Centralizada (src/config/site.ts):
    • Almacenar enlaces de navegación, metadatos de marca y contenido estructurado de secciones en un solo lugar.
  4. Actualizar CSS Base (src/app/globals.css):
    • Inyectar variables de color, estilos de selección y el bloque de accesibilidad de movimiento reducido:
      @layer base {
        ::selection {
          background-color: var(--accent);
          color: var(--accent-foreground);
        }
      }
      
      @media (prefers-reduced-motion: reduce) {
        *, ::before, ::after {
          animation-duration: 0.01ms !important;
          animation-iteration-count: 1 !important;
          transition-duration: 0.01ms !important;
          scroll-behavior: auto !important;
        }
      }
      

Paso 3: Construir Primitivas de UI (src/components/ui/)

Generar primitivas modulares:

  • container.tsx: Contenedor de ancho máximo (max-w-6xl o max-w-7xl) con padding responsive.
  • section-header.tsx: Bloque estandarizado de badge, título y descripción.
  • button.tsx: Botón basado en variantes (primary, secondary, outline, ghost) con estilos explícitos :focus-visible.
  • badge.tsx: Chips de estado y píldoras con bordes finos.
  • card.tsx: Envoltorio de superficie que aplica el color de superficie, borde y tokens de radio del plan.

Paso 4: Construir Bloques de Sección (src/components/site/)

Construir cada sección especificada en el plan:

  • navbar.tsx: Cabecera responsive con enlaces de navegación de escritorio, CTA de acción y menú hamburguesa móvil.
  • hero.tsx: Píldora de gancho, título H1, párrafo principal, grupo de CTAs y vista previa interactiva del producto (por ejemplo, terminal o marco de UI).
  • problem-contrast.tsx: Contraste visual asimétrico que ilustra el dolor del status quo versus la solución moderna.
  • feature-grid.tsx: Cuadrícula bento asimétrica o celdas de características modulares. Sin copias repetitivas de 3 tarjetas.
  • product-showcase.tsx: Componente interactivo (explorador de código con pestañas, vista previa interactiva en vivo o área de juegos de configuración).
  • social-proof.tsx: Llamadas a métricas verificables y citas de testimonios de clientes con roles de ingeniería específicos.
  • pricing-matrix.tsx: Alternancia de facturación Mensual/Anual (con "use client"), tarjetas de niveles, listas de verificación de características y CTAs de pago.
  • faq-accordion.tsx: Preguntas y respuestas técnicas expandibles utilizando transiciones suaves de altura con CSS grid.
  • footer.tsx: Enlaces de navegación multicolumna, anclajes legales, punto de estado del sistema y derechos de autor.

Paso 5: Ensamblar Rutas y Verificar Compilación

  1. Ensamblar src/app/page.tsx:
    • Importar componentes de sección y componer el diseño narrativo en JSX limpio y declarativo.
  2. Ensamblar Rutas Adicionales:
    • Si el plan especificó rutas multipágina (/features, /pricing, /security), construir los archivos page.tsx correspondientes.
  3. Ejecutar Auditoría Anti-Slop Pre-Vuelo:
    • Verificar estilos prohibidos: sin manchas de gradiente púrpura, sin tarjetas sin fundamento, sin copia de marcador de posición genérica.
    • Verificar objetivos táctiles: confirmar que las áreas interactivas de impacto tengan ≥44×44px.
    • Verificar guiones largos: confirmar que no haya guiones largos (— o --) en ninguna copia de UI, titulares, microcopia o etiquetas de botón.
  4. Compilar y Puerta de Compilación:
    • Ejecutar el comando de compilación del espacio de trabajo:
      npm run build
      
    • Si ocurre algún error de TypeScript o falta una importación, corregirlo inmediatamente y re-ejecutar hasta que la compilación pase limpiamente con código 0.
  5. Informar al Usuario:
    • En todas las respuestas conversacionales e informes de progreso, hacer cumplir la Regla de Cero Guiones Largos (nunca usar — o --). Usar puntos, dos puntos, comas o paréntesis en su lugar.
    • Proporcionar un resumen limpio de los archivos construidos con enlaces clicables:
      • [supersite-plan.md](file:///path/to/supersite-plan.md)
      • [page.tsx](file:///path/to/src/app/page.tsx)
      • Enlaces a componentes individuales en src/components/site/
    • Confirmar la compilación exitosa.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados