Communitygithub.com

zijieguo2003/blog-builder-skill

Guia para configurar rapidamente um blog pessoal do zero. Abrange seleção de framework (Hugo, Hexo, Astro, Next.js), configuração de tema, geração de templates de postagens com frontmatter, implantação no GitHub Pages / Vercel / Cloudflare Pages e configuração completa de SEO (sitemap, robots.txt, Open Graph, URLs canônicas).

O que é blog-builder-skill?

Esta habilidade é um assistente completo para criar e lançar um blog pessoal, desde a escolha do framework até a implantação com SEO otimizado. Ela suporta os principais frameworks estáticos: Hugo, Hexo, Astro e Next.js, cada um com recomendações baseadas no perfil técnico do usuário (iniciante, desenvolvedor JS, desenvolvedor React, etc.). O fluxo de trabalho inclui seis etapas: entender o contexto do usuário, recomendar o framework adequado, configurar o ambiente com temas iniciais, gerar templates de postagens com frontmatter pronto, implantar via GitHub Actions (GitHub Pages, Vercel ou Cloudflare Pages) e configurar SEO completo (sitemap, robots.txt, Open Graph e URLs canônicas). A habilidade prioriza fornecer conteúdo de arquivo real (código, YAML, TOML) em vez de apenas descrições, garantindo exemplos prontos para copiar e colar. Ela deve ser acionada sempre que o usuário mencionar criação de blog, site estático, portfólio, site pessoal ou configuração de SEO para blog.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add zijieguo2003/blog-builder-skill

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Blog Builder

Ajude o usuário a lançar um blog pessoal -- desde a escolha de um framework até a implantação ao vivo com SEO adequado. Escopo completo: escolha do framework -> tema -> template de postagem -> implantação -> SEO.

Fluxo de Trabalho

Passo 1 -- Entender o contexto do usuário

Pergunte (ou deduza pelo contexto):

  • Formação técnica? (não técnico / desenvolvedor JS / desenvolvedor Python / etc.)
  • Começando do zero ou já possui um site existente?
  • Alvo de implantação preferido: GitHub Pages, Vercel, Cloudflare Pages?
  • Foco do conteúdo: escrita, portfólio, blog tutorial, documentação?

Passo 2 -- Recomendar um framework

SituaçãoRecomendado
Não técnico, só quer escreverHugo -- zero JS, rápido, enorme biblioteca de temas
Já escreve JS/TS, quer controle de componentesAstro -- arquitetura islands, ótima DX
Ama ecossistemas de temas, confortável com NodeHexo -- ecossistema maduro de plugins
Desenvolvedor React, quer controle totalNext.js -- App Router + MDX

Apresente a recomendação com uma breve justificativa. Confirme antes de prosseguir.

Passo 3 -- Configuração do framework

Leia o arquivo de referência relevante e guie o usuário na instalação + um tema inicial:

FrameworkArquivo de referência
Hugoreferences/hugo.md
Hexoreferences/hexo.md
Astroreferences/astro.md
Next.jsreferences/nextjs.md

Passo 4 -- Gerar um template de postagem

Produza um arquivo de template de postagem pronto para uso com frontmatter completo. Os templates de ativos em assets/post-templates/ são pontos de partida -- copie e adapte para o tema escolhido pelo usuário e suas preferências.

Passo 5 -- Implantação

Leia references/deployment.md para o fluxo de CI/CD apropriado. Forneça o YAML completo do GitHub Actions, pronto para commit.

Notas importantes:

  • GitHub Pages: envie para .github/workflows/deploy.yml; ative Pages nas configurações do repositório
  • Vercel: conecte o repositório no dashboard; defina o preset do framework e o diretório de saída
  • Cloudflare Pages: comando de build = npm run build, diretório de saída = dist (Astro/Hexo/Next.js) ou public (Hugo)

Passo 6 -- Configuração de SEO

Todo blog precisa de:

  1. sitemap.xml -- específico do framework; veja references/.md
  2. robots.txt -- forneça o conteúdo real do arquivo, não apenas uma descrição
  3. Tags Open Graph -- og:title, og:description, og:image, og:url como marcação real
  4. URLs canônicas -- defina baseURL / site na configuração para que sitemaps e tags OG funcionem corretamente

Sempre observe: a URL do site deve ser definida na configuração do framework para que o sitemap gere URLs absolutas corretas.

Princípios orientadores

  • Forneça conteúdo real de arquivo (código, YAML, TOML), não apenas descrições
  • Inclua apenas os campos que importam -- evite boilerplate esmagador
  • Aponte uma ou duas armadilhas que costumam pegar as pessoas (ex.: baseURL do Hugo, campo site do Astro)
  • Prefira exemplos prontos para copiar e colar

Habilidades Relacionadas