Communitygithub.com

cartcodes/website-builder

Crea, haz crecer y audita un sitio web rápido de generación de leads e imanes de leads para cualquier negocio, gestionado por Claude Code para un propietario no técnico.

¿Qué es website-builder?

Esta habilidad permite a un agente de IA (como Claude Code) construir un sitio web completo de generación de leads para cualquier tipo de negocio, incluso para propietarios sin conocimientos técnicos. El proceso comienza con una entrevista guiada para elegir entre un modo interactivo (con una estructura predefinida) o un modo libre (totalmente flexible). El sitio se compone de páginas de aterrizaje, cada una con un único objetivo de conversión (llamada, formulario, descarga, registro, compra), agrupadas en archivos temáticos enlazados desde el pie de página. La habilidad incluye investigación de palabras clave real, redacción persuasiva sin marcas de IA, SEO completo, optimización para búsqueda por IA (GEO/AEO), verificación de indexación y velocidad, e integración con un CRM gratuito (Lead Desk) alojado en Cloudflare. También puede crear imanes de leads (guías, listas de verificación, etc.) con su PDF, portada, y todo el material promocional asociado (publicaciones, anuncios, correos electrónicos). Está diseñada para ser autosuficiente: el agente hace el trabajo pesado, presenta opciones al usuario y solo pide información cuando es necesario.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cartcodes/claude-website-builder/tree/HEAD/skills/website-builder

Preguntar en tu IA favorita

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

Documentación

Constructor de sitios web

Esta habilidad funciona para cualquier negocio: un dentista, un bufete de abogados, un contratista, un coach, una empresa de software, una panadería, una iglesia, un creador de cursos. Nunca asumas un oficio, un lugar o un tipo de página. Todo lo específico proviene de la entrevista y de la investigación. Los ejemplos en estos archivos son solo ejemplos, nada más.

La persona probablemente no es técnica. Responde preguntas, hace clic en los botones que describes y aprueba lo que le muestras. Tú haces todo lo demás.

Elige cómo trabajar (pregunta una vez, al principio)

A menos que la solicitud de la persona ya lo deje claro, pregunta con la herramienta AskUserQuestion (en lenguaje sencillo si esa herramienta no está disponible). Pregunta: "¿Cómo te gustaría trabajar?" Dos opciones:

  1. Entrevista normal. "Te guiaré paso a paso: qué ofrecen tus páginas, investigación de palabras clave, un sitio completo con contratos y verificaciones, publicado en Cloudflare de forma gratuita."
  2. Modo libre. "Tú me dices lo que quieres y yo lo construyo a tu manera, en cualquier configuración o alojamiento que elijas. Aún así uso buenas prácticas de redacción, conversión, SEO y búsqueda por IA, pero no insistiré ni te pondré en una ruta predefinida."

Guarda la respuesta en content/notes.md (o en el archivo de notas del proyecto) para no volver a preguntar. La persona puede cambiar en cualquier momento si lo indica.

Modo libre

Sigue references/any-stack.md. En resumen:

  • Sus palabras deciden. Construye lo que pidan, en el orden que pidan, en la pila, plataforma y alojamiento que nombren o que ya tengan. Si no nombran ninguno, elige algo sensato para el trabajo y di lo que elegiste en una sola oración. No realices la entrevista, no exijas contratos ni archivos, y no discutas sobre el diseño o la disposición.
  • Las convenciones son tus valores predeterminados, no reglas. Escribe el texto con references/copywriting.md (incluyendo la limpieza de marcas de IA), da forma a las páginas con references/conversion.md, y aplica references/technical-seo.md, references/geo-aeo.md y references/indexing.md donde sea apropiado. Si una solicitud claramente va en contra de su propio objetivo (dos botones en competencia, un rastreador de IA bloqueado, una página oculta de la búsqueda), menciónalo una vez, en una oración, luego hazlo a su manera.
  • El Lead Desk también funciona en Modo libre, para cualquier sitio en cualquier alojamiento: los formularios se envían a él y se coloca una etiqueta de script en el pie de página del sitio (references/lead-desk.md).
  • Los imanes de leads funcionan igual en Modo libre. "Créame un imán de leads" va directamente a references/lead-magnets.md y scripts/build-magnet.mjs, para cualquier sitio o ninguno.
  • Usa cualquier otra referencia cuando sea útil (investigación de palabras clave, archivos, páginas de éxito, contratos), y solo cuando te lo pidan o sirva claramente a lo que pidieron.
  • Las verificaciones aún se ejecutan donde sea posible: apunta scripts/check-site.mjs --freeform a la carpeta HTML construida del sitio, o primero obtén un sitio en vivo con scripts/fetch-site.mjs. En modo libre, las convenciones de diseño se muestran como sugerencias, no como fallos.
  • Sigue siendo obligatorio: las reglas de "Cómo trabajar con la persona" a continuación, no inventes hechos, no manejes contraseñas o claves, y pregunta antes de cualquier cosa que cueste dinero, cambie un dominio o elimine algo.

Todo desde "Elige el trabajo" en adelante es la Entrevista normal. En Modo libre, usa esas secciones solo como referencia.

El objetivo: convertir la acción

Cada página de aterrizaje existe para que se realice una sola acción: la reserva, el formulario, la descarga, el registro, la compra. La búsqueda, las respuestas de IA, las publicaciones en redes sociales y los anuncios solo traen personas a la página. La página funciona cuando actúan. Cuando una elección ayuda al ranking pero perjudica la conversión, la conversión gana. Lee references/conversion.md antes de diseñar o escribir cualquier página, y mide cada página por su tasa de conversión.

La idea detrás del sitio (explícala con estas palabras)

Tu sitio web es una colección de páginas de aterrizaje. Cada página de aterrizaje está diseñada para un tipo de visitante que quiere una cosa, y le pide que haga una cosa: reservar una llamada, obtener un presupuesto, descargar una guía, apartar un asiento, comprar. Todo lo que necesitan para decidir está en la primera pantalla, y no hay menú que los distraiga. Después de que actúan, llegan a una página de éxito que entrega lo que pidieron y ofrece un siguiente paso.

Las páginas de aterrizaje del mismo tipo se agrupan en un archivo, que es una página simple que las enumera todas. Tus archivos dependen de lo que ofreces o vendes. Podrían ser los lugares a los que prestas servicio, tus servicios, las personas a las que ayudas, guías gratuitas, eventos, o algo completamente diferente. El pie de página al final de cada página enlaza a todos los archivos. Los visitantes que quieran mirar alrededor pueden desplazarse hacia abajo y encontrar todo, y Google y los asistentes de IA siguen esos enlaces del pie de página para descubrir cada página.

El sitio crece añadiendo páginas de aterrizaje, nunca añadiendo elementos de menú. Cada página sigue un contrato (una lista de verificación de hechos y reglas requeridos), por lo que las nuevas páginas son rápidas de añadir y siempre cumplen con el estándar.

Cómo trabajar con la persona (siempre)

  • Autoservicio: haz el pensamiento tú mismo y ofrece menús cortos de opciones concretas para elegir (AskUserQuestion), con tu recomendación primero. Haz preguntas abiertas solo para hechos que solo ellos conocen.
  • Un paso a la vez. Palabras sencillas. Espera a que digan "listo" antes del siguiente paso.
  • Cuando deban hacer clic en algo, di exactamente lo que dice el botón y dónde está en la pantalla.
  • Nunca manejes contraseñas, claves API o tokens. Nunca los pidas en el chat, y nunca los leas de archivos o del ordenador. Los servicios que requieren inicio de sesión son conectados por la propia persona: Cloudflare a través de su inicio de sesión en el navegador, otras herramientas a través de sus propios conectores de Claude o exportaciones CSV. Las contraseñas del Lead Desk y los enlaces de webhook son escritos por la persona en sus propias páginas del Lead Desk, nunca en el chat.
  • Pregunta antes de cualquier cosa que cueste dinero, cambie un dominio o elimine algo.
  • Después de cada paso, di lo que hiciste en una oración. Sin jerga.
  • Muestra, no describas: inicia la vista previa local y dales el enlace siempre que haya algo que ver.
  • Nunca inventes hechos: sin números, reseñas, lugares, credenciales o volúmenes de búsqueda inventados. Si falta un hecho, pregunta.

Elige el trabajo (Entrevista normal)

  1. Construir un nuevo sitio. Cada fase, en orden.
  2. Crear un imán de leads (y, si se desea, su página de aterrizaje, página de éxito, publicaciones, anuncios y correos electrónicos). Sigue references/lead-magnets.md.
  3. Añadir una página de aterrizaje de cualquier tipo, en cualquier archivo existente. Sigue "Añadir una página" en references/contracts.md.
  4. Añadir un nuevo archivo (un nuevo tipo de página de aterrizaje). Sigue "Añadir un archivo" en references/contracts.md.
  5. Encontrar palabras clave y lugares, y planificar nuevas páginas. Fase 4, luego entrega el plan de páginas.
  6. Verificar, corregir e indexar un sitio existente. Fases 8, 9 y 10.
  7. Configurar el Lead Desk, la propia bandeja de entrada de leads del negocio con inicios de sesión de administrador, resultados y alertas, en su cuenta de Cloudflare. Sigue references/lead-desk.md. Funciona con cualquier sitio web.
  8. Configurar una rutina que añada páginas en un horario. Consulta "Rutinas" en references/contracts.md.

Fase 1: ¿Qué debería hacer para ti? (siempre primero en la entrevista)

Sigue references/offers-and-archives.md. Mantenlo en autoservicio: tú haces el pensamiento y ofreces menús para elegir.

  • Pregunta qué venden, luego "¿Qué imanes de leads quieres que haga para ti?" con 3-4 ideas elaboradas para su negocio (references/lead-magnets.md), luego qué páginas hacer.
  • Construye el inventario de ofertas a partir de sus elecciones: todo lo que el sitio ofrecerá o regalará, y la única acción que cada uno solicita.
  • Conoce el modelo de negocio, de dónde vienen los clientes y el plan de redes sociales. Cada publicación en redes sociales que prometa algo necesita una página de aterrizaje que lo cumpla.
  • Decide si los lugares importan en absoluto. Muchos negocios no tienen páginas de ubicación.
  • Elige los archivos de las plantillas. Nómbralos con las propias palabras del negocio y obtén la aprobación de la persona.

Fase 2: Recopilar los hechos

Lee about.md y voice.md primero si existen, y omite cualquier cosa que ya respondan. Luego pregunta, una pregunta a la vez, solo por lo que necesitan los archivos elegidos:

  • Pruebas: años en el negocio, números atendidos, credenciales o licencias, garantías, premios, calificación y número de reseñas, y 3+ testimonios con nombre, lugar (si es relevante) y un resultado específico.
  • Precios o rangos que estén dispuestos a publicar, y cuánto tiempo lleva cada cosa.
  • Para cada oferta, los hechos específicos que su página necesita (los campos del contrato te indican cuáles).
  • A dónde van los leads. Ofrece un menú: su propio Lead Desk (recomendado: gratuito, en su cuenta de Cloudflare, muestra de dónde vino cada lead y cuáles se convirtieron en clientes; references/lead-desk.md), el CRM o herramienta de correo electrónico que ya usan (el Lead Desk puede pasarles los leads), o una herramienta de reservas para llamadas.
  • Marca: logotipo, colores, fotos reales de su trabajo y su gente.
  • Nombre, dirección (si es pública) y teléfono exactamente como aparecen en su Perfil de Negocio de Google, más enlaces a cada perfil oficial.
  • Si poseen un dominio y dónde lo compraron.

Guarda todo en content/business.yaml, content/offers.md y content/notes.md para que no se pregunte dos veces.

Fase 3: Configurar y conectar Cloudflare

Sigue references/cloudflare-setup.md: Node (si falta), una cuenta gratuita de Cloudflare, Wrangler instalado en el sitio en una versión fija, npm run cf:login, luego npm run cf:whoami para confirmar.

Fase 4: Investigación de palabras clave, descubrimiento de lugares y plan de páginas

Sigue references/keyword-research.md:

  • Construye candidatos a partir del inventario de ofertas, las propias palabras de los clientes y (solo si los lugares importan) los lugares descubiertos al nivel de detalle correcto.
  • Obtén demanda real de una fuente nombrada y verifica la competencia real en los resultados de búsqueda reales.
  • Agrupa las palabras clave que comparten resultados de búsqueda en una página, y ejecuta cada página a través de la puerta.
  • Guarda research/keywords.csv, research/places.csv (si los lugares importan) y research/page-plan.md. Muestra el plan a la persona en palabras sencillas y obtén su aprobación.

Fase 5: Configurar los contratos

Sigue references/contracts.md:

  • Crea contracts/archives/<id>.json para cada archivo elegido desde assets/contracts/archive-templates/, con el propio id, etiqueta, ruta y objetivo del negocio.
  • Copia los contratos de éxito que el sitio necesita desde assets/contracts/success/.
  • Copia scripts/contracts.mjs, scripts/new-page.mjs, scripts/check-site.mjs y scripts/build-magnet.mjs en la carpeta scripts/ del sitio.
  • Andamia cada página planificada con node scripts/new-page.mjs.

Fase 6: Construir el sitio

Sigue references/site-structure.md. La pila es Astro + Tailwind con salida estática. Las colecciones de contenido se generan a partir de los contratos, por lo que la compilación rechaza cualquier página que rompa su contrato.

Las reglas que más importan:

  • Un objetivo de conversión por página de aterrizaje. Cada botón y formulario lleva a la misma acción, marcada con data-cta="<goal>" y data-success="/thanks/<goal>/". Una segunda oferta obtiene su propia página.
  • Todo lo importante en la primera pantalla: logotipo, un titular que nombre el problema y contenga la palabra clave principal de la página, como máximo dos líneas de subtítulo, la única conversión y confianza (insignias más 2-3 testimonios cortos). La página puede desplazarse, pero nadie debería necesitarlo.
  • Sin menú de navegación superior. El encabezado contiene solo el logotipo y el llamado a la acción.
  • Los archivos enumeran cada página de aterrizaje de su tipo. El pie de página en cada página enlaza a todos los archivos.
  • Cada archivo tiene un rol. Los archivos search están diseñados para posicionarse y ser citados por la IA (puerta de palabras clave, SEO/AEO/GEO completo). Los archivos resource contienen cosas enlazadas desde contenido, publicaciones en redes sociales y correo electrónico; sus páginas se centran en mostrar exactamente lo que el visitante obtiene (se requiere una vista previa) y omiten la puerta de palabras clave. both significa un recurso que también pasó la puerta.
  • Las páginas de éxito siguen su contrato de éxito: entregan lo prometido, ofrecen un siguiente paso, nunca se indexan.

Fase 6b: Crear los imanes de leads

Para cada imán de leads que solicitaron, sigue references/lead-magnets.md: escribe lead-magnets/<slug>/magnet.md, ejecuta node scripts/build-magnet.mjs lead-magnets/<slug> --site public, muéstrales el PDF y la portada, y usa la portada como vista previa de la página de aterrizaje. Escribe promo.md (publicaciones, flujo de comentario a DM, anuncios y correos electrónicos de seguimiento) si lo desean.

Fase 7: Escribir el texto

Sigue references/copywriting.md y references/conversion.md: consciente del problema, centrado en la solución, construido alrededor de la palabra clave de la página, oraciones cortas y sencillas, hechos en lugar de adjetivos. Ejecuta la limpieza de marcas de IA en cada página antes de mostrarla.

Fase 8: Verificaciones

  • references/geo-aeo.md: la lista de verificación completa de búsqueda por IA. Aplica todo.
  • references/technical-seo.md: metadatos, datos estructurados, mapa del sitio, robots.txt, llms.txt, velocidad.
  • Añade "check": "node scripts/contracts.mjs check && astro build && node scripts/check-site.mjs dist" a package.json y ejecuta npm run check después de cada cambio. Nunca publiques con una línea FAIL. Corrige las advertencias a menos que haya una razón declarada para no hacerlo, e informa a la persona cuáles dejaste y por qué.

Fase 8b: Lead Desk

Si eligieron el Lead Desk, configúralo con references/lead-desk.md antes de publicar: base de datos, dirección (su subdominio si el dominio está en Cloudflare), invitación al propietario, formularios que se envían a él con _success configurado en la página de éxito de cada página, el script auxiliar en cada página y al menos una alerta. Envía un lead de prueba desde la vista previa local y muéstralo llegando.

Fase 9: Publicar

  1. Muestra la vista previa local y espera su aprobación.
  2. npm run deploy (ejecuta las verificaciones primero; la primera vez, crea el proyecto como en la guía de configuración).
  3. Dales el enlace en vivo, luego abre cada archivo, una página de aterrizaje con su página de éxito, /sitemap-index.xml y /llms.txt.
  4. Ofrece conectar su propio dominio (guía de configuración, Parte 5). La indexación necesita el dominio final, así que haz esto antes de la fase 10 si quieren uno.
  5. Después de publicar, ejecuta la verificación de velocidad en vivo en references/technical-seo.md.

Fase 10: Indexarse

Sigue references/indexing.md: verificaciones previas al vuelo, Google Search Console, Bing Webmaster Tools, IndexNow, listados de mapas y mantener la copia .pages.dev fuera de la búsqueda. Verifica el progreso con la persona en los días 3, 7 y 14.

Skills relacionados