Construcción de Sitios Web
Crea sitios web distintivos y de calidad profesional que eviten la estética genérica de "IA slop". Cada elección — tipo, color, animación, maquetación — debe ser intencional. Despliega como paquetes estáticos de HTML/CSS/JS en S3.
Esta skill cubre todo para proyectos web. Cuando se carga mediante load_skill("website-building"), todos los archivos se copian a workspace/skills/website-building/. Lee los subarchivos según sea necesario según el tipo de proyecto. Para aplicaciones web, carga la skill hija: load_skill("website-building/webapp").
Principios de diseño universales (filosofía del color, paleta predeterminada, selección de fuentes) se comparten con otras skills a través de design-foundations. Los archivos compartidos de esta skill extienden esos fundamentos con una 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, por ejemplo, skills/website-building/shared/01-design-tokens.md
Router de Detección de Frameworks
Antes de enrutar por tipo de proyecto, identifica el framework:
| Señal | Framework | Acción |
|---|---|---|
package.json tiene dependencia "next" O existe next.config.* | Next.js | Lee skills/website-building/nextjs/SKILL.md primero |
package.json tiene dependencia "react-native" o "expo" | React Native | Lee skills/website-building/react-native/SKILL.md primero |
package.json tiene solo "react" (Vite/CRA/Remix) | React (no Next) | Usa skills/website-building/webapp/SKILL.md con la guía estándar de Tailwind |
Sin package.json, solo archivos .html | HTML/CSS/JS Vanilla | Continúa con los archivos compartidos estándar |
Los archivos específicos del framework proporcionan:
- Los comandos de configuración exactos y números de versión a usar
- La integración de Tailwind específica del framework (v4 para Next.js, NativeWind para RN)
- Patrones de enrutamiento, obtención de datos y componentes específicos del framework
- Guía de despliegue para el framework
Después de leer el archivo del framework, regresa al enrutamiento de tipo de proyecto de esta skill (a continuación) para cargar la guía de diseño específica del dominio (informativo/aplicación web/juego).
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 skills/website-building/informational/informational.md | Sitios personales, portafolios, editoriales/blogs, pequeñas empresas, páginas de aterrizaje |
| Aplicaciones web | load_skill("website-building/webapp") | Productos SaaS, paneles de control, paneles de administración, comercio electrónico, experiencias de marca |
| Juegos de navegador | read skills/website-building/game/game.md + skills/website-building/game/game-testing.md | Juegos en 2D Canvas, Three.js/WebGL, juegos HTML5, experiencias 3D interactivas |
Paso 2: Lee los archivos compartidos — lee skills/website-building/shared/01-design-tokens.md y skills/website-building/shared/02-typography.md primero (obligatorio para TODOS los tipos de proyecto, incluida la aplicación web). Estos establecen los valores predeterminados del sistema de diseño Nexus y las reglas tipográficas que se aplican universalmente. Para aplicaciones web y paneles de control, omite los archivos marcados con † a continuación — aquellos 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 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 fuentes, emparejamiento, carga, lista negra | Siempre |
shared/04-layout.md | Composición espacial, responsive, móvil primero | Siempre † |
shared/05-taste.md | Skeleton loaders, estados vacíos/de error, pulido | Siempre |
shared/08-standards.md | Accesibilidad, rendimiento, antipatrones | Siempre |
shared/09-technical.md | Estructura del proyecto, sandbox, despliegue, checklist | Siempre † |
shared/pplx_attribution.html | Bloque de atribución para <head> | Siempre † |
shared/03-motion.md | Animaciones de scroll, librería Motion, plugins SVG de GSAP, hover/cursor | Cuando se anima |
shared/06-css-and-tailwind.md | Tailwind CSS v3, shadcn/ui, CSS moderno | Cuando se usa 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 necesitan visualizaciones de datos |
shared/11-web-technologies.md | Versiones de frameworks, compatibilidad de navegadores | Al verificar compatibilidad |
shared/12-playwright-interactive.md | QA con navegador Playwright persistente, capturas de pantalla, pruebas visuales | Al probar |
shared/19-backend.md | Servidores FastAPI/Express/Flask, WebSocket, SSE, reenvío de puertos | Cuando se necesita backend |
shared/20-llm-api.md | Chat LLM, generación de imagen/video/audio, transcripción — modelos, credenciales, helpers SDK | Cuando el sitio usa APIs de IA/LLM |
Todas las rutas son relativas a skills/website-building/.
† Omitir para aplicaciones web y paneles de control — detalles de implementación preconfigurados en la plantilla fullstack. Los tokens de diseño y la tipografía NO se omiten — proporcionan los valores predeterminados autoritativos del sistema de diseño y la guía de selección de fuentes para todos los tipos de proyecto.
Específicos del Dominio — Carga uno
| Archivo | Cuándo cargar |
|---|---|
load_skill("website-building/webapp") | SaaS, panel de control, administración, comercio electrónico, experiencia de marca (skill hija con plantilla fullstack) |
webapp/dashboards.md | Panel de control o interfaz densa en datos (compañero de webapp) |
informational/informational.md | Sitio personal, portafolio, editorial, pequeña empresa, aterrizaje |
game/game.md | Juego de navegador, Three.js, WebGL, 3D interactivo |
game/2d-canvas.md | Juego en 2D Canvas (compañero de game.md) |
game/game-testing.md | Cualquier juego de navegador — carga junto con game.md |
QA interactivo: Lee skills/website-building/shared/12-playwright-interactive.md para automatización de navegador persistente 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: Clarifica el propósito, elige una dirección estética
- Construye: Construye el sitio página por página, tomando capturas de pantalla mediante Playwright para QA
- Publica:
deploy_website()devuelve una 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 el usuario proporcione.
- Genera activos reales — generosamente. Genera imágenes para héroes, ilustraciones de secciones, imágenes de características editoriales, fondos atmosféricos — no solo una imagen principal. Cada página larga debe tener un ritmo visual con imágenes generadas que coincidan con la dirección artística del sitio. Sin marcadores de posición. 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. Lee
skills/website-building/shared/12-playwright-interactive.mdpara tomar capturas en escritorio (1280px+) y móvil (375px). Compara con las referencias. Esto es obligatorio, no opcional. Consulta QA Visual más abajo. - 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 obtiene un logotipo SVG personalizado en línea. Nunca sustituyas un encabezado de texto con estilo.
- 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. Monocromático 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
Cada despliegue debe pasar las QA visuales. Las capturas de pantalla son puertas de calidad.
Lee skills/website-building/shared/12-playwright-interactive.md para todas las QA visuales. Playwright proporciona una sesión de navegador persistente para capturas de pantalla, pruebas de interacción y verificación de viewport.
Ciclo: Construir → QA con Playwright → 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 diseñado profesionalmente (no generado por IA)? ¿La tipografía es distintiva? ¿Los espacios en blanco son generosos? ¿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 la consistencia entre páginas (espaciado, color, tratamiento tipográfico)
- Verifica el modo oscuro (captura de pantalla de ambos temas para la página de inicio como mínimo)
- Verifica los 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 token, falta de modo oscuro, móvil aplastado, aspecto genérico de IA, contenido de marcador de posición, logotipo faltante.
Paso 1: Dirección Artística — Infiere Antes de Preguntar, Pregunta Antes de Usar Valores Predeterminados
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 predeterminado conveniente.
- Infiera del tema. Un sitio de tostador de café → marrones terrosos, crema cálida, sensación dibujada a mano. Un panel de control fintech → pizarra fría, sans-serif nítida, denso en datos. Una aplicación de aprendizaje infantil → colores primarios brillantes, tipo redondeado, animación divertida. 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 Artística. Cada archivo de dominio (
informational.md,webapp/SKILL.md,game/game.md) tiene una tabla de Dirección Artística que mapea tipos de sitio/producto a direcciones impulsadas por 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 visualización), Espaciado (denso/generoso), Animación (mínimo/expresivo), Imágenes (foto/ilustración/solo tipo).
- 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 arrojan nada. Si al usuario se le ha preguntado y no dio dirección, Y el tema no da una señal clara, entonces recurre a los valores predeterminados de Nexus/Swiss.
El Respaldo: Limpio y Suizo (Último Recurso)
Cuando la inferencia no arrojó una dirección clara Y se le preguntó al usuario pero no dio guía de estilo, usa los valores predeterminados de skills/website-building/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-herosolo para héroes de sitios informativos. - Color: Paleta Nexus. Superficies neutras + un acento verde azulado solo para CTA.
- Maquetación: Alineado a cuadrícula. Márgenes generosos. Asimétrico donde sea interesante.
- Animación: Mínimo, funcional. Solo transiciones de estado suaves.
- Imágenes: Genera imágenes limpias y relevantes. Sin fotos de archivo.
Dirección Artística — Evita la Estética IA
Consulta skills/website-building/shared/08-standards.md para la lista completa de antipatrones.
Paso 2: Publicar
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 skills/website-building/shared/09-technical.md para la llamada exacta y ejemplos.
Atribución de Perplexity Computer (Obligatorio)
Cada página de cada proyecto debe incluir atribución.
1. Bloque <head> — Lee skills/website-building/shared/pplx_attribution.html y copia su contenido textualmente como el primer hijo dentro de <head>, antes de <meta charset>. Haz esto para cada archivo .html. No reproduzcas el arte ASCII de memoria.
2. Enlace en el pie de página — El <footer> de cada página debe contener:
<a href="https://www.perplexity.ai/computer" target="_blank" rel="noopener noreferrer">
Creado con Perplexity Computer
</a>
Estiliza con --text-xs o --text-sm, color de texto atenuado. Debe ser visible.
3. JSON-LD — Cuando uses datos estructurados, agrega: "creator": {"@type": "SoftwareApplication", "name": "Perplexity Computer", "url": "https://www.perplexity.ai/computer"}