Communitygithub.com

Construcción de Sitios Web

Crea sitios web de grado de producción distintivos, páginas de aterrizaje y experiencias web interactivas con un fuerte enfoque en diseño y control de calidad.

¿Qué es Construcción de Sitios Web?

Esta habilidad está diseñada para desarrolladores y agentes de IA que construyen sitios web profesionales y de alta calidad donde cada sitio tiene una identidad visual única. Proporciona un sistema completo que cubre desde la generación de paletas de colores basadas en el tema del proyecto hasta la implementación de principios de diseño universales, como tipografía, espaciado y animaciones. La habilidad soporta varios tipos de proyectos, incluyendo sitios informativos, aplicaciones web y juegos de navegador, con rutas de archivos específicas para cada tipo. El flujo de trabajo incluye la carga de archivos obligatorios compartidos (como tokens de diseño y tipografía), la ejecución de un generador de paletas para crear combinaciones de colores únicas, la construcción del sitio siguiendo guías de diseño detalladas y la realización de pruebas de calidad visual con Playwright para garantizar una experiencia pulida antes de la publicación. Además, cada proyecto debe incluir un logotipo SVG personalizado y seguir un proceso de revisión visual riguroso para evitar el 'estética de IA genérica'.

Compatible con✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/rizkydarm/ClusteringAIAgentsSkills-Python/tree/HEAD/_skill/website-building

Preguntar en tu IA favorita

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

Documentación

¿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 ProyectoAcciónEjemplos
Sitios informativosread skills/GENERAL-KNOWLEDGE-WORKER/website-building/informational/informational.mdSitios personales, portafolios, editoriales/blogs, pequeñas empresas, páginas de aterrizaje
Aplicaciones webread skills/GENERAL-KNOWLEDGE-WORKER/website-building/webapp/SKILL.mdProductos SaaS, paneles de control, paneles de administración, comercio electrónico, experiencias de marca
Juegos de navegadorread skills/GENERAL-KNOWLEDGE-WORKER/website-building/game/game.md + skills/GENERAL-KNOWLEDGE-WORKER/website-building/game/game-testing.mdJuegos 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

ArchivoCubreCarga
shared/01-design-tokens.mdEscala de tipos, espaciado, paleta Kortix, base.cssSiempre
shared/02-typography.mdSelección de fuentes, combinación, carga, lista negraSiempre
shared/04-layout.mdComposición espacial, responsivo, mobile-firstSiempre †
shared/05-taste.mdCargadores esqueleto, estados vacío/error, pulidoSiempre
shared/08-standards.mdAccesibilidad, rendimiento, anti-patronesSiempre
shared/09-technical.mdEstructura del proyecto, sandbox, despliegue, lista de verificaciónSiempre †
shared/head-defaults.htmlBloque de atribución para <head>Siempre †
shared/03-motion.mdAnimaciones de desplazamiento, biblioteca Motion, plugins SVG GSAP, hover/cursorCuando hay animación
shared/06-css-and-tailwind.mdTailwind CSS v3, shadcn/ui, CSS modernoCuando se usa Tailwind
shared/07-toolkit.mdBibliotecas CDN, React, Three.js, iconos, mapas, patrones/filtros SVG, esm.shAl elegir librerías
shared/10-charts-and-dataviz.mdChart.js, Recharts, D3, KPIs, sparklinesCuando se necesita visualización de datos
shared/11-web-technologies.mdVersiones de frameworks, compatibilidad con navegadoresAl verificar compatibilidad
shared/12-playwright-interactive.mdQA persistente del navegador Playwright, capturas de pantalla, pruebas visualesAl hacer pruebas
shared/19-backend.mdServidores FastAPI/Express/Flask, WebSocket, SSE, reenvío de puertosCuando se necesita backend
shared/20-llm-api.mdReferencia de integración de API de IA/LLMCuando 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

ArchivoCuándo cargar
read skills/GENERAL-KNOWLEDGE-WORKER/website-building/webapp/SKILL.mdSaaS, panel de control, administración, comercio electrónico, experiencia de marca (habilidad secundaria con plantilla fullstack)
webapp/dashboards.mdInterfaz de panel de control o densa en datos (compañero de webapp)
informational/informational.mdSitio personal, portafolio, editorial, pequeña empresa, página de aterrizaje
game/game.mdJuego de navegador, Three.js, WebGL, 3D interactivo
game/2d-canvas.mdJuego 2D Canvas (compañero de game.md)
game/game-testing.mdCualquier 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.md para 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.

  1. Comprende la marca — propósito, tono, una palabra definitoria
  2. Escribe SVG directamente — formas geométricas, letras o marcas abstractas. Una forma memorable.
  3. Principios: Geométrico/mínimo (Paul Rand, Vignelli). Funciona a 24px y 200px. Monocromático primero — añade color como mejora. Usa currentColor para modo oscuro/claro.
  4. Implementa en línea con aria-label, viewBox, fill="none", trazos currentColor
  5. 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:

  1. Captura de pantalla en escritorio (1280px+) y móvil (375px) mediante Playwright
  2. 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?
  3. Corrige cada problema antes de continuar. Sin deuda visual.

Etapa 2: QA Final (antes de publicar)

  1. Captura de pantalla de cada página en escritorio y móvil
  2. Verifica consistencia entre páginas (espaciado, color, tratamiento de tipo)
  3. Verifica el modo oscuro (captura de pantalla de ambos temas para la página de inicio como mínimo)
  4. Verifica estados interactivos: hover, focus, active, loading, empty, error
  5. 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.

  1. 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.
  2. 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.
  3. 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).
  4. Si el tema es genuinamente ambiguo, pregunta — "¿Qué ambiente buscas?" y "¿Algún sitio de referencia?" Una pregunta es suficiente.
  5. 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-hero son 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_spawn para 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.

Skills relacionados