Communitygithub.com

build-site

Ejecuta el pipeline completo de construcción de un sitio web: intake de brief y diseño, mapa del sitio y redacción, construcción, verificaciones, revisión, SEO y preparación para lanzamiento, con dos puertas de aprobación y un bucle de correcciones limitado.

¿Qué es build-site?

La skill 'build-site' automatiza el flujo de trabajo completo para construir un sitio web para un cliente, desde la recopilación inicial de requisitos hasta la preparación para el lanzamiento. Está diseñada para usarse en sesiones largas con asistentes como Claude Code y soporta múltiples etapas (0 a 8), incluyendo la redacción de copy, construcción visual, SEO, verificación técnica y revisión de calidad. La skill se basa en un pipeline secuencial con dos puertas de aprobación del usuario (en las etapas 1 y 6), lo que permite ajustes tempranos y evita retrabajos costosos. Utiliza subagentes especializados (copywriting, site-reviewer, seo, bug-fixer) y almacena el estado del pipeline en archivos dentro de `.claude/pipeline/`, lo que permite retomar el trabajo en múltiples sesiones. Es ideal para iniciar o reconstruir un sitio web, ya que integra buenas prácticas de SEO, accesibilidad y diseño, y genera documentación de lecciones aprendidas.

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

Preguntar en tu IA favorita

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

Documentación

Construir un sitio para cliente

La sesión principal ejecuta este pipeline y delega en subagentes. (Los subagentes no pueden iniciar otros subagentes, por eso esto es una skill, no un agente orquestador).

[0 Puerta de intake]  brief + DESIGN.md + referencias
      ↓
[1 Plan]  mapa del sitio, secciones de página, copy  →  plan.md, src/data/*
      ↓
[PUERTA DE USUARIO 1]  aprobar plan y copy
      ↓
[2 Construcción]  páginas y sistema visual
      ↓
[3 SEO]     agente seo            →  seo-report.md
      ↓
[4 Verificar]  npm run verify (puerta dura)
      ↓
[5 Revisión]  agente site-reviewer  →  review-report.md
      ↓
[6 Bucle de corrección]  P0/P1 → corregir → verificar → re-revisar (máx. 2 rondas)
      ↓
[PUERTA DE USUARIO 2]  aprobar el sitio
      ↓
[7 Preparación de lanzamiento]  lista de verificación de lanzamiento + documento de entrega
      ↓
[8 Lecciones]  añadir a docs/lessons.md

Artefactos

Todo va en .claude/pipeline/:

pipeline-state.md   etapa, ronda de corrección, última actualización
plan.md             mapa del sitio, secciones por página, acción principal por página
review-report.md    de site-reviewer
seo-report.md      de seo
screenshots/        de npm run verify

Lee pipeline-state.md al inicio de cada etapa y reanuda desde donde indica. Actualízalo al final de cada etapa. Esto permite que una construcción abarque varias sesiones.

Etapa 0: Puerta de intake

Verifica cada elemento. Si falta alguno, detente y ayuda al usuario a completarlo antes de cualquier otra cosa.

ElementoListo cuando
.agents/product-marketing.mdLa sección de datos comerciales está completa, la acción principal nombrada, la audiencia y la voz completas. Usa la skill product-marketing para redactarlo a partir de lo que te dé el usuario.
src/data/business.jsonNombre, teléfono, dirección, horario, enlace al mapa coinciden con el brief. Cópialos del brief.
DESIGN.mdCada sección está completa. Si el usuario solo tiene referencias, redáctalo a partir de references/ y pídele que lo confirme.
references/Al menos dos capturas de pantalla o URLs con una línea sobre qué tomar de cada una.
Recursos del clienteLogotipo y fotos, o una nota explícita de que los sustitutos están bien por ahora.
Edición¿Editará el cliente el sitio por sí mismo? (Afecta a la etapa 7).

Luego completa src/styles/tokens.css a partir de DESIGN.md.

Etapa 1: Plan

  1. Escribe plan.md: las páginas (la mayoría de los clientes necesitan Inicio, una página por oferta principal o una página de Menú/Servicios, Acerca de, Contacto), la acción principal por página y las secciones de cada página en orden. Usa el brief y site-essentials.
  2. Escribe el copy con la skill copywriting, luego ejecuta copy-editing sobre él. Parte del lenguaje del cliente en el brief y de las propias palabras del cliente, y usa algunas de esas frases casi textualmente. Sigue la regla interna 9 en CLAUDE.md (sin frases genéricas de IA). Ponlo en src/data/ (home.json, services, FAQs), no en componentes.
  3. Marca cualquier cosa que no sepas como [NEED: ...]. Nunca rellenes un vacío con un dato inventado.

Puerta de usuario 1

Detente. Muestra al usuario: el mapa del sitio, las secciones y la acción principal de cada página, el copy completo y cada elemento [NEED: ...]. Espera la aprobación o cambios. El copy es más barato de cambiar ahora que después de la construcción.

Etapa 2: Construcción

Construye con la skill design-taste-frontend (Taste Skill), dentro de este proyecto Astro. Antes de empezar, indícale:

  • El tipo es place (la gente va a él) o service (se contrata a personas), nunca un tipo tecnológico.
  • DESIGN.md y references/ establecen la paleta, la tipografía y la sensación. Su propia paleta y fuentes predeterminadas quedan anuladas.
  • Los datos comerciales provienen de src/data/business.json. Sus reglas de contacto predeterminadas no aplican.
  • El movimiento sigue las reglas internas en CLAUDE.md.

Construye página por página, comenzando por Inicio. Después de Inicio, ejecuta npm run verify, mira las tres capturas de pantalla y corrige lo que veas antes de construir la siguiente página. La puerta de finalización de Taste Skill se ejecuta por sí sola cuando se detiene; trata sus hallazgos como entrada, pero CLAUDE.md prevalece en caso de conflictos.

Etapa 3: SEO

El agente SEO edita las etiquetas head, JSON-LD y robots, por lo que se ejecuta antes de la verificación y la revisión. Así la revisión juzga el sitio terminado.

seo: "Auditar e implementar SEO para este sitio, incluyendo el paso de negocio local. Brief: .agents/product-marketing.md. Escribe tu informe en .claude/pipeline/seo-report.md."

Etapa 4: Verificar (puerta dura)

npm run verify

Todos los FALLOS de check-site y los problemas de capturas de pantalla (desplazamiento lateral, errores de consola) deben corregirse antes de la revisión. Los fallos [NEED: ...] solo están permitidos para datos que ya se le han pedido al usuario; enuméralos. Reescribe cualquier copy que check-site marque como genérico, a menos que el cliente realmente use esa palabra.

Etapa 5: Revisión

El revisor es de solo lectura y devuelve su informe como su mensaje final. Guarda ese mensaje textualmente en .claude/pipeline/review-report.md.

site-reviewer: "Revisa el sitio construido. Plan: .claude/pipeline/plan.md. Brief: .agents/product-marketing.md. Diseño: DESIGN.md. Capturas de pantalla: .claude/pipeline/screenshots/. Cambios SEO ya realizados: .claude/pipeline/seo-report.md. Devuelve el informe completo como tu mensaje final."

Etapa 6: Bucle de corrección

Veredicto de site-reviewerAcción
ListoIr a la puerta 2
Requiere seguimiento, solo P2Ir a la puerta 2, listar los P2
Requiere seguimiento (P1) o Bloqueado (P0)Ronda < 2: corregirlos, volver a ejecutar la etapa 4 (verificar), volver a ejecutar site-reviewer en las páginas cambiadas y guardar su informe. Ronda = 2: detenerse y mostrar al usuario.

Usa el agente bug-fixer para cualquier cosa que esté rota en lugar de simplemente fuera del brief. Incrementa la ronda en pipeline-state.md cada vez.

Puerta de usuario 2

Detente. Muestra al usuario: capturas de pantalla de Inicio a 390 y 1440, el veredicto, los P2 restantes, decisiones de SEO necesarias, elementos [NEED: ...] restantes y fotos provisionales a reemplazar. Espera la aprobación.

Etapa 7: Preparación para lanzamiento

  1. Ejecuta npm run check:launch y corrige cada FALLO. Luego completa docs/launch-checklist.md, marcando cada elemento como hecho, no aplicable, o esperando a alguien (indica quién).
  2. Completa docs/handoff.md para el cliente.
  3. Si el cliente va a editar el sitio, sigue docs/client-editing.md.
  4. Después de que el sitio esté en vivo en su dominio real, recuerda al usuario que ejecute claude-seo en él: /seo local <url> y /seo audit <url>.

Etapa 8: Lecciones

Escanea los informes y las rondas de corrección en busca de cualquier cosa que haya salido mal dos veces o que haya costado tiempo real. Añade una línea con fecha por lección a docs/lessons.md. Indica al usuario qué lecciones vale la pena copiar de vuelta a site-starter para que todos los sitios futuros las reciban.

Skills relacionados