Communitygithub.com

webbuild

Construye sitios web profesionales, distintivos y listos para presentar, con héroes 3D con desplazamiento, escenas Three.js/R3F en tiempo real, animaciones GSAP + Lenis y shaders de video tratados, que NO parezcan generados por IA.

¿Qué es webbuild?

webbuild es una skill para agentes de IA como Claude Code, diseñada para construir o rediseñar sitios web y landing pages con un nivel de calidad que un dueño de negocio pagaría. La skill guía al agente a través de un flujo completo: desde entender el negocio real del cliente (breve, investigación de referencia), pasando por planificar un sistema de diseño anti-‘slop’, elegir el modo de héroe adecuado (estático, video, cuadros por desplazamiento o escena 3D con Three.js), hasta construir, revisar visualmente y desplegar. Incluye herramientas como `scripts/shoot.mjs` para capturas de pantalla en múltiples viewports, `scripts/slop_check.py` para detectar signos de IA genérica, y un playbook de animaciones que prioriza `transform`/`opacity` y `prefers-reduced-motion`. El resultado final se presenta al usuario con un reporte concreto, incluyendo métricas de rendimiento, elementos pendientes y una lista de preguntas para el cliente. Es ideal para sitios tipo Awwwards, sitios ‘de $10K’, reconstrucciones de sitios reales para presentación a negocios locales, o cualquier proyecto que requiera un acabado pulido y profesional sin parecer hecho por IA.

Compatible con~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Harishisonline/webbuild-skill/tree/main

Preguntar en tu IA favorita

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

Documentación

¿Qué hace webbuild?

Crea sitios web por los que un dueño de negocio pagaría: específicos para ellos, rápidos en un teléfono, con un momento memorable y nada que grite «esto lo hizo una IA». La artesanía está sobre todo en las decisiones antes del código y en mirar el resultado con honestidad después.

Las rutas siguientes son relativas a la carpeta de esta skill (scripts/, references/, assets/).

0. Configurar el proyecto (2 min)

  • Sitio nuevo → copiar assets/starter/ a la carpeta del proyecto (HTML + CSS + módulos ES plano, importaciones CDN fijas, sin paso de compilación: se despliega en cualquier lado, fácil de editar). Usar Next.js / Astro / R3F solo si el usuario lo pide o el proyecto ya los usa (references/3d-playbook.md §5).
  • Proyecto existente → mantener su framework, tokens y componentes; esta skill añade dirección, movimiento y QA, no una reescritura.
  • Crear BUILD_NOTES.md en el proyecto. Es la memoria entre reinicios de contexto: breve, decisiones, preguntas abiertas, correcciones que funcionaron.

1. Brief — entender el negocio real

Recopilar (del usuario, del sitio actual del negocio, Google Business Profile, Instagram): nombre, qué venden, dónde, desde cuándo, la acción principal (llamar / reservar / pedir / cotizar / visitar), prueba real (valoración + cantidad, años, licencias, prensa), fotos reales, logo/colores, horario, dirección, teléfono. Escribir el brief de 5 líneas de references/design-system.md §2 en BUILD_NOTES.md.

Nunca inventes datos — reseñas, estadísticas, precios o direcciones falsificados en una presentación destruyen la confianza en cuanto el dueño los lee. En su lugar:

  • Escribir alrededor de lo desconocido para que el demo se vea terminado: «Koregaon Park, Pune» en lugar de una calle inventada; «Valorado 4,7 en Google» en lugar de citas inventadas; nombres de servicios sin precios, o «desde ₹…» solo si se sabe.
  • Cuando un dato sea realmente necesario (teléfono, dirección exacta, horario), usar un {{placeholder}} visible — slop_check.py bloquea el envío hasta que se complete.
  • Poner cada desconocido y suposición en una lista «Preguntar al cliente» para el informe final.

Para un sitio de creador o canal, pedir (o extraer) los números del panel y la foto de perfil de antemano: capturas de YouTube Studio / Instagram Insights, además de vidIQ o similar si está conectado. Una sección de Resultados construida con números reales es lo que vende.

Si el brief es escaso y el usuario está cerca, hacer como máximo 3 preguntas (negocio + ciudad, acción principal, algún sitio que les guste). Si quieren que simplemente se avance, hacer suposiciones sensatas, anotarlas y seguir adelante.

2. Referencia (cuando el usuario nombra un sitio, envía una grabación o quiere una «reconstrucción»)

Seguir references/reverse-engineer.md: node scripts/teardown.mjs <url> mide el stack, fuentes, paleta, medios y evidencia de shaders y captura el scroll; las grabaciones de pantalla se convierten en fotogramas que se leen y se transforman en una especificación de movimiento paso a paso. Cuando ese pase rápido no pueda explicar un efecto, profundizar con el motor de REA: scripts/rea-teardown.sh <url> captura la página, toma huellas del bundle y exporta cada script para poder leer cómo está construido realmente (guías en references/rea/). Registrar OBSERVADO → INFERENCIA → DECISIÓN. Aprender la técnica; nunca copiar marca, copy, activos ni código.

3. Dirección — planificar, luego atacar el plan

Leer references/design-system.md (las reglas anti-slop — clásicas y las más nuevas «señas de IA con gusto» como crema + terracota, cejas en MAYÚSCULAS, líneas editoriales). En BUILD_NOTES.md escribir:

  • 4–6 tokens de color nombrados tomados del negocio, emparejamiento de tipos + roles, lenguaje de radio
  • wireframe ASCII de cada sección (variar el ritmo — nada de héroe → 3 tarjetas → logos → testimonios)
  • el momento estrella (exactamente uno) y por qué encaja con este negocio
  • 3 principios que lo hacen distintivo

Luego revisar el plan contra la lista de señales y, para cada elección que parezca un valor por defecto, justificarla para este negocio o cambiarla. Preguntar «¿Podría esto pertenecer a otro negocio si cambio el logo?» detecta la mayoría de los problemas aquí, donde son baratos de corregir.

Para una dirección no decidida que el usuario quiera elegir, mostrar 2–3 direcciones realmente diferentes (una imagen fija o un boceto HTML rápido cada una) antes de construir — 21st-ui-explore puede ayudar si está instalado.

4. Héroe — elegir el modo que sirve al negocio

references/3d-playbook.md §1 tiene la tabla de decisiones. Versión corta:

  • estático (buena foto/tipo) — lugares, comida, salones, clínicas, servicios. A menudo la opción correcta.
  • video — bucle de ambiente, idealmente tratado con assets/starter/grade.js para que el material de IA/stock reciba un tratamiento a medida (grano, halación, lift/gamma/gain, viñeta). Elegir un LOOK y mantenerlo sutil.
  • cuadros — el «sitio web 3D de $10K»: fotogramas clave de IA inicio/fin → video primer/último fotograma → scripts/frames.sh → lienzo desplazado por scroll. Leer references/scroll-video-playbook.md para las reglas de fotogramas clave, prompts y mezcla.
  • escena — Three.js / R3F en vivo cuando el 3D es la historia del producto (producto configurable, arquitectura, tecnología). El sujeto debe ser lo propio del negocio, nunca el nudo de relleno.
  • página completa — cuando el dueño pide un «sitio web 3D», normalmente se refiere a 3D en toda la página, no solo un héroe 3D. Usar una escena fija con una cámara por sección (references/3d-playbook.md §6).

Generar activos con lo que esté conectado (Higgsfield / Kling / kie.ai / Nano Banana MCPs o skills), o pedir al usuario que coloque archivos. Si no hay nada disponible, construir con un placeholder claramente etiquetado y listar exactamente qué activo generar, con el prompt.

5. Construir

Orden: tokens (styles.css :root) → secciones HTML semánticas con copy real → maquetación a 390px y 1440px → modo héroe → movimiento al final.

  • Reglas de copy: references/design-system.md §8 (resultado + lugar + detalles, verbos reales de CTA, palabras prohibidas).
  • Requerido para un sitio de negocio: un CTA obvio arriba del pliegue y otro al final, tel: / reserva / formulario, horario + dirección + enlace al mapa, prueba real, título + descripción + imagen OG, JSON-LD de LocalBusiness, favicon, barra fija de llamar/reservar en móvil cuando la acción es una llamada.
  • Movimiento: un momento estrella + micro-feedback sutil de 150–300 ms; ease-out, nunca rebote; solo transform/opacity; movimiento reducido muestra estados finales.
  • Componentes: buscar en los registros de references/resources.md (21st.dev, React Bits, Aceternity, Motion Primitives…) antes de escribir efectos complejos a mano, luego reestilizar con los tokens. En un sitio estático, reconstruir componentes de React en vanilla en lugar de añadir React para un solo efecto.
  • Footer: construirlo según references/design-system.md §11 (bloque de marca, columnas de enlaces con logotipos de plataformas, botones de contacto, marca de agua sobredimensionada, fila inferior). Los dueños juzgan todo el sitio por él. El pequeño crédito del constructor ya está en el starter; el cliente puede pedir que lo quiten.
  • Botones y scroll: seguir references/design-system.md §12 (botones táctiles de 0.16 s, anillo del cursor mediante cursor.js del starter, sin barra de scroll nativa: blockbar.js del starter la reemplaza).
  • Antes de darlo por terminado, releer references/design-system.md §10: las cosas que los dueños siguen llamando slop incluso después de que todas las reglas se cumplan.

6. Mirarlo — aquí es donde se hacen los sitios buenos

Servir localmente (npx serve . o el servidor de desarrollo del proyecto), luego:

  1. node scripts/shoot.mjs http://localhost:3000 ./shots — capturas de pantalla de teléfono / portátil / escritorio a lo largo del scroll + errores de consola, desbordamiento, LCP, peso. Leer los PNGs. (O usar el panel del navegador / Playwright MCP si está disponible.) También ejecutar una vez con --reduced-motion.
  2. python3 scripts/slop_check.py . — debe terminar con 0 FAIL. Tratar los WARN como preguntas. (npx impeccable detect es un buen segundo opinion si está instalado).
  3. Criticar honestamente contra el brief: jerarquía, tipo, color, el momento estrella, móvil, especificidad del copy. Corregir en lotes con intención clara («las secciones inferiores se sienten genéricas — hacerlas más caras, no más ocupadas»).
  4. Restar un elemento decorativo antes de darlo por terminado.

Esperar 3–6 rondas; nadie lo hace a la primera. Registrar qué arregló qué en BUILD_NOTES.md.

7. Enviar + presentar

  • Desplegar: Vercel / Netlify / Cloudflare Pages / GitHub Pages. Hacer commit de la carpeta de fotogramas (el error más común de «el héroe desapareció en producción»). Añadir <meta name="robots" content="noindex"> a los demos de prueba hasta que el cliente compre.
  • Si es una presentación, leer references/pitch-and-sell.md: video antes/después, guiones de alcance, anclajes de precios, lista de verificación para presentación, entrega.

Informe final al usuario

Mantenerlo corto y concreto:

  • Qué se construyó (dirección en una línea, momento estrella, modo héroe) y dónde (rutas, URL)
  • Cómo ejecutarlo (npx serve . o el comando de desarrollo)
  • Resultados de QA: recuento FAIL/WARN de slop_check, LCP / errores por viewport de shoot.mjs, qué se revisó y corrigió
  • Lista Preguntar al cliente: cada {{placeholder}} y suposición
  • Activos aún por generar (con prompts listos para usar), si los hay

Mapa de referencias

LeerCuándo
references/design-system.mdSiempre, antes de elegir color/tipo/maquetación/copy
references/3d-playbook.mdAl elegir el héroe; cualquier Three.js/R3F; presupuesto de rendimiento + a11y
references/scroll-video-playbook.mdHéroe «3D» desplazado por scroll desde video de IA
references/reverse-engineer.mdUn sitio de referencia, una grabación, o reconstruir el sitio de un prospecto
references/rea/README.mdProfundizar más allá de teardown.mjs con las herramientas de REA
references/resources.mdRegistros de componentes, herramientas de efectos, inspiración, skills complementarias
references/pitch-and-sell.mdSitio de prueba para un prospecto, precios, alcance, entrega
ScriptHace
scripts/teardown.mjs <url>Medir un sitio de referencia (stack, fuentes, paleta, medios, shaders, capturas)
scripts/rea-teardown.sh <url>Desmontaje profundo con el motor REA: captura de página, huellas del bundle, scripts exportados
scripts/frames.sh <video> <out>Video → secuencias de fotogramas WebP (escritorio + móvil) + manifiesto
scripts/shoot.mjs <url> [out]Capturas a 3 anchos a lo largo del scroll + errores/LCP/desbordamiento
scripts/slop_check.py <dir>Linter de IA-slop + preparación para envío (0 FAIL para enviar)

Playwright para los scripts .mjs: npm i -D playwright && npx playwright install chromium.

Skills relacionados