Claude Code Skills de SEO/GEO: meu sistema open source

Minhas Claude Code Skills de SEO/GEO: o sistema open source que uso para publicar no WordPress

·

·

Capa editorial mostrando um workflow técnico de Claude Code Skills, SEO/GEO e WordPress

Eu publiquei no GitHub uma versão sanitizada das Claude Code Skills que uso no ViniEnsina para criar artigos, produzir páginas citáveis, gerar capas e configurar SEO no WordPress.

Não é uma coleção de prompts soltos. É um pedaço real do meu fluxo editorial, adaptado para virar open source sem expor credenciais, automações privadas ou decisões estratégicas internas.

Capa editorial mostrando um workflow técnico de Claude Code Skills, SEO/GEO e WordPress
Capa editorial mostrando um workflow técnico de Claude Code Skills, SEO/GEO e WordPress

Resposta rápida: o que foi publicado?

Publiquei o repositório claude-code-seo-geo-skills-pt-br, com quatro Skills para Claude Code:

Print do repositório claude-code-seo-geo-skills-pt-br no GitHub
Print do repositório claude-code-seo-geo-skills-pt-br no GitHub
Skill O que faz
blog-article Cria artigos completos em HTML para WordPress, com estrutura editorial, SEO/GEO, rascunho via API e capa
backlinks Cria artigos de estatísticas e levantamentos pensados para receber backlinks e citações de IA
cover-image Gera capa 1200×675 com foto do Unsplash, overlay, branding e upload como featured image
rankmath-seo Preenche focus keyword, meta description e campos do Rank Math via API

O objetivo é simples: transformar produção de conteúdo com IA em um processo repetível.

Em vez de pedir “faz um artigo bom sobre esse tema” e torcer pelo resultado, cada Skill dá ao Claude Code um procedimento: quais inputs pedir, qual estrutura seguir, quais riscos evitar, como entregar e onde o humano precisa revisar.

Por que eu abri esse sistema?

A maior parte do conteúdo sobre IA e SEO ainda fica em dois extremos.

De um lado, tem o tutorial genérico: “use IA para escrever posts mais rápido”. Ele ajuda no começo, mas não resolve consistência.

Do outro, tem o setup fechado: automações, prompts e checklists internos que ninguém vê. Pode funcionar, mas não cria referência pública.

Eu queria uma terceira opção: abrir a parte reaproveitável do método.

O repositório mostra a lógica editorial, a estrutura de SEO/GEO, o fluxo WordPress e os cuidados de segurança. Mas ele não entrega credenciais, automações privadas, calendário editorial, clusters futuros ou dados internos de operação.

É método aberto, operação protegida.

O problema: IA escreve texto, mas não cria processo sozinha

Claude, ChatGPT, Gemini e outras IAs conseguem gerar texto. Esse não é mais o gargalo.

O gargalo real é manter padrão quando você publica várias vezes:

  • o artigo precisa responder rápido;
  • os H2s precisam bater com intenção de busca;
  • as fontes precisam ser rastreáveis;
  • a FAQ precisa aparecer no corpo;
  • o conteúdo precisa estar pronto para WordPress;
  • o SEO on-page precisa ser preenchido;
  • a capa precisa seguir identidade visual;
  • os links internos precisam fazer sentido;
  • o rascunho precisa ser revisado antes de publicar.

Sem processo, cada conversa começa do zero.

Com Skills, o processo vira parte do ambiente do Claude Code.

Se você ainda está começando, leia também: o que são Claude Skills e como criar uma Skill no Claude Code.

O que são Claude Code Skills?

Claude Code Skills são pastas com instruções reutilizáveis. Cada Skill normalmente tem um arquivo SKILL.md com frontmatter, descrição e um procedimento em Markdown.

Na prática, uma Skill ensina Claude a lidar com uma classe de tarefa.

Exemplo:

skills/
  blog-article/
    SKILL.md
  backlinks/
    SKILL.md
  cover-image/
    SKILL.md
    scripts/
      gerar_capa.py

O valor não está só no arquivo existir. O valor está em transformar conhecimento operacional em rotina.

Uma Skill boa diz:

  • quando deve ser usada;
  • quais inputs precisa coletar;
  • qual formato de saída é esperado;
  • quais erros evitar;
  • quais scripts pode rodar;
  • quais partes devem ser adaptadas pelo usuário.

No meu caso, as Skills foram criadas para conteúdo em português, WordPress, Rank Math, SEO e GEO.

Como o pipeline funciona no ViniEnsina

O fluxo editorial que eu uso pode ser resumido assim:

Etapa O que acontece Skill relacionada
Ideia Defino tópico, keyword, ângulo e intenção blog-article ou backlinks
Pesquisa Busco fontes, dados, SERP e links internos backlinks
Rascunho Claude gera HTML pronto para WordPress blog-article
SEO Focus keyword, title e meta description são definidos rankmath-seo
Capa Script gera JPG e sobe como featured image cover-image
Revisão Valido fontes, links, CTA, FAQ e indexabilidade humano + checklists
Diagrama do pipeline editorial: ideia, pesquisa, artigo, Rank Math, capa e QA
Diagrama do pipeline editorial: ideia, pesquisa, artigo, Rank Math, capa e QA

Esse pipeline reduz improviso.

Em vez de depender da memória da conversa, eu coloco o procedimento dentro da Skill. Quando preciso criar um artigo novo, Claude Code já sabe qual formato funciona melhor para aquele tipo de publicação.

Card visual com as quatro Skills publicadas: blog-article, backlinks, cover-image e rankmath-seo
Card visual com as quatro Skills publicadas: blog-article, backlinks, cover-image e rankmath-seo

A Skill blog-article

A Skill blog-article cria artigos completos para WordPress.

Ela orienta Claude a montar:

  • abertura direta;
  • definição nas primeiras palavras;
  • índice;
  • seções em H2;
  • FAQ;
  • CTA;
  • links internos;
  • saída em HTML pronta para o tema.

No ViniEnsina, alguns elementos são específicos do meu site, como classes .vi-*, shortcode

, slugs e a oferta do ebook.

No repositório, esses pedaços aparecem como pontos de personalização. A ideia não é você copiar meu tema. A ideia é você adaptar a lógica para o seu setup.

A Skill backlinks

A Skill backlinks é a mais importante para GEO.

Ela foi pensada para criar artigos que outros sites e IAs consigam citar com facilidade.

O padrão principal tem três blocos:

  1. Resposta rápida: uma tabela ou resumo que entrega os dados principais logo no começo.
  2. Como citar: uma seção que explica como referenciar o levantamento.
  3. FAQ visível: perguntas e respostas no corpo do artigo, com possibilidade de anexar schema depois.

Esse formato não garante backlink. Nada garante.

Mas ele reduz atrito para quem quer citar.

Se um redator, pesquisador, agência ou IA precisa de uma fonte rápida, o artigo já oferece:

  • dado;
  • contexto;
  • fonte original;
  • forma de citar;
  • URL clara;
  • atualização declarada.

Esse é o tipo de detalhe que muda o conteúdo de “post comum” para “ativo citável”.

A Skill cover-image

A Skill cover-image resolve um problema pequeno, mas recorrente: capa de post.

Ela usa um script Python para:

  • buscar imagem no Unsplash;
  • cortar no formato 1200×675;
  • aplicar overlay escuro;
  • inserir badge, título e branding;
  • salvar JPG;
  • subir para o WordPress;
  • definir como featured image.

As credenciais ficam em variáveis de ambiente:

WP_URL
WP_USER
WP_APP_PASSWORD
UNSPLASH_KEY

O script também aceita personalização:

COVER_BRAND
COVER_FONT_BOLD
COVER_FONT_REG

Isso mantém o código publicável sem expor senha, token ou configuração privada.

A Skill rankmath-seo

A Skill rankmath-seo preenche os campos do Rank Math via API nativa.

Ela ajuda a escolher:

  • focus keyword;
  • meta description;
  • title otimizado.

O ponto mais importante é não forçar keyword longa.

Muita gente perde nota no Rank Math porque tenta usar uma frase enorme como keyword exata. A Skill orienta a escolher termos de 2 a 4 palavras, que aparecem naturalmente no título, slug e corpo do artigo.

Resultados reais do case

Essas Skills fazem parte do sistema editorial que uso no ViniEnsina.

Na janela de 28 dias entre 29/06 e 26/07/2026, o site registrou:

Métrica Valor
Impressões no Google Search Console 20.715
Cliques orgânicos 249
Citações de IA / Copilot no Bing Webmaster 5.105
Artigo mais citado por IA /como-instalar-claude-code-windows/ com 2.021 citações
Segundo ativo de citação /estatisticas-afiliados-brasil-2026/ com 875 citações
Card visual com os resultados do case: 20.715 impressões, 249 cliques e 5.105 citações de IA
Card visual com os resultados do case: 20.715 impressões, 249 cliques e 5.105 citações de IA

Esses números não provam que uma única Skill causou todo o crescimento.

SEO nunca é tão limpo assim.

Eles mostram outra coisa: um processo editorial consistente, aplicado em artigos reais, pode gerar sinais de busca e visibilidade em respostas de IA.

O repositório é a parte aberta desse processo.

Como citar este projeto

Se você mencionar esse repositório em artigo, newsletter, lista curada ou material sobre Claude Code, pode citar assim:

ViniEnsina. “Claude Code SEO/GEO Skills PT-BR”. Repositório open source com Skills para produção de conteúdo, páginas citáveis, capas e Rank Math no WordPress. GitHub, 2026.

Link:

https://github.com/viniensina/claude-code-seo-geo-skills-pt-br

O que foi sanitizado

O repositório é público, mas não é um dump da operação inteira.

Eu removi ou substituí:

  • credenciais;
  • tokens;
  • App Password real;
  • e-mails pessoais;
  • caminhos locais;
  • automações privadas;
  • decisões futuras de cluster;
  • configs internas que não ajudam quem vai adaptar.

O que ficou:

  • estrutura das Skills;
  • lógica editorial;
  • exemplos de variáveis;
  • script de capa;
  • fluxo WordPress;
  • padrões de SEO/GEO;
  • pontos explícitos para trocar pelo seu setup.

Esse equilíbrio é importante.

Abrir método cria confiança. Expor operação inteira cria risco desnecessário.

Como adaptar para o seu site

Se você quiser usar o repo no seu projeto, o caminho básico é:

  1. Clonar o repositório.
  2. Copiar as Skills para ~/.claude/skills/ ou .claude/skills/.
  3. Criar um .env a partir de .env.example.
  4. Trocar domínio, branding, CTA e classes do tema.
  5. Revisar os snippets antes de rodar qualquer script.
  6. Testar primeiro com post rascunho.

O comando de instalação global fica assim:

cp -r skills/* ~/.claude/skills/

No Windows:

Copy-Item -Recurse skills\* $HOME\.claude\skills\

Depois, você pode pedir no Claude Code algo como:

“Cria um artigo de estatísticas sobre IA em vendas 2026 para atrair backlinks e citações de IA.”

Ou:

“Gera a capa do post ID 1923 com uma foto de dashboard de marketing.”

O que eu faria diferente se fosse começar hoje

Eu criaria menos Skills no começo.

Uma Skill boa precisa nascer de uma rotina real. Se você cria dez Skills antes de usar, provavelmente vai acabar com dez arquivos bonitos e pouco úteis.

Meu setup inicial seria:

Skill Por que começar por ela
briefing-conteudo Evita pauta fraca
revisar-artigo-seo Melhora qualidade antes de publicar
backlinks Cria ativos citáveis, não só posts
qa-publicacao Reduz erro em link, CTA, schema e indexação

Depois que o processo amadurece, você transforma etapas repetidas em Skills menores.

O que isso muda para SEO e GEO?

Para SEO tradicional, o ganho é consistência.

Você melhora:

  • intenção de busca;
  • estrutura;
  • links internos;
  • meta description;
  • publicação;
  • revisão.

Para GEO, o ganho é legibilidade para citação.

Você melhora:

  • resposta direta;
  • entidades claras;
  • dados rastreáveis;
  • FAQ;
  • blocos citáveis;
  • contexto de fonte.

O conteúdo deixa de ser apenas “um artigo sobre o tema” e passa a funcionar como uma referência.

Perguntas frequentes

Claude Code Skills substituem uma estratégia de SEO?

Não. Skills ajudam a padronizar tarefas e reduzir improviso. Estratégia ainda depende de escolha de tema, intenção de busca, autoridade, distribuição, links internos, qualidade das fontes e revisão humana.

Posso usar essas Skills em qualquer site WordPress?

Sim, mas você precisa adaptar. O repositório usa exemplos do ViniEnsina, como classes .vi-*, shortcode

, domínio e branding. Esses pontos estão sinalizados para troca.

O repositório tem credenciais ou senha?

Não. As credenciais ficam em variáveis de ambiente. O arquivo .env.example traz apenas placeholders, incluindo o formato esperado de Application Password do WordPress.

Preciso usar Rank Math?

Só para a Skill rankmath-seo. As outras podem ser adaptadas para outro plugin ou para preenchimento manual. O Rank Math entra porque tem API nativa para atualizar metadados.

Isso funciona para conteúdo em inglês?

Funciona como estrutura, mas as instruções foram escritas em PT-BR e pensadas para o contexto do ViniEnsina. Para inglês, eu adaptaria tom, exemplos, fontes, CTA e critérios de SERP.

Por que publicar isso no GitHub?

Porque GitHub é um lugar natural para documentação técnica, reuso e descoberta. Um repositório público também é mais fácil de citar em listas, newsletters, artigos e respostas de IA.

Conclusão

Claude Code Skills não são só uma forma de guardar prompts.

Quando bem usadas, elas viram uma camada de processo: ajudam Claude a repetir uma rotina com mais contexto, menos improviso e mais cuidado operacional.

Foi por isso que eu abri o repositório claude-code-seo-geo-skills-pt-br.

Ele não entrega minha operação inteira. Entrega a parte que pode ajudar outras pessoas: um modelo real, sanitizado e adaptável para criar conteúdo, páginas citáveis, capas e SEO on-page no WordPress com Claude Code.

Publicado em julho de 2026.

🔥 Ebook Recomendado

IA no Piloto Automático

Aprenda a usar IA + Meta Ads para automatizar seu marketing e vender todos os dias — mesmo sem equipe técnica.

R$19,90
acesso imediato · ebook completo
Quero Acesso Agora →
🔒 Garantia de 7 dias