Communitygithub.com

zijieguo2003/blog-builder-skill

Guía para configurar rápidamente un blog personal desde cero. Cubre selección de framework (Hugo, Hexo, Astro, Next.js), configuración de temas, generación de plantillas de entradas con frontmatter, despliegue en GitHub Pages / Vercel / Cloudflare Pages y configuración completa de SEO (sitemap, robots.txt, Open Graph, URLs canónicas).

¿Qué es blog-builder-skill?

Esta habilidad permite a un agente de IA guiar a un usuario en la creación completa de un blog personal, desde la elección del framework hasta el despliegue en vivo con SEO optimizado. Es útil para desarrolladores de cualquier nivel (desde no técnicos hasta expertos en React/Next.js) que deseen lanzar un sitio web estático o un blog sin tener que investigar cada paso por separado. La habilidad soporta frameworks populares como Hugo, Hexo, Astro y Next.js, y plataformas de despliegue como GitHub Pages, Vercel y Cloudflare Pages. El flujo de trabajo incluye seis pasos: entender el contexto del usuario, recomendar un framework, configurar el framework usando archivos de referencia, generar una plantilla de entrada con frontmatter, desplegar mediante GitHub Actions u otros métodos, y configurar SEO completo (sitemap, robots.txt, Open Graph y URLs canónicas). El agente proporciona contenido de archivos reales (código, YAML, TOML) en lugar de solo descripciones, y señala los errores comunes (como la configuración de baseURL en Hugo o el campo site en Astro).

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add zijieguo2003/blog-builder-skill

Preguntar en tu IA favorita

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

Documentación

Constructor de Blogs

Ayuda al usuario a lanzar un blog personal, desde la elección de un framework hasta el despliegue en vivo con SEO adecuado. Alcance completo: elección de framework -> tema -> plantilla de entrada -> despliegue -> SEO.

Flujo de Trabajo

Paso 1 -- Comprender el contexto del usuario

Pregunta (o infiere del contexto):

  • ¿Antecedentes técnicos? (no técnico / desarrollador JS / desarrollador Python / etc.)
  • ¿Empieza desde cero o ya tiene un sitio existente?
  • ¿Destino de despliegue preferido: GitHub Pages, Vercel, Cloudflare Pages?
  • ¿Enfoque del contenido: escritura, portafolio, blog de tutoriales, documentación?

Paso 2 -- Recomendar un framework

SituaciónRecomendado
No técnico, solo quiere escribirHugo -- sin JS, rápido, amplia biblioteca de temas
Ya escribe JS/TS, quiere control de componentesAstro -- arquitectura de islas, gran experiencia de desarrollo
Le encantan los ecosistemas de temas, se siente cómodo con NodeHexo -- ecosistema maduro de plugins
Desarrollador React, quiere control totalNext.js -- App Router + MDX

Presenta la recomendación con una justificación breve. Confirma antes de continuar.

Paso 3 -- Configuración del framework

Lee el archivo de referencia correspondiente y guía al usuario en la instalación + un tema inicial:

FrameworkArchivo de referencia
Hugoreferences/hugo.md
Hexoreferences/hexo.md
Astroreferences/astro.md
Next.jsreferences/nextjs.md

Paso 4 -- Generar una plantilla de entrada

Produce un archivo de plantilla de entrada listo para usar con frontmatter completo. Las plantillas de activos en assets/post-templates/ son puntos de partida: cópialas y adáptalas al tema elegido por el usuario y sus preferencias.

Paso 5 -- Despliegue

Lee references/deployment.md para el flujo de CI/CD adecuado. Proporciona el YAML completo de GitHub Actions, listo para confirmar.

Notas clave:

  • GitHub Pages: subir a .github/workflows/deploy.yml; habilitar Pages en la configuración del repositorio
  • Vercel: conectar el repositorio en el dashboard; configurar el preset del framework y el directorio de salida
  • Cloudflare Pages: comando de compilación = npm run build, directorio de salida = dist (Astro/Hexo/Next.js) o public (Hugo)

Paso 6 -- Configuración de SEO

Cada blog necesita:

  1. sitemap.xml -- específico del framework; ver references/.md
  2. robots.txt -- proporcionar el contenido real del archivo, no solo una descripción
  3. Etiquetas Open Graph -- og:title, og:description, og:image, og:url como marcado real
  4. URLs canónicas -- establecer baseURL / site en la configuración para que los sitemaps y las etiquetas OG funcionen correctamente

Siempre ten en cuenta: la URL del sitio debe estar configurada en el framework para que el sitemap genere URLs absolutas correctas.

Principios rectores

  • Proporcionar contenido real de archivos (código, YAML, TOML), no solo descripciones
  • Incluir solo los campos que importan: evitar plantillas abrumadoras
  • Señalar uno o dos errores comunes que pueden desorientar a los usuarios (por ejemplo, baseURL de Hugo, campo site de Astro)
  • Preferir ejemplos listos para copiar y pegar

Skills relacionados