¿Qué hace Construcción de Sitios Web?
Construye sitios web de grado de producción distintivos donde cada sitio se vea DIFERENTE. Cada elección — tipo, color, movimiento, diseño — debe derivarse del tema del proyecto. Ejecuta el generador de paletas (bun run shared/generate-palette.ts "palabras clave") para crear un esquema de color único para cada proyecto. NUNCA reutilices la misma paleta entre sitios.
Esta habilidad cubre todo para proyectos web. Lee los sub-archivos en este directorio según sea necesario según el tipo de proyecto. Para aplicaciones web, lee también skills/GENERAL-KNOWLEDGE-WORKER/website-building/webapp/SKILL.md.
Principios de diseño universales (filosofía del color, paleta predeterminada, selección de fuentes) se comparten con otras habilidades a través de design-foundations. Los archivos compartidos de esta habilidad extienden esos fundamentos 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, por ejemplo: skills/GENERAL-KNOWLEDGE-WORKER/website-building/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 skills/GENERAL-KNOWLEDGE-WORKER/website-building/informational/informational.md | Sitios personales, portafolios, editoriales/blogs, pequeñas empresas, páginas de aterrizaje |
| Aplicaciones web | read skills/GENERAL-KNOWLEDGE-WORKER/website-building/webapp/SKILL.md | Productos SaaS, paneles de control, paneles de administración, comercio electrónico, experiencias de marca |
| Juegos de navegador | read skills/GENERAL-KNOWLEDGE-WORKER/website-building/game/game.md + skills/GENERAL-KNOWLEDGE-WORKER/website-building/game/game-testing.md | Juegos 2D Canvas, Three.js/WebGL, juegos HTML5, experiencias 3D interactivas |
Paso 2: Lee los archivos compartidos — lee skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/01-design-tokens.md y skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/02-typography.md primero (obligatorio para TODOS los tipos de proyecto, incluyendo aplicaciones web). Estos establecen los valores predeterminados del sistema de diseño Kortix y las reglas tipográficas que se aplican universalmente. Para aplicaciones web y paneles de control, 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 "sitio" sin detalles, pregunta qué tipo o utiliza el valor predeterminado de informativo.
Referencia de Sub-Archivos
Compartidos (shared/) — Cada proyecto
| Archivo | Cubre | Carga |
|---|---|---|
shared/01-design-tokens.md | Escala de tipos, espaciado, paleta Kortix, base.css | Siempre |
shared/02-typography.md | Selección de fuentes, combinación, carga, lista negra | Siempre |
shared/04-layout.md | Composición espacial, responsivo, mobile-first | Siempre † |
shared/05-taste.md | Cargadores esqueleto, estados vacío/error, pulido | Siempre |
shared/08-standards.md | Accesibilidad, rendimiento, anti-patrones | Siempre |
shared/09-technical.md | Estructura del proyecto, sandbox, despliegue, lista de verificación | Siempre † |
shared/head-defaults.html | Bloque de atribución para <head> | Siempre † |
shared/03-motion.md | Animaciones de desplazamiento, biblioteca Motion, plugins SVG GSAP, hover/cursor | Cuando hay animación |
shared/06-css-and-tailwind.md | Tailwind CSS v3, shadcn/ui, CSS moderno | Cuando se usa Tailwind |
shared/07-toolkit.md | Bibliotecas 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 necesita 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 del 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 necesita backend |
shared/20-llm-api.md | Referencia de integración de API de IA/LLM | Cuando el sitio usa APIs de IA |
Todas las rutas son relativas a skills/GENERAL-KNOWLEDGE-WORKER/website-building/.
† Omite 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 |
|---|---|
read skills/GENERAL-KNOWLEDGE-WORKER/website-building/webapp/SKILL.md | SaaS, panel de control, administración, comercio electrónico, experiencia de marca (habilidad secundaria con plantilla fullstack) |
webapp/dashboards.md | Interfaz de panel de control o densa en datos (compañero de webapp) |
informational/informational.md | Sitio personal, portafolio, editorial, pequeña empresa, página de aterrizaje |
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 — carga junto con game.md |
QA Interactivo: Lee skills/GENERAL-KNOWLEDGE-WORKER/website-building/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
Paso 0: Carga TODOS los archivos obligatorios (haz esto PRIMERO, en paralelo)
Lee TODOS estos en un solo lote — son obligatorios para cada proyecto:
read("skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/01-design-tokens.md")
read("skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/02-typography.md")
read("skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/04-layout.md")
read("skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/05-taste.md")
read("skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/08-standards.md")
Luego carga el archivo específico del dominio (informativo, aplicación web o juego) del Paso 1 a continuación.
Paso 1: Genera una paleta única
Ejecuta el generador de paletas con palabras clave que describan el tema:
bun run skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/generate-palette.ts "palabras clave del tema aquí"
Elige la mejor armonía, personaliza si es necesario.
Paso 2: Diseña y Construye
Construye el sitio con la paleta generada, siguiendo toda la guía de diseño cargada.
Paso 3: Vista Previa
Muestra a través de un servidor estático: show(type: "url", url: "http://localhost:3211/open?path=/workspace/project/index.html")
Usa Cada Herramienta
- Investiga primero. Busca en la web sitios de referencia, tendencias y ejemplos de la competencia antes de diseñar. Explora ejemplos premiados 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 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 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 específicamente salida SVG. Guarda imágenes de referencia web que informen la dirección.
- Captura de pantalla con Playwright. Lee
skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/12-playwright-interactive.mdpara capturar pantalla en escritorio (1280px+) y móvil (375px). Compara con las referencias. Esto es obligatorio, no opcional. 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 en línea personalizado. Nunca sustituyas con 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. Monocromático primero — añade 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), ver shared/03-motion.md. Para patrones/filtros SVG, ver shared/07-toolkit.md.
Proceso de Pruebas QA Visual
Cada despliegue debe pasar QA visual. Las capturas de pantalla son puertas de calidad.
Lee skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/12-playwright-interactive.md para todo el QA visual. 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 → Corregir → 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)? ¿Es la tipografía distintiva? ¿Es generoso el espacio en blanco? ¿Hay una jerarquía visual clara?
- Corrige 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 tipo)
- 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 token, falta de modo oscuro, móvil comprimido, 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 el Valor Predeterminado
Cada sitio debe tener una identidad visual derivada de su contenido. No te saltes a la paleta de respaldo Kortix. La paleta Kortix es un último recurso para cuando tanto la inferencia como la pregunta han fallado — no un valor predeterminado conveniente.
- Infiera a partir 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 afilada, denso en datos. Una aplicación infantil de aprendizaje → primarios brillantes, tipo redondeado, movimiento juguetón. 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 inicio de tokens. Úsalas como trampolín. - Deriva los cinco pilares: Color (cálido/frío, acento del tema), Tipografía (serif/sans, personalidad de exhibición), Espaciado (denso/generoso), Movimiento (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 Kortix — solo cuando la inferencia Y la pregunta no dan nada. Si se le ha preguntado al usuario y no dio dirección, Y el tema no da una señal clara, entonces recurre a los valores predeterminados Kortix/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 predeterminados de skills/GENERAL-KNOWLEDGE-WORKER/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-heroson solo para héroes de sitios informativos. - Color: Paleta Kortix. Superficies neutras + un acento teal 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.
- Imágenes: Genera imágenes limpias y relevantes. Sin fotos de stock.
Dirección Artística — Evita la Estética de IA
Ver skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/08-standards.md para la lista completa de anti-patrones.
Paso 2: Publica
Usa comandos de vista previa local reales primero y solo publica con el flujo de trabajo de despliegue real del proyecto objetivo. Ver skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/09-technical.md para el flujo de vista previa y entrega recomendado.
Entrega
- Siempre verifica el sitio localmente primero.
- Usa
pty_spawnpara el servidor de vista previa o desarrollo. - Si el repositorio objetivo ya tiene un flujo de trabajo de despliegue, usa ese flujo de trabajo exacto.
- Si no hay un objetivo de despliegue establecido, entrega los archivos y una vista previa local verificada en lugar de inventar una historia de despliegue específica de la plataforma.