Communitygithub.com

Publicar Sitio Estático

Publica, despliega o prepara un sitio web personal estático terminado, blog, portafolio o recreación de estilo para alojamiento en GitHub Pages, Cloudflare Pages, Netlify o Vercel.

¿Qué es Publicar Sitio Estático?

Esta habilidad automatiza la publicación de sitios web estáticos terminados (HTML/CSS/JS) en plataformas de alojamiento populares. Su propósito es simplificar el proceso de despliegue, configurando archivos específicos de la plataforma y guiando al usuario a través de los pasos necesarios. Soporta GitHub Pages, Cloudflare Pages, Netlify y Vercel, priorizando el alojamiento estático simple sobre soluciones basadas en frameworks. La habilidad se asegura de que el sitio esté listo para producción mediante una lista de verificación previa al vuelo que incluye la verificación de rutas de activos, codificación y contenido privado. Además, realiza una verificación posterior al despliegue para confirmar que el sitio se cargue correctamente, los activos estén accesibles y la navegación funcione. Si faltan credenciales de la plataforma, proporciona pasos manuales para el panel de control en lugar de soluciones alternativas.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Gyschuaner/from-idea-to-personal-site/tree/HEAD/.agents/skills/publish-static-site

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Publicar Sitio Estático?

Objetivo

Publicar o preparar el despliegue de un sitio web estático terminado.

Esta habilidad es para el resultado HTML/CSS/JS desplegable, como site/, dist/, out/, public/ o docs/. También puede publicar proyectos de frameworks después de que produzcan una carpeta de salida estática, pero no debe convertir un sitio estático simple en un proyecto de framework solo para desplegarlo.

Postura predeterminada:

  • Preferir alojamiento estático simple sobre despliegues específicos de frameworks.
  • Preferir despliegue basado en Git para sitios que el usuario seguirá editando.
  • Preferir carga directa solo para publicaciones rápidas y únicas.
  • No crear repositorios remotos, enviar código, cambiar DNS, agregar dominios ni desplegar en una cuenta de pago a menos que el usuario lo solicite explícitamente.

Contrato

Entradas:

  • Raíz de despliegue estático, como site/, dist/, out/, public/, docs/ o la raíz del repositorio.
  • Plataforma o destino preferido: GitHub Pages, Cloudflare Pages, Netlify, Vercel, dominio personalizado, solo orientación o despliegue en vivo.
  • Estado actual de Git/repositorio, acceso a la cuenta de la plataforma, inicio de sesión CLI/navegador y cualquier restricción de despliegue.

Salidas:

  • Configuración de despliegue concreta: plataforma, rama, comando de compilación, directorio base, directorio de publicación/salida y archivos de configuración cuando sea necesario.
  • Configuración opcional específica de la plataforma, como flujo de trabajo de GitHub Pages, netlify.toml, vercel.json, .nojekyll o CNAME.
  • URL en vivo y verificación posterior al despliegue cuando el despliegue se realiza realmente.
  • Pasos manuales del panel de control cuando no están disponibles las credenciales o el acceso a la cuenta.

Límites:

  • No construir ni rediseñar el sitio; derivar los defectos a la habilidad secundaria adecuada.
  • No enviar, crear repositorios/proyectos, cargar, vincular dominios, cambiar DNS ni usar recursos de pago a menos que esté expresamente autorizado.
  • No usar el despliegue como solución para problemas de compatibilidad local/estática a menos que el usuario acepte explícitamente un comportamiento solo de raíz de servidor.

Puerta de éxito:

  • review-static-site ha pasado o los riesgos no resueltos son explícitos.
  • La raíz de despliegue contiene index.html y la plataforma publicará la carpeta correcta.
  • La URL en línea carga la página de inicio, los activos, la navegación y las subpáginas representativas después del despliegue.

Si la puerta falla:

  • Corregir los bloqueadores de ruta, activo, codificación o tipo de página antes del despliegue.
  • Derivar los problemas de contenido/diseño/importación a personalize-site, edit-site-part, add-blog-posts, make-personal-site o copy-website-style.
  • Volver a ejecutar review-static-site y luego reintentar o actualizar la configuración de despliegue.

Referencias

Cargue solo la referencia necesaria para la plataforma o problema elegido:

  • Estrategia de ruta y compatibilidad de apertura directa: references/path-strategy.md.
  • Integración Git de Cloudflare Pages y Carga Directa: references/cloudflare-pages.md.
  • Fuente de rama de GitHub Pages y flujos de trabajo de Actions: references/github-pages.md.
  • Panel de Netlify y netlify.toml: references/netlify.md.
  • Panel de Vercel y vercel.json: references/vercel.md.

Documentación oficial:

Modos de Despliegue

Primero determine lo que el usuario realmente quiere:

  • Solo orientación: explicar la elección de la plataforma y la configuración exacta. No editar archivos a menos que sea útil.
  • Preparar repositorio: agregar los archivos de configuración necesarios y decirle al usuario qué hacer clic en el panel de alojamiento.
  • Desplegar ahora: realizar acciones remotas solo si el usuario lo solicitó explícitamente y existe la CLI/auth/sesión requerida.
  • Verificar URL en vivo: abrir la URL desplegada en un navegador y compararla con el sitio local.

Si faltan credenciales, acceso a la cuenta, inicio de sesión del navegador o autenticación CLI, proporcione los pasos exactos del panel en lugar de inventar una solución alternativa.

Flujo de Trabajo

  1. Identificar la carpeta de salida estática y la plataforma preferida del usuario, si la hay.
  2. Llamar o sugerir usar review-static-site antes de publicar.
  3. Confirmar que la raíz de despliegue contiene index.html.
  4. Inspeccionar las rutas de los activos y convertir las rutas absolutas de raíz accidentales a rutas locales del sitio antes de publicar. Cargar references/path-strategy.md cuando el comportamiento de la ruta no esté claro.
  5. Elegir la plataforma y el modo de despliegue más simples.
  6. Cargar la referencia de la plataforma elegida y agregar solo los archivos de configuración requeridos por esa plataforma.
  7. Si se despliega a través de Git, verificar el estado de Git y evitar incluir archivos no relacionados o privados.
  8. Si el usuario autorizó acciones remotas, enviar o desplegar exactamente lo acordado.
  9. Después de publicar, abrir la URL en vivo y verificar el sitio desplegado en un navegador.

Lista de Verificación Previa al Vuelo

Realizar estas comprobaciones antes de escribir configuraciones de despliegue o decirle al usuario la configuración:

  • Raíz de despliegue: elegir la carpeta que contiene directamente index.html.
  • Página de entrada: index.html debe existir en el nivel superior de la raíz de despliegue.
  • Vista previa de apertura directa: el index.html raíz debe mantener CSS, JS, imágenes y navegación cuando se abre directamente desde el sistema de archivos, a menos que el usuario acepte explícitamente un comportamiento solo de servidor.
  • HTTP local: servir la raíz de despliegue con python -m http.server y confirmar que funciona a través de http://127.0.0.1:<porto>/.
  • Auditoría estática: ejecutar o recomendar review-static-site para enlaces, legibilidad UTF-8, residuos de marcadores de posición, renderizado del navegador, residuos de privacidad y diseño móvil.
  • Rutas de activos: inspeccionar href, src, srcset, CSS url(...), fuentes, favicons, imágenes de portada, RSS, sitemap y enlaces de manifiesto.
  • Datos privados: asegurarse de que los tokens, las rutas del sistema de archivos local, las notas borrador, las identidades del sitio de origen y los secretos personales no se estén publicando.
  • Integridad de la salida: confirmar que las subpáginas, publicaciones, imágenes, fuentes de proveedores, activos KaTeX/matemáticos y medios copiados estén dentro de la raíz de despliegue.

Tratar estos como bloqueadores:

  • No hay index.html en la raíz de despliegue.
  • Rutas de activos CSS, JS, imagen, fuente, RSS, sitemap o proveedor rotas localmente.
  • Los archivos fuente contienen mojibake o codificación ilegible.
  • El sitio personal generado aún contiene la identidad copiada de la fuente que debería haber sido reemplazada.
  • Rutas accidentales absolutas de raíz locales del sitio como /assets/..., /posts/..., /data/... o /images/... permanecen en un sitio estático plano generado.
  • El sitio funciona solo a través de HTTP local porque las rutas absolutas de raíz se sirven desde 127.0.0.1, pero la apertura directa de archivos o el despliegue en subruta perdería CSS/JS/imágenes.
  • Se desplegarían archivos sensibles a la privacidad o secretos.
  • La plataforma desplegaría la carpeta incorrecta.

Elección de Plataforma

Usar esta clasificación predeterminada para sitios personales estáticos simples:

  1. Integración Git de Cloudflare Pages: mejor opción predeterminada para una carpeta site/ generada y actualizaciones futuras.
  2. GitHub Pages con GitHub Actions: mejor cuando el usuario quiere todo dentro de GitHub.
  3. Netlify: alojamiento estático simple con vistas previas amigables y configuración del panel.
  4. Vercel: bueno cuando el usuario ya usa Vercel o puede migrar a Next.js más tarde, pero no es la opción predeterminada para HTML simple.

Reglas de decisión:

  • Si el usuario quiere la menor fricción y tiene un repositorio de GitHub: Integración Git de Cloudflare Pages. Cargar references/cloudflare-pages.md.
  • Si el usuario quiere alojamiento solo de GitHub: GitHub Pages. Cargar references/github-pages.md.
  • Si los archivos de despliegue viven en la raíz del repositorio o en /docs: la fuente de la rama de GitHub Pages es aceptable.
  • Si los archivos de despliegue viven en site/, dist/, out/ u otra carpeta personalizada: preferir GitHub Actions para GitHub Pages.
  • Si el usuario quiere carga manual hoy: Carga Directa de Cloudflare o despliegue manual de Netlify.
  • Si el usuario ya tiene una cuenta/proyecto de Vercel: usar Vercel con ajustes explícitos del directorio de salida.

Salida Estática de Framework

Si el sitio no es HTML/CSS/JS simple:

  • Inspeccionar package.json, la configuración del framework y los scripts existentes.
  • Usar el comando de compilación existente del proyecto; no inventar flujos de trabajo npm.
  • Publicar la carpeta de salida estática final, no la carpeta de origen.
  • Las salidas comunes incluyen dist, out, build, .output/public y public, dependiendo del framework.
  • Para la exportación estática de Next.js, verificar que el proyecto esté realmente configurado para exportación estática antes de tratar out/ como salida final.
  • Para proyectos Vue/Vite/Astro, publicar el directorio de salida configurado después de una compilación exitosa.

Si el usuario solicitó publicación estática simple y no existen archivos de framework, no introducir npm.

Política de Archivos de Configuración

Solo agregar archivos de configuración que coincidan con la plataforma elegida:

  • Acciones de GitHub Pages: .github/workflows/pages.yml.
  • Dominio personalizado de GitHub Pages: CNAME en la raíz desplegada, solo cuando el usuario proporcionó el dominio.
  • Bypass de Jekyll de GitHub Pages: .nojekyll en la raíz desplegada cuando sea útil.
  • Netlify: netlify.toml solo cuando la configuración del panel no sea suficiente o el usuario quiera la configuración en Git.
  • Vercel: vercel.json solo cuando Vercel necesite ajustes de salida explícitos.
  • Cloudflare Pages: normalmente la configuración del panel es suficiente para sitios estáticos simples.

No agregar configuraciones de despliegue para todas las plataformas a la vez.

Seguridad de Git y Remoto

Antes de cualquier acción remota, indicar lo que sucederá y confirmar que el usuario lo solicitó:

  • Crear un repositorio de GitHub.
  • Agregar un remoto.
  • Preparar o confirmar archivos.
  • Enviar commits a una rama remota.
  • Habilitar GitHub Pages.
  • Crear proyectos de Cloudflare, Netlify o Vercel.
  • Cargar archivos a un proveedor de alojamiento.
  • Agregar variables de entorno.
  • Agregar dominios personalizados o cambiar registros DNS.

Antes de preparar o enviar:

  • Ejecutar git status --short.
  • Identificar archivos de sitio generados frente a cambios no relacionados del usuario.
  • No preparar cambios no relacionados.
  • No publicar notas privadas, credenciales, rutas locales, capturas de pantalla con secretos ni archivos temporales.

Nunca poner secretos, tokens, notas privadas o rutas del sistema de archivos local en el sitio estático o la configuración de despliegue.

Verificación Posterior al Despliegue

Después de que la plataforma informe una URL en vivo:

  • Abrir la URL desplegada con una herramienta de navegador interactiva realmente disponible. "Disponible" significa que está expuesta en la lista de herramientas invocables del turno actual. En Codex, esto puede ser el complemento Browser/in-app browser cuando se enruta en el turno.
  • Verificar que la página de inicio no sea un 404, una página en blanco o un listado de directorio.
  • Verificar que CSS, JavaScript, imágenes, fuentes, favicon, RSS, sitemap y activos de proveedores se carguen desde el dominio desplegado.
  • Hacer clic en la navegación principal y al menos una subpágina representativa por tipo de página.
  • Probar anchos de escritorio y móvil.
  • Revisar la consola del navegador en busca de activos faltantes o errores de JavaScript.
  • Confirmar metadatos, título, descripción, imagen de Open Graph, URL canónica, RSS, sitemap y archivos robots cuando estén presentes.
  • Si se usa GitHub Pages de proyecto, verificar específicamente las URLs de subpáginas y activos bajo la subruta del repositorio.
  • Si se usa un dominio personalizado, verificar HTTPS y redirecciones entre apex y www si está configurado.

Si no es invocable ninguna herramienta de navegador interactiva, no fingir que se realizó la verificación del navegador en vivo. Preguntar al usuario que habilite o invoque la herramienta de navegador si la verificación visual en vivo es importante; para Codex, eso puede significar enviar una solicitud que mencione explícitamente @browser. Si el usuario no redirige o el cliente no tiene dicha herramienta, recurrir a Playwright, capturas de pantalla, comprobaciones HTTP o comprobaciones estáticas e indicar la limitación.

No predeterminar a Playwright o verificación en vivo solo con capturas de pantalla cuando una herramienta de navegador interactiva es realmente invocable. Usar Playwright solo como alternativa, o cuando el usuario solicite explícitamente comprobaciones de despliegue con script.

Si el sitio desplegado difiere de la vista previa local, inspeccionar el registro de despliegue, el directorio de salida y la estrategia de ruta de activos antes de cambiar el código de diseño.

Salida

Mantener conciso el informe final dirigido al usuario:

  • Plataforma elegida y por qué.
  • Carpeta estática publicada o preparada.
  • Modo de despliegue: orientación, configuración preparada, integración Git, carga directa o despliegue en vivo.
  • Configuración utilizada: rama, comando de compilación, directorio base, directorio de publicación/salida.
  • Archivos de configuración modificados, si los hay.
  • URL de la guía oficial de la plataforma elegida.
  • URL en vivo, si se realizó el despliegue.
  • Verificación realizada y cualquier paso manual restante.

Si solo se solicitó orientación, no fingir que el sitio fue desplegado. Proporcionar ajustes concretos de la plataforma y enlaces a la guía oficial.

Individual skills in this repo

This repo contains 10 individual skills — each has its own dedicated page.

Gyschuaner/from-idea-to-personal-site

Use this skill to add, import, or migrate one or more blog posts, notes, essays, articles, Markdown files, Word documents, or rich-content writing folders into an existing static personal website or blog while preserving the site's current article style, content structure, navigation, indexes, archives, tags, assets, math, links, tables, code blocks, embeds, and homepage entry points. Use it for pasted posts, local Markdown files, Obsidian notes, .docx drafts, old static HTML posts, exported blog content, or small-to-medium batches of posts after a site has already been created.

Gyschuaner/from-idea-to-personal-site

Route and coordinate the personal website skill suite for creating, recreating, personalizing, adding content to, validating, editing, or preparing a static personal website or blog. Use when the agent needs to choose between theme search, style reference research, original build, website style recreation, personalization, post import, review, local edits, or publishing preparation, or when the user asks what step comes next in an existing site-building workflow.

Gyschuaner/from-idea-to-personal-site

Use this skill when the user wants to recreate, copy, clone, remix, or closely match the look, layout, motion, or interaction feel of a specific website, URL, screenshot, or template using plain HTML, CSS, and JavaScript. Use it to inspect public source as research, rewrite original code, avoid direct reuse of protected assets, and validate the result in a browser.

Gyschuaner/from-idea-to-personal-site

Use this skill to make focused, small-scope edits to a generated static website, personal blog, portfolio, digital garden, or style recreation. Use it when the user wants to adjust one page section, component, visual detail, copy block, responsive issue, or lightweight interaction without rebuilding the whole site. Typical requests include changing a hero block, card layout, sidebar, footer, button, mobile menu, spacing, color, typography, animation intensity, or a small piece of page copy.

Gyschuaner/from-idea-to-personal-site

Use this skill after a personal website or blog style direction is roughly known and before building an original site. It searches for real websites, templates, portfolios, blogs, screenshots, or design examples that match the chosen direction, inspects them with browser or screenshot tools when available, and turns the findings into a practical design reference brief for make-personal-site. Use it for requests like finding references for a natural technical blog, cozy research homepage, brutalist portfolio, digital garden, minimal notes site, or any named visual direction that still needs concrete examples.

Gyschuaner/from-idea-to-personal-site

Run the complete idea-to-personal-website or blog workflow. Use when the user wants a one-click or end-to-end pipeline from a vague idea, reference URL, template, personal materials, style direction, or writing drafts to concrete style references, a validated static personal site, and optionally a live deployment on GitHub Pages, Cloudflare Pages, Netlify, or Vercel.

Gyschuaner/from-idea-to-personal-site

Use this skill when the user wants to create, implement, redesign, or update a zero-dependency personal website, personal blog, homepage, portfolio, research homepage, or digital garden using plain HTML, CSS, and JavaScript. Use it after a theme direction has been chosen, or when the user wants a no-framework site that can be opened directly in the browser and deployed as static files.

Gyschuaner/from-idea-to-personal-site

Use this skill to turn a generated static personal website, blog, portfolio, digital garden, or style recreation into the user's own site by replacing placeholder identity, profile copy, links, projects, featured items, contact details, metadata, and demo page content. Use it after make-personal-site or copy-website-style, or when a user provides an existing static site folder and personal materials such as a bio, resume, README, GitHub profile, old homepage, Markdown notes, or social links.

Gyschuaner/from-idea-to-personal-site

Use this skill to inspect, validate, QA, or sanity-check a generated static website, personal blog, portfolio, digital garden, or style recreation before handoff or publishing. Use it for local folders such as site/, dist/, out/, or public/ to check broken links, missing page types, browser rendering, console errors, desktop/mobile screenshots, UTF-8 source readability, mojibake, relative asset paths, direct-open/file compatibility, placeholder content, and leftover copied source-specific text.

Gyschuaner/from-idea-to-personal-site

Use this skill when the user wants to find, compare, choose, or adapt a visual theme for a personal blog, personal homepage, portfolio, research homepage, digital garden, or static website. Use it to turn references from v0, Figma, GitHub themes, existing websites, screenshots, keywords, or natural-language taste preferences into natural, practical theme recommendations.

Skills relacionados