Construcción de Sitios Web
Crea sitios web distintivos y de grado de producción que eviten la estética genérica de "AI slop". Cada elección — tipografía, color, movimiento, diseño — debe ser intencional. Despliega como paquetes estáticos HTML/CSS/JS a S3.
Este skill cubre todo para proyectos web. Cuando se carga mediante load_skill("website-building"), todos los archivos se copian a workspace/. Lee los subarchivos según sea necesario según el tipo de proyecto. Para aplicaciones web, carga el skill hijo: load_skill("website-building/webapp").
Los principios de diseño universales (filosofía del color, paleta predeterminada, selección de tipografía) se comparten con otros skills a través de design-foundations. Los archivos compartidos de este skill extienden esas bases con implementación específica para web (variables CSS, tokens responsivos, hojas de estilo base). No necesitas cargar design-foundations por separado — las versiones específicas para web en shared/ son completas.
Usa read con la ruta completa, p. ej. shared/01-design-tokens.md
Enrutamiento por Tipo de Proyecto
Paso 1: Identifica el tipo de proyecto y carga la guía específica del dominio:
| Tipo de Proyecto | Acción | Ejemplos |
|---|---|---|
| Sitios informativos | read informational/informational.md | Sitios personales, portafolios, editorial/blogs, pequeñas empresas, landing pages |
| Aplicaciones web | load_skill("website-building/webapp") | Productos SaaS, dashboards, paneles de administración, e-commerce, experiencias de marca |
| Juegos de navegador | read game/game.md + game/game-testing.md | Juegos 2D Canvas, Three.js/WebGL, juegos HTML5, experiencias 3D interactivas |
Paso 2: Lee los archivos compartidos — lee shared/01-design-tokens.md y shared/02-typography.md primero (obligatorio para TODOS los tipos de proyecto, incluyendo webapp). Estos establecen los valores predeterminados del sistema de diseño Nexus y las reglas de tipografía que se aplican universalmente. Para aplicaciones web y dashboards, omite los archivos marcados con † a continuación — esos contienen detalles de implementación preconfigurados en la plantilla fullstack.
Si el usuario dice solo "sitio web" o "web" sin detalles, pregunta qué tipo o usa el informativo por defecto.
Referencia de Subarchivos
Compartidos (shared/) — Cada proyecto
| Archivo | Cubre | Carga |
|---|---|---|
shared/01-design-tokens.md | Escala tipográfica, espaciado, paleta Nexus, base.css | Siempre |
shared/02-typography.md | Selección de tipografía, emparejamiento, carga, lista negra | Siempre |
shared/04-layout.md | Composición espacial, responsive, mobile-first | Siempre † |
shared/05-taste.md | Skeleton loaders, estados vacíos/error, pulido | Siempre |
shared/08-standards.md | Accesibilidad, rendimiento, antipatrones | Siempre |
shared/09-technical.md | Estructura del proyecto, sandbox, despliegue, lista de verificación | Siempre † |
shared/03-motion.md | Animaciones de scroll, librería Motion, plugins SVG de GSAP, hover/cursor | Cuando tenga animaciones |
shared/06-css-and-tailwind.md | Tailwind CSS v3, shadcn/ui, CSS moderno | Cuando use Tailwind |
shared/07-toolkit.md | Librerías CDN, React, Three.js, iconos, mapas, patrones/filtros SVG, esm.sh | Al elegir librerías |
shared/10-charts-and-dataviz.md | Chart.js, Recharts, D3, KPIs, sparklines | Cuando se necesite visualización de datos |
shared/11-web-technologies.md | Versiones de frameworks, compatibilidad con navegadores | Al verificar compatibilidad |
shared/12-playwright-interactive.md | QA persistente con navegador Playwright, capturas de pantalla, pruebas visuales | Al hacer pruebas |
shared/19-backend.md | Servidores FastAPI/Express/Flask, WebSocket, SSE, reenvío de puertos | Cuando se necesite backend |
shared/20-llm-api.md | Chat LLM, generación de imagen/video/audio, transcripción — modelos, credenciales, helpers SDK | Cuando el sitio use APIs de IA/LLM |
Todas las rutas son relativas a ``.
† Omitir para webapp y dashboards — detalles de implementación preconfigurados en la plantilla fullstack. Design-tokens y typography NO se omiten — proporcionan los valores predeterminados autoritativos del sistema de diseño y la guía de selección de tipografía para todos los tipos de proyecto.
Específicos del Dominio — Carga uno
| Archivo | Cuándo cargar |
|---|---|
load_skill("website-building/webapp") | SaaS, dashboard, administración, e-commerce, experiencia de marca (skill hijo con plantilla fullstack) |
skills/website-building/webapp/dashboards.md | Dashboard o interfaz densa en datos (compañero de webapp) |
informational/informational.md | Sitio personal, portafolio, editorial, pequeña empresa, landing |
game/game.md | Juego de navegador, Three.js, WebGL, 3D interactivo |
game/2d-canvas.md | Juego 2D Canvas (compañero de game.md) |
game/game-testing.md | Cualquier juego de navegador — cárgalo junto con game.md |
QA interactivo: Lee shared/12-playwright-interactive.md para automatización persistente del navegador con Playwright (capturas de pantalla, pruebas funcionales, QA visual). Requerido para pruebas de juegos, útil para cualquier sitio complejo.
Flujo de Trabajo
- Dirección de Diseño: Aclara el propósito, elige una dirección estética
- Control de Versiones: Ejecuta
git initen el directorio del proyecto después del scaffolding. Haz commit después de cada hito importante con un mensaje corto. - Construye: Construye el sitio página por página, tomando capturas de pantalla mediante Playwright para QA visual
- Publica: Haz commit de todos los cambios, luego
deploy_website()devuelve la URL pública
Usa Cada Herramienta
- Investiga primero. Busca en la web sitios de referencia, tendencias y ejemplos de la competencia antes de diseñar. Navega por ejemplos galardonados del tipo de sitio específico. Obtén cualquier URL que proporcione el usuario.
- Genera assets reales — generosamente. Genera imágenes para héroes, ilustraciones de secciones, imágenes visuales de características editoriales, fondos atmosféricos — no solo una imagen de héroe. Cada página larga debe tener un ritmo visual con imágenes generadas que coincidan con la dirección artística del sitio. Sin placeholders. Genera un logotipo SVG personalizado para cada proyecto (ver más abajo) — SVG es solo para logotipos a menos que el usuario solicite explícitamente salida SVG. Guarda imágenes de referencia web que informen la dirección.
- Captura de pantalla mediante Playwright (solo sitios complejos). Para sitios de varias páginas, aplicaciones web, dashboards y juegos, lee
skills/website-building/shared/12-playwright-interactive.mdpara capturar pantalla en escritorio (1280px+) y móvil (375px). Omite Playwright para sitios estáticos de una sola página simples — ver QA visual a continuación. - Escribe código de producción directamente. HTML, CSS, JS, SVG. Usa bash para herramientas de construcción y procesamiento de archivos.
Generación de Logotipo SVG
Cada proyecto recibe un logotipo SVG personalizado en línea. Nunca sustituyas un encabezado de texto estilizado.
- Comprende la marca — propósito, tono, una palabra definitoria
- Escribe SVG directamente — formas geométricas, letras o marcas abstractas. Una forma memorable.
- Principios: Geométrico/mínimo (Paul Rand, Vignelli). Funciona a 24px y 200px. Monocromo primero — agrega color como mejora. Usa
currentColorpara modo oscuro/claro. - Implementa en línea con
aria-label,viewBox,fill="none", trazoscurrentColor - Genera un favicon — versión simplificada de 32x32 si es necesario
Para animación SVG (DrawSVG, MorphSVG), consulta shared/03-motion.md. Para patrones/filtros SVG, consulta shared/07-toolkit.md.
Proceso de Pruebas QA Visual
Cuándo usar Playwright QA
Omite Playwright para sitios simples. Los sitios estáticos de una sola página NO necesitan capturas de pantalla con Playwright. Revisa el código directamente, luego despliega. Playwright QA agrega tiempo significativo y no vale la pena para contenido estático simple.
Usa Playwright para sitios complejos. Sitios de varias páginas, aplicaciones web, dashboards, juegos y cualquier sitio con características interactivas (formularios, carritos, filtros, gráficos, arrastrar y soltar) DEBE usar Playwright QA. Lee skills/website-building/shared/12-playwright-interactive.md para automatización persistente del navegador.
Proceso de Playwright QA (solo sitios complejos)
Ciclo: Construir → Playwright QA → Evaluar → Arreglar → Repetir → Desplegar cuando esté listo
Etapa 1: QA Página por Página
Después de construir cada página:
- Captura de pantalla en escritorio (1280px+) y móvil (375px) mediante Playwright
- Evalúa críticamente: ¿Se ve profesionalmente diseñado (no generado por IA)? ¿Es la tipografía distintiva? ¿El espacio en blanco es generoso? ¿Hay una jerarquía visual clara?
- Arregla cada problema antes de continuar. Sin deuda visual.
Etapa 2: QA Final (antes de publicar)
- Captura de pantalla de cada página en escritorio y móvil
- Verifica consistencia entre páginas (espaciado, color, tratamiento de tipografía)
- Verifica el modo oscuro (captura de pantalla de ambos temas para la página de inicio como mínimo)
- Verifica estados interactivos: hover, focus, active, loading, empty, error
- Prueba de primera impresión en frío: ¿se siente pulido e intencional?
Fallos de QA: desbordamiento de texto, espaciado inconsistente, colores fuera de los tokens, modo oscuro faltante, móvil aplastado, apariencia genérica de IA, contenido placeholder, logotipo faltante.
Paso 1: Dirección de Arte — Infiere Antes de Preguntar, Pregunta Antes de Usar el Valor por Defecto
Cada sitio debe tener una identidad visual derivada de su contenido. No saltes a la paleta de respaldo Nexus. La paleta Nexus es un último recurso para cuando tanto la inferencia como la pregunta han fallado — no un valor por defecto conveniente.
- Infiera del tema. Un sitio de tostador de café → marrones terrosos, crema cálida, sensación dibujada a mano. Un dashboard fintech → pizarra fría, sans-serif afilada, denso en datos. Una aplicación de aprendizaje infantil → primarios brillantes, tipografía redondeada, movimiento lúdico. El contenido mismo te dice la paleta, la tipografía y el espaciado antes de que el usuario diga una palabra.
- Consulta las tablas de Dirección de Arte. Cada archivo de dominio (
informational.md,webapp/SKILL.md,game/game.md) tiene una tabla de Dirección de Arte que mapea tipos de sitio/producto a direcciones basadas en concepto y puntos de partida de tokens. Úsalas como trampolín. - Deriva los cinco pilares: Color (cálido/frío, acento del tema), Tipografía (serif/sans, personalidad de display), Espaciado (denso/generoso), Movimiento (mínimo/expresivo), Imaginería (foto/ilustración/solo tipografía).
- Si el tema es genuinamente ambiguo, pregunta — "¿Qué ambiente buscas?" y "¿Algún sitio de referencia?" Una pregunta es suficiente.
- Respaldo Nexus — solo cuando la inferencia Y la pregunta no produzcan nada. Si se le preguntó al usuario y no dio dirección, Y el tema no da una señal clara, entonces recurre a los valores por defecto Nexus/Suizos.
El Respaldo: Limpio y Suizo (Último Recurso)
Cuando la inferencia no dio una dirección clara Y se le preguntó al usuario pero no dio guía de estilo, usa los valores por defecto de shared/01-design-tokens.md con:
- Tipografía: Satoshi o General Sans para cuerpo (Fontshare — preferido), o Inter/DM Sans. Contraste de peso sobre contraste de fuente. Máximo 3-4 tamaños. Mantén el texto compacto —
--text-3xl/--text-heroson solo para héroes de sitios informativos. - Color: Paleta Nexus. Superficies neutras + un acento verde azulado solo para CTAs.
- Diseño: Alineado a cuadrícula. Márgenes generosos. Asimétrico donde sea interesante.
- Movimiento: Mínimo, funcional. Solo transiciones de estado suaves.
- Imaginería: Genera imágenes limpias y relevantes. Sin fotos de stock.
Dirección de Arte — Evita la Estética de IA
Consulta shared/08-standards.md para la lista completa de antipatrones.
Paso 2: Publica
Llama a deploy_website() con la ruta del proyecto y el nombre del sitio. Devuelve una URL pública de S3. Para actualizar, edita los archivos locales y vuelve a desplegar con la misma ruta. Consulta shared/09-technical.md para la llamada exacta y ejemplos.