¿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.mden 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.pybloquea 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.jspara 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. Leerreferences/scroll-video-playbook.mdpara 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 mediantecursor.jsdel starter, sin barra de scroll nativa:blockbar.jsdel 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:
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.python3 scripts/slop_check.py .— debe terminar con 0 FAIL. Tratar los WARN como preguntas. (npx impeccable detectes un buen segundo opinion si está instalado).- 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»).
- 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
| Leer | Cuándo |
|---|---|
references/design-system.md | Siempre, antes de elegir color/tipo/maquetación/copy |
references/3d-playbook.md | Al elegir el héroe; cualquier Three.js/R3F; presupuesto de rendimiento + a11y |
references/scroll-video-playbook.md | Héroe «3D» desplazado por scroll desde video de IA |
references/reverse-engineer.md | Un sitio de referencia, una grabación, o reconstruir el sitio de un prospecto |
references/rea/README.md | Profundizar más allá de teardown.mjs con las herramientas de REA |
references/resources.md | Registros de componentes, herramientas de efectos, inspiración, skills complementarias |
references/pitch-and-sell.md | Sitio de prueba para un prospecto, precios, alcance, entrega |
| Script | Hace |
|---|---|
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.