Sitesmith — Creador de sitios web conversacional
Convierte unas pocas rondas de conversación en un sitio web terminado, opcionalmente bilingüe, y publícalo.
Produces datos, no código: un único site.json que una plantilla fija y bien diseñada renderiza.
Esto mantiene la salida estable y re-skinable.
Cuándo usarlo
Cuando el usuario quiera crear o actualizar un sitio web, página de aterrizaje, sitio personal o comercial, o portafolio — p. ej. "crea un sitio", "我想做个网站", "actualiza mi página principal", "haz una landing page para mi panadería".
Referencia rápida
Archivos de referencia — cárgalos con skill_view("sitesmith", "<ruta>") solo cuando sea necesario:
references/site.schema.json— el contrato que todosite.jsonDEBE cumplirreferences/sections.md— los 14 tipos de sección (incl.posts): cuándo usarlos, campos, límites de textoreferences/theme.md— tokens de tema (plantilla, colores, fuentes, radio, densidad)references/assets.md— estrategia de imágenes (placeholder / unsplash; nunca inventar assets)references/examples/innoe.site.json— ejemplo completo de una página (few-shot)references/examples/multipage.site.json— ejemplo de varias páginas + blog (few-shot)
Scripts — ejecuta a través de la herramienta de terminal:
| Acción | Comando |
|---|---|
| Validar | node ${HERMES_SKILL_DIR}/scripts/validate.mjs <site.json> |
| Renderizar | node ${HERMES_SKILL_DIR}/scripts/render.mjs <site.json> <out-dir> |
| Desplegar | bash ${HERMES_SKILL_DIR}/scripts/deploy.sh <out-dir> <dominio> |
Procedimiento
-
Recopila (3–5 turnos, preguntas agrupadas — no interrogar).
- Nombre del negocio + una línea sobre lo que hacen; industria + quiénes son sus clientes.
- Objetivo principal (llamadas / reservas / registros / vender / mostrar).
- Idiomas — por defecto el idioma del chat; ofrecer bilingüe (p. ej. es + en).
- Alcance: ¿una página o varias? Por defecto, una página. Si quieren más (o mencionan un blog), ofrece el conjunto estándar (Inicio / Acerca de / Servicios / Blog / Contacto) y déjales recortarlo — confirma la lista de páginas antes de construir.
- Top 3–5 servicios/productos; qué los hace diferentes; cualquier número real; datos de contacto + la llamada a la acción principal.
- Sensación en una o dos palabras (→
theme); assets (¿logo? ¿color de marca? ¿fotos reales?). - Si el usuario es escueto o dice "hazlo bonito", procede con valores predeterminados sensatos (una sola página es el predeterminado seguro).
-
Redacta
site.jsonconforme areferences/site.schema.json. Estudia primero el ejemplo correspondiente (innoe.site.jsonpara una sola página,multipage.site.jsonpara varias). Elige 5–8 secciones por página que coincidan con el contenido real (consultareferences/sections.mdpara el mapa objetivo→columna vertebral de secciones).- Una página: todo va en las
sectionsde nivel superior. - Varias páginas: el inicio permanece en
sectionsde nivel superior; añadepages[](una entrada por subpágina, cada una con sus propiassections). La navegación se deriva automáticamente de las páginas. Un blog es una página con una secciónposts(ligero: tarjetas de titulares, sin páginas de artículo). Elige el aspecto (consultareferences/theme.md): o selecciona una plantilla con estilo (newchinese/cyber/portfolio) cuando la marca tenga una estética fuerte y obvia, o — por defecto — usatemplate:"pro"y diseña una paleta personalizada tú mismo (primary/accent/neutral/font/radius/density) a partir de la sensación del negocio, para que cada sitio sea único. Maneja cada imagen segúnreferences/assets.md.
- Una página: todo va en las
-
Valida. Ejecuta
validate.mjs. En caso de error, lee los errores, corrige el JSON, vuelve a ejecutar. Nunca continúes con un archivo inválido. -
Renderiza. Ejecuta
render.mjs <site.json> <out-dir>→ un sitio estático en<out-dir>/dist. SiUNSPLASH_ACCESS_KEYestá configurada, el renderizado intercambia automáticamente los placeholdersunsplashpor fotos reales (con crédito); sin ella, se renderizan placeholders temáticos — ambos son adecuados para publicar. -
Previsualiza e itera. Resume en lenguaje sencillo lo que construiste ("un sitio bilingüe de 5 páginas: Inicio, Acerca de, Servicios, Diario, Contacto" — o "una página única de 6 secciones"). Dile al usuario que el sitio sigue siendo totalmente editable — puede pedirte en cualquier momento añadir/eliminar páginas o secciones, reescribir texto, cambiar colores o añadir entradas de blog. Aplica las ediciones reemitiendo el
site.jsoncompleto, luego revalida + rerenderiza. -
Despliega (solo después de que el usuario apruebe la vista previa). Ejecuta
deploy.sh <out-dir> <dominio>→ en vivo sobre Nginx con HTTPS. Informa la URL en vivo.
Errores comunes
- La salida son datos, no código. Solo produce
site.json. Nunca escribas HTML/CSS a mano. - El esquema es la ley. Los nombres de campo y los valores de enumeración deben coincidir exactamente; omite campos desconocidos.
- No inventes assets. Usa Media
type:"placeholder"(decorativo) o"unsplash"con unquery(foto de contenido); usa"image"solo con una URL real que el usuario haya dado. El logo por defecto estype:"text"a menos que exista un archivo de logo real. - Prefiere iconos sobre imágenes para características/servicios — los nombres de Lucide siempre se renderizan y se recolorean.
- Cada LocalizedText incluye todos los idiomas del sitio. Traduce idiomáticamente; nunca dejes uno en blanco.
- No sobreconstruyas. 5–8 secciones. Alterna fondos de sección; nunca dos
darko dosprimaryseguidas. Siempre empieza conhero, termina conctaocontact. - Sin afirmaciones que impliquen riesgos de cumplimiento — sin certificaciones, avales, subsidios/ayudas gubernamentales, premios o estadísticas inventadas que el usuario no haya declarado.
- Una sola página es el valor predeterminado. Solo añade
pages[]cuando el usuario quiera un sitio más rico/de varias páginas o un blog — y confirma la lista de páginas con ellos primero. El blog (posts) es una lista de titulares, no artículos completos; dilos, y señala que los artículos se pueden añadir más tarde.
Verificación
validate.mjssale con0(imprime el orden de secciones resuelto).render.mjsproduce<out-dir>/dist/index.html.- Después del despliegue,
curl -I https://<dominio>devuelve200.