Communitygithub.com

YuukiMarine/websiteskills

Construye y despliega un sitio web mediante conversación: recopila requisitos, genera un site.json validado, lo renderiza con la plantilla Sitesmith y lo publica en Nginx. Úsalo para "crea/hazme un sitio web", páginas de aterrizaje, sitios personales/comerciales, portafolios.

¿Qué es websiteskills?

Sitesmith es un generador de sitios web conversacional que transforma unas pocas rondas de diálogo en un sitio web completamente funcional, opcionalmente bilingüe, y lo publica. En lugar de escribir código HTML/CSS, el asistente produce un archivo `site.json` que sigue un esquema estricto (`site.schema.json`) y lo renderiza mediante una plantilla fija y bien diseñada. Esto asegura que la salida sea estable, re-skinable y fácil de mantener. El flujo de trabajo incluye: recopilación de requisitos (en 3-5 turnos), redacción del `site.json` conforme al esquema, validación automática, renderizado estático, previsualización interactiva y despliegue sobre Nginx con HTTPS. Soporta páginas individuales o multi-página (incluyendo blogs ligeros con tarjetas de titulares), temas predefinidos o paletas personalizadas, y manejo de imágenes reales o de Unsplash. Es ideal para landing pages, sitios personales, de negocios o portafolios, y se integra con herramientas de línea de comandos (Node.js y bash) para validar, renderizar y desplegar.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YuukiMarine/websiteskills/tree/HEAD/skill

Preguntar en tu IA favorita

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

Documentación

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 todo site.json DEBE cumplir
  • references/sections.md — los 14 tipos de sección (incl. posts): cuándo usarlos, campos, límites de texto
  • references/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ónComando
Validarnode ${HERMES_SKILL_DIR}/scripts/validate.mjs <site.json>
Renderizarnode ${HERMES_SKILL_DIR}/scripts/render.mjs <site.json> <out-dir>
Desplegarbash ${HERMES_SKILL_DIR}/scripts/deploy.sh <out-dir> <dominio>

Procedimiento

  1. 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).
  2. Redacta site.json conforme a references/site.schema.json. Estudia primero el ejemplo correspondiente (innoe.site.json para una sola página, multipage.site.json para varias). Elige 5–8 secciones por página que coincidan con el contenido real (consulta references/sections.md para el mapa objetivo→columna vertebral de secciones).

    • Una página: todo va en las sections de nivel superior.
    • Varias páginas: el inicio permanece en sections de nivel superior; añade pages[] (una entrada por subpágina, cada una con sus propias sections). La navegación se deriva automáticamente de las páginas. Un blog es una página con una sección posts (ligero: tarjetas de titulares, sin páginas de artículo). Elige el aspecto (consulta references/theme.md): o selecciona una plantilla con estilo (newchinese/cyber/portfolio) cuando la marca tenga una estética fuerte y obvia, o — por defecto — usa template:"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ún references/assets.md.
  3. 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.

  4. Renderiza. Ejecuta render.mjs <site.json> <out-dir> → un sitio estático en <out-dir>/dist. Si UNSPLASH_ACCESS_KEY está configurada, el renderizado intercambia automáticamente los placeholders unsplash por fotos reales (con crédito); sin ella, se renderizan placeholders temáticos — ambos son adecuados para publicar.

  5. 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.json completo, luego revalida + rerenderiza.

  6. 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 un query (foto de contenido); usa "image" solo con una URL real que el usuario haya dado. El logo por defecto es type:"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 dark o dos primary seguidas. Siempre empieza con hero, termina con cta o contact.
  • 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.mjs sale con 0 (imprime el orden de secciones resuelto).
  • render.mjs produce <out-dir>/dist/index.html.
  • Después del despliegue, curl -I https://<dominio> devuelve 200.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados