NanoSkill
Enviar sua skill

Habilidade de Agente de Escrita de Blog com IA para Claude Code

porAgriciDaniel818estrelas no GitHubGitHub

Gere, otimize e audite conteúdo de blog em escala com esta habilidade de agente de escrita de blog com IA para Claude Code. Ela produz artigos duplamente otimizados para classificações do Google e plataformas de citação de IA, garantindo conteúdo de alta qualidade e amigável para SEO todas as vezes.

blogVerificação de segurança aprovada
Prévia do resultado

Demo completa

Veja um listículo real sobre as melhores ferramentas de PPT com IA criado por esta Habilidade de Agente.

Primeiros passos

Execute sua primeira tarefa

  1. blog-writing-step-1
    01

    Passo 1: Instalar

    Adicione a habilidade ao seu agente.

  2. blog-writing-step-2
    02

    Passo 2:Gerar Conteúdo

    Use um comando específico para gerar conteúdo de blog.

  3. blog-writing-step-03
    03

    Passo 3:Revisar e Editar

    Revise o conteúdo e edite no documento Word gerado.

Comando de instalação

$ npx skills add https://github.com/AgriciDaniel/claude-blog

Sobre

A Habilidade de Escrita de Blog e Otimização de SEO com IA para Claude Code, conhecida como claude-blog, é um conjunto abrangente projetado para automatizar e aprimorar seu fluxo de trabalho de criação de conteúdo. Esta habilidade poderosa escreve, otimiza e audita conteúdo de blog em escala, garantindo que cada artigo seja meticulosamente elaborado tanto para classificações de pesquisa do Google quanto para plataformas de citação de IA. É uma ferramenta indispensável para qualquer pessoa que deseje produzir conteúdo de alta qualidade e amigável para SEO de forma consistente e eficiente.

Distinguindo-se pelo seu robusto Contrato de Entrega de 5 portões, o claude-blog garante a qualidade do conteúdo pontuando cada rascunho em relação a uma rubrica de 100 pontos e bloqueando qualquer coisa abaixo de 90. Ele oferece otimização dupla, visando a conformidade com a Atualização Principal de Dezembro de 2025 e os sinais E-E-A-T para o Google, enquanto também prepara conteúdo para plataformas de citação de IA como ChatGPT e Perplexity. Com 30 sub-habilidades, 5 agentes e 12 modelos de conteúdo, ele lida com todo o ciclo de vida do conteúdo, desde pesquisa e esboço até geração de esquema e verificação de citações.

Seja você um blogueiro solo buscando uma postagem semanal de alta qualidade, uma equipe de marketing gerenciando portfólios de conteúdo diversificados ou um construtor de habilidades do Claude Code em busca de uma referência de nível de produção, o claude-blog oferece soluções personalizadas. Ele suporta planejamento de cluster de tópicos, publicação multilíngue, perfis de voz orientados por persona e inclui recursos avançados como detecção de canibalização de palavras-chave e um pipeline de verificação de fatos para garantir precisão e evitar conflitos de conteúdo.

Recursos-chave

O que a torna poderosa

  • Contrato de Entrega de 5 Portões

    Todo rascunho passa por um rigoroso contrato de entrega de 5 portões (Capacidade, Formato, Visual, Revisão de Conteúdo, Integridade de Ativos) com uma rubrica de 100 pontos, bloqueando qualquer coisa abaixo de 90 de chegar até você.

  • Otimização Dupla para SEO e Citações de IA

    Cada artigo é otimizado para classificações do Google (Atualização Principal de Dezembro de 2025, E-E-A-T) e plataformas de citação de IA (ChatGPT, Perplexity, AI Overviews), maximizando visibilidade e citabilidade.

  • Geração Abrangente de Conteúdo

    Um mecanismo de blog de ciclo de vida completo com 30 sub-habilidades, 5 agentes e 12 modelos de conteúdo, cobrindo pesquisa, esboço, rascunho, schema, links internos e verificação de citações em uma única invocação.

  • Escrita Orientada por Persona e Verificação de Fatos

    Gerencie personas de escrita configuráveis com estruturas de tom e faixas de legibilidade, juntamente com um pipeline de verificação de fatos que verifica estatísticas em relação a fontes citadas para garantir precisão.

  • Detecção de Canibalização de Palavras-chave

    Identifique e resolva a sobreposição de palavras-chave em postagens de blog com pontuação de gravidade e recomendações para evitar que o conteúdo concorra consigo mesmo nos SERPs.

Casos de uso

Quando usar

  • Gerar Postagens de Blog de Alta Qualidade

    Blogueiros solo e criadores podem publicar uma postagem de alta qualidade por semana sem listas de verificação de SEO manuais, lidando com pesquisa, esboço, rascunho, schema, links internos e verificação de citações.

  • Gerenciar Conteúdo em Escala para Equipes

    Equipes de marketing e agências podem gerenciar muitas postagens em tópicos e idiomas com recursos como planejamento de cluster de tópicos, publicação multilíngue e perfis de voz orientados por persona.

  • Auditar e Otimizar Conteúdo Existente

    Use a habilidade para analisar postagens de blog existentes com uma pontuação de qualidade de 0 a 100, realizar validação de SEO pós-escrita e detectar canibalização de palavras-chave em todo o seu site.

SKILL.md

Habilidade de Escrita de Blog com IA e Otimização de SEO para Claude Code (claude-blog)

Duas versões desta habilidade. Escolha a que se adapta à sua forma de trabalhar:

  • 🌐 Código aberto público: AgriciDaniel/claude-blog. Licenciado sob MIT, lançamentos públicos, aberto a todos. Use esta se quiser a versão estável, para download, sem necessidade de associação.
  • 🔒 Espelho privado da comunidade (este repositório): AI-Marketing-Hub/claude-blog. Acesso antecipado a trabalhos em desenvolvimento (Contrato de Entrega de Blog v1.9.0+, escada de herói, cobertura de regressão testada por mutação) e colaboração direta com a comunidade AI Marketing Hub Pro. Requer associação.

Os emblemas acima rastreiam o repositório público (AgriciDaniel/claude-blog), já que o espelho privado não é visível para shields.io. O fluxo de trabalho de publicação (desenvolvimento privado, revisão, lançamento público) está documentado em docs/PUBLISHING.md.

Blog: Veja como o claude-blog funciona

claude-blog é um conjunto de habilidades do Claude Code que escreve, otimiza e audita conteúdo de blog em escala. Cada artigo é duplamente otimizado para classificações do Google (Atualização Principal de Dezembro de 2025, E-E-A-T) e plataformas de citação de IA (ChatGPT, Perplexity, AI Overviews). Um Contrato de Entrega de 5 portões v1.9.0 avalia cada rascunho contra uma rubrica de 100 pontos e bloqueia qualquer coisa abaixo de 90 de chegar até você.

Principais conclusões

  • O que é: um mecanismo de blog de ciclo de vida completo: 30 sub-habilidades, 5 agentes, 12 modelos de conteúdo, 21 referências sob demanda, 9 scripts Python no nível raiz, 160 testes aprovados.
  • Para quem é: blogueiros solitários, equipes de marketing, agências e construtores de habilidades do Claude Code que desejam saída de conteúdo de nível de produção, não rascunhos únicos.
  • Promessa central: cada rascunho passa por um contrato de entrega de 5 portões (Capacidade, Formato, Visual, Revisão de Conteúdo, Integridade de Ativos) ou o redator itera até 3 vezes antes de escalar para você.
  • O que o torna diferente: ele come sua própria comida de cachorro. A coerência de versão é imposta por CI em 14 superfícies, a higiene da prosa é executada em cada PR, três suítes de regressão testadas por mutação bloqueiam as correções v1.9.0 e o blog-reviewer é um portão BLOQUEANTE, não consultivo.
  • Hoje: v1.9.0, lançado em 18/05/2026. Funciona em Next.js MDX, Astro, Hugo, Jekyll, WordPress, Ghost, 11ty, Gatsby e HTML estático.

Para quem é o claude-blog?

O claude-blog atende três públicos com um único mecanismo:

Blogueiros e criadores individuais que querem publicar um post de alta qualidade por semana sem gastar três horas na lista de verificação de SEO. O orquestrador lida com pesquisa, esboço, rascunho, esquema, vinculação interna e verificação de citações em uma única invocação /blog write.

Equipes de marketing e agências gerenciando muitos posts em diversos tópicos, idiomas e plataformas. A habilidade oferece planejamento de cluster de tópicos (/blog cluster), publicação multilíngue com um comando (/blog multilingual), detecção de canibalização (/blog cannibalization) e perfis de voz orientados por persona (/blog persona) para que o mesmo mecanismo produza conteúdo consistente em toda a equipe.

Construtores de habilidades do Claude Code que desejam uma referência de nível de produção para arquitetura de habilidades, despacho de agentes, contratos de entrega e bloqueios de CI. O repositório demonstra o padrão aberto de Habilidades de Agente em complexidade Nível 4 com 160 testes, imposição de coerência de versão, testes de regressão de sincronização do instalador e o padrão de contrato de 5 portões v1.9.0. Leia o código-fonte para inspiração; bifurque os padrões em suas próprias habilidades.

O que o claude-blog produz?

Cada rascunho é entregue como 8 artefatos em uma única pasta. Um espécime condensado da saída .md:

---
title: "Onde um Plugin de Habilidade do Claude Code Deve se Instalar?"
description: "Uma resposta prática para a questão do caminho de instalação..."
date: "2026-05-18"
author: "Daniel Agrici"
tags: [claude-code, habilidades, plugins, instalação]
canonical: "https://example.com/blog/skill-plugin-install-path"
---

# Onde um Plugin de Habilidade do Claude Code Deve se Instalar?

A resposta curta: a maioria dos plugins de habilidade do Claude Code instaláveis pelo usuário deve
ser enviada para `~/.claude/skills/<nome>/` para o conteúdo da habilidade,
`~/.claude/agents/<nome>.md` para agentes e
`~/.claude/scripts/<auxiliar>.py` para quaisquer auxiliares Python.

## Principais Conclusões
- `~/.claude/skills/` é a área de superfície do SKILL.md.
- `~/.claude/agents/` contém arquivos markdown de agente.
- ... (artigo completo, citações com fontes, FAQ, esquema JSON-LD)

Junto com o .md, o contrato também produz: .html renderizado (JSON-LD seguro contra XSS, CSS com suporte a modo escuro), .pdf (Playwright ou weasyprint), hero.<ext> (1200x630, gerado via Banana MCP, Gemini, APIs de banco de imagens ou Openverse), 3 capturas de tela em viewports (mobile-375.png, tablet-768.png, desktop-1280.png), review.md (cartão de pontuação de 5 categorias com linha BLOQUEANTE) e preflight-report.json (a trilha de auditoria completa).

Índice

  • Demonstração
  • Início Rápido
  • Comandos
  • Como o claude-blog se compara?
  • Recursos
  • Contrato de entrega (v1.9.0)
  • Arquitetura
  • Requisitos
  • Perguntas Frequentes
  • Roteiro
  • Desinstalação
  • Integração
  • Documentação
  • Como citar
  • Segurança e Código de Conduta
  • Contribuindo
  • Licença
  • Projetos relacionados
  • Autor

Demonstração

Assista à Demonstração no YouTube

<p align="center"> <img src="https://file.nanoskill.ai/blog-command-demo-10.gif" alt="demonstração do comando claude-blog: roteamento de subcomandos /blog através do orquestrador" width="100%"> </p>

Início Rápido

ℹ️ Qual versão você está instalando?

  • Não é membro do AI Marketing Hub Pro? Instale a partir do repositório público: AgriciDaniel/claude-blog. Todos os comandos de instalação abaixo funcionam lá. Apenas troque AI-Marketing-Hub/claude-blog por AgriciDaniel/claude-blog e o slug do plugin claude-blog@ai-marketing-hub-claude-blog por claude-blog@agricidaniel-claude-blog. Os lançamentos públicos são enviados para lá; este espelho privado está à frente.
  • Membro Pro? Os comandos abaixo instalam a versão da comunidade com acesso antecipado a recursos em desenvolvimento. Eles exigem uma sessão autenticada gh auth login (ou GitHub PAT) com acesso à organização AI-Marketing-Hub. Se /plugin marketplace add falhar com um 404, sua conta ainda não está na organização. Envie uma mensagem direta na comunidade Skool para ser adicionado.

Instalação via Plugin (Claude Code 1.0.33+):

# Adicionar marketplace (única vez)
/plugin marketplace add AI-Marketing-Hub/claude-blog

# Instalar plugin
/plugin install claude-blog@ai-marketing-hub-claude-blog

Recomendado: clonar, verificar e depois instalar (permite inspecionar install.sh e fixar uma tag de lançamento):

git clone https://github.com/AI-Marketing-Hub/claude-blog.git
cd claude-blog
git checkout v1.9.0          # fixar em uma tag de lançamento (mais recente em 18/05/2026)
chmod +x install.sh && ./install.sh

Instalação com Um Comando (Unix/macOS):

curl -fsSL https://raw.githubusercontent.com/AI-Marketing-Hub/claude-blog/main/install.sh | bash

Instalação com Um Comando (Windows PowerShell):

irm https://raw.githubusercontent.com/AI-Marketing-Hub/claude-blog/main/install.ps1 | iex

Passar curl ou irm diretamente para o shell dá ao script autoridade de execução na sua máquina. O fluxo de clonar e depois fazer checkout da tag é mais seguro, pois você pode inspecionar o que é executado. Ambos os fluxos se autenticam no repositório privado usando suas credenciais gh auth / GitHub existentes.

Verificar integridade do instalador (recomendado, proteção VULN-IAC-001):

# Baixar, verificar SHA-256 e executar se o hash corresponder.
curl -fsSL -o install.sh https://raw.githubusercontent.com/AI-Marketing-Hub/claude-blog/main/install.sh
echo "029388e448dd29bed259b130c2be42e2f6a16d4d5b6801a61bfb4f49b621fc04  install.sh" | sha256sum -c
bash install.sh

O SHA-256 acima é para o install.sh atual no HEAD do main. Verifique contra o arquivo canônico antes de executar. O hash complementar do install.ps1 é 6d03f353e5d844c4fe5c7c0b2500bd1e2aad02468cd544013bab876735cebf98. Os hashes são atualizados neste README a cada alteração do instalador.

Reinicie o Claude Code após a instalação para ativar.

Comandos

🚀 Primeira vez? Experimente estes três comandos primeiro: /blog strategy <nicho> para definir o escopo do seu blog, /blog write <tópico> para gerar seu primeiro artigo (o contrato de 5 portões é executado automaticamente) e /blog analyze <arquivo> para pontuá-lo na rubrica de 100 pontos.

<p align="center"> <img src="https://file.nanoskill.ai/blog-write-demo-12.gif" alt="demonstração do /blog write do claude-blog: geração de artigo ponta a ponta com o Contrato de Entrega de 5 portões" width="100%"> </p> <p align="center"> <img src="https://file.nanoskill.ai/03-sub-skill-map-B-17.svg" alt="ecossistema de sub-habilidades do claude-blog: hub do orquestrador no centro com 30 sub-habilidades organizadas em 8 clusters temáticos (escrita, estratégia, qualidade, IA e busca, multilíngue, pesquisa, mídia, distribuição); os tamanhos dos painéis se ajustam automaticamente às contagens de habilidades" width="100%"> </p>
ComandoDescrição
/blog write <tópico>Escrever um novo post de blog do zero
/blog rewrite <arquivo>Otimizar um post de blog existente
/blog analyze <arquivo>Auditoria de qualidade com pontuação de 0 a 100
/blog brief <tópico>Gerar um briefing de conteúdo detalhado
/blog calendarGerar um calendário editorial
/blog strategy <nicho>Estratégia de blog e ideação de tópicos
/blog outline <tópico>Esboço de conteúdo informado pela SERP
/blog seo-check <arquivo>Validação de SEO pós-escrita
/blog schema <arquivo>Gerar marcação de esquema JSON-LD
/blog repurpose <arquivo>Reaproveitar para redes sociais, e-mail, YouTube
/blog geo <arquivo>Auditoria de prontidão para citação de IA
/blog image [generate|edit|setup]Geração de imagem por IA via Gemini
/blog audit [diretório]Avaliação de saúde completa do blog no site
/blog cannibalization [diretório]Detectar sobreposição de palavras-chave entre posts
/blog factcheck <arquivo>Verificar estatísticas contra as fontes citadas
/blog persona [create|list|apply]Gerenciar personas de escrita e perfis de voz
/blog taxonomy [sync|audit|suggest]Gerenciamento de tags/categorias no CMS
/blog notebooklm <pergunta>Consultar o NotebookLM para pesquisa baseada em fontes
/blog audio [generate|voices|setup]Gerar narração em áudio via Gemini TTS
/blog google [comando] [args]Dados da API do Google: PSI, CrUX, GSC, GA4, NLP, YouTube, Palavras-chave
/blog cluster [plan|execute] <semente>Planejamento e execução de cluster de tópicos semânticos (hub-and-spoke)
/blog multilingual <tópico> --languages <códigos>Escrever, traduzir, localizar e emitir hreflang em um único comando
/blog translate <arquivo> --to <códigos>Tradução otimizada para SEO com preservação de formato
/blog localize <arquivo> --locale <código>Adaptação cultural profunda por localidade
/blog locale-audit <diretório>QA de conteúdo multilíngue (completude, hreflang, paridade, atualização)
/blog flow [find|optimize|win|prompts|sync]Prompts do framework FLOW (orientado por evidências, 30 aplicáveis a blog)
/blog brand [init|show|update]Gerar contexto BRAND.md + VOICE.md carregado automaticamente por todas as sub-habilidades
/blog discourse <tópico>Pesquisa de discurso dos últimos 30 dias sem API; produz DISCOURSE.md

Total de 30 diretórios de sub-habilidades: 29 invocáveis pelo usuário (28 comandos slash distintos + /blog update com alias para rewrite) + 1 somente interno (blog-chart, invocado por blog-write/blog-rewrite para gráficos SVG inline). blog-image é invocável pelo usuário E pode ser chamado internamente.

Como o claude-blog se compara?

O claude-blog é um pipeline estruturado. O prompting direto em LLM é algo único. As ferramentas SaaS hospedadas são de código fechado. Aqui está a matriz honesta de compensações:

Capacidadeclaude-blogPrompt direto no Claude / ChatGPTCopy.ai / JasperConstruir você mesmo
Artigo completo em um comando, com loop de iteração✅ (contrato de 5 portões, até 3 tentativas)⚠️ único
Estatísticas com fontes verificadas/blog factcheck busca URLs das fontes❌ alucina⚠️ manual
Otimização para citação de IA (GEO / AEO)✅ auditoria dedicada /blog geo⚠️
Revisão de conteúdo bloqueante (pontuação >= 90 para entregar)✅ agente blog-reviewer
Multilíngue + hreflang em um comando/blog multilingual⚠️ sem hreflang⚠️
Planejamento de cluster de tópicos (hub-and-spoke)/blog cluster⚠️
Narração em áudio✅ Gemini TTS, 30 vozes
Geração de imagem de herói (escada de 4 etapas)✅ Banana, Gemini, banco de imagens, Openverse⚠️ apenas banco de imagens⚠️
Contexto persistente de marca e voz✅ BRAND.md + VOICE.md carregados automaticamente❌ por prompt⚠️ limitado
Código aberto, MIT, sem custo de uso✅ gratuito❌ assinatura❌ assinatura

O claude-blog não é melhor em tudo. O prompting direto é mais rápido para um único rascunho descartável. SaaS hospedado é mais fácil para não desenvolvedores. DIY é mais flexível para pipelines únicos. O claude-blog se encaixa onde você quer conteúdo de nível de produção em escala sem uma assinatura de SaaS.

Recursos

12 modelos de conteúdo

Selecionados automaticamente por tópico e intenção: guia prático, listicle, estudo de caso, comparação, página pilar, revisão de produto, liderança de pensamento, roundup, tutorial, análise de notícias, pesquisa de dados, base de conhecimento FAQ.

Pontuação de qualidade em 5 categorias (100 pontos)

CategoriaPontosFoco
Qualidade do Conteúdo30Profundidade, legibilidade, originalidade, engajamento
Otimização de SEO25Cabeçalhos, título, palavras-chave, links, meta
Sinais E-E-A-T15Autor, citações, confiança, experiência
Elementos Técnicos15Esquema, imagens, velocidade, dispositivos móveis, tags OG
Prontidão para Citação de IA15Citabilidade, formato de perguntas e respostas, clareza de entidade

Faixas de pontuação: Excepcional (90-100), Forte (80-89), Aceitável (70-79), Abaixo do Padrão (60-69), Reescrever (<60). O contrato v1.9.0 bloqueia a entrega abaixo de 90.

Detecção de conteúdo de IA

Pontuação de burstiness na variância do comprimento das frases, detecção de frases conhecidas de IA (17 frases) e diversidade de vocabulário (TTR). Sinaliza conteúdo que parece gerado por máquina antes de chegar ao revisor.

Escrita orientada por persona

Personas de escrita configuráveis com o framework de tom de 4 dimensões do NNGroup (formal/casual, sério/engraçado, respeitoso/irreverente, direto/entusiasmado). Gerencie perfis de voz por blog ou autor, com faixas de legibilidade (Consumidor, Profissional, Técnico) e imposição de estilo no momento do rascunho.

Pipeline de verificação de fatos

/blog factcheck busca cada URL de fonte citada e pontua a confiança da afirmação como correspondência exata, paráfrase ou não encontrada. Garante que cada ponto de dado seja preciso e rastreável, não inventado.

Detecção de canibalização de palavras-chave

/blog cannibalization identifica sobreposição de palavras-chave entre posts do blog usando análise local com grep ou a API DataForSEO. Pontuação de gravidade com recomendações de mesclar ou diferenciar evita que os posts compitam entre si nas SERPs.

Gerenciamento de taxonomia no CMS

Sincronização de tags e categorias com suporte a WordPress REST, Shopify GraphQL, Ghost, Strapi e Sanity. Inclui fluxos de trabalho de sugestão, sincronização e auditoria de tags.

Otimização dupla

Cada artigo visa tanto as classificações do Google quanto as plataformas de citação de IA:

  • Google: conformidade com a Atualização Principal de Dezembro de 2025, sinais E-E-A-T, marcação de esquema, vinculação interna, consciência do Core Web Vitals via blog-google.
  • Citações de IA: formatação com resposta em primeiro lugar, cápsulas de citação, citabilidade em nível de passagem (blocos de 120-180 palavras), esquema FAQ, clareza de entidade.

Mídia visual

  • Obtenção de imagens do Pixabay, Unsplash e Pexels com verificação HTTP 200 e geração automática de texto alternativo.
  • Geração de imagens por IA via Gemini para imagens de herói, ilustrações inline e cartões sociais. Requer uma chave gratuita da API Google AI.
  • Geração integrada de gráficos SVG em 7 estilos (barra, barra agrupada, pirulito, rosca, linha, área, radar).
  • Incorporação de vídeos do YouTube com carregamento lento srcdoc e fallback noscript para rastreadores de IA.
  • Metas de densidade de imagem calibradas por tipo de conteúdo.

Integração com a API do Google (v1.6.5+)

13 comandos em 4 níveis de credenciais, todos gratuitos em uso normal:

  • Nível 0 (chave API): PageSpeed Insights, CrUX Core Web Vitals (histórico de 25 semanas), pesquisa de vídeos do YouTube, análise de entidade NLP.
  • Nível 1 (OAuth): desempenho do Search Console, Inspeção de URL, API de Indexação.
  • Nível 2 (GA4): relatórios de tráfego orgânico.
  • Nível 3 (Ads): Planejador de Palavras-chave do Google Ads.

Pesquisa no NotebookLM

Consulte o Google NotebookLM para pesquisa baseada em fontes a partir de documentos enviados pelo usuário. Qualidade de dados Nível 1 com risco zero de alucinação, pois as respostas são extraídas dos documentos que você enviou.

Narração em áudio

/blog audio gera narração em áudio via Gemini TTS. Três modos: resumo (200-300 palavras), artigo completo, diálogo entre dois locutores. 30 vozes, mais de 80 idiomas.

Suporte a plataformas

Next.js MDX, Astro, Hugo, Jekyll, WordPress, Ghost, 11ty, Gatsby e HTML estático.

Metodologias fundamentais (v1.8.0)

Cinco documentos de referência em skills/blog/references/ definem a metodologia editorial e de pesquisa aplicada em todas as sub-habilidades. Eles são carregados sob demanda pelo orquestrador:

ReferênciaPropósitoUsado por
ai-slop-detection.mdDetecção de conteúdo de IA em duas camadas: primeira ordem (frases) + segunda ordem (ritmo estrutural)blog-rewrite, blog-reviewer, blog-analyze
editorial-heuristics.md10 heurísticas adaptadas de Nielsen com pontuação 0-4 + marcação de gravidade P0-P3blog-analyze --rubric
cognitive-load.mdDensidade conceitual por seção (entidades, números, jargão, referências futuras, profundidade de cláusulas)blog-analyze --cognitive-load, scripts/cognitive_load.py
research-quality.mdRubrica de pesquisa em 5 dimensões + 4 classes de armadilha de palavras-chave pré-voo + limites mínimos de atualizaçãoblog-researcher, blog-discourse, blog-brief, blog-strategy
synthesis-contract.md6 LEIS que regem a síntese de pesquisa (sem bloco de Fontes final, citações inline, etc.)Todas as sub-habilidades de síntese de pesquisa

Adaptado de pbakaus/impeccable (Apache 2.0) e mvanhorn/last30days-skill (MIT). Veja CONTRIBUTORS.md para atribuição.

Framework FLOW

O framework FLOW (Find, Leverage, Optimize, Win) é o fluxo de trabalho orientado por evidências compartilhado com AgriciDaniel/flow (CC BY 4.0). Cada fase contribui com prompts para o pipeline do orquestrador; /blog flow expõe 30 prompts prontos para execução, indexados por fase.

<p align="center"> <img src="https://file.nanoskill.ai/04-framework-B-19.svg" alt="roda radial do framework FLOW: quatro fases (Find para descoberta de tópicos, Leverage para amplificação de ativos, Optimize para melhoria de conteúdo, Win para conversão de leitores) dispostas em torno de um hub central, com 10 prompts representativos no anel externo" width="100%"> </p>

Contrato de entrega (v1.9.0)

<p align="center"> <img src="https://file.nanoskill.ai/02-pipeline-A-20.svg" alt="pipeline do Contrato de Entrega de Blog de 5 portões: Descoberta de Capacidade, Completude de Formato, Verificação Visual, Revisão de Conteúdo (portão BLOQUEANTE, pontuação deve ser 90 ou superior com zero problemas P0) e Integridade de Ativos e Links. Itera até 3 vezes em caso de falha antes de escalar para o usuário" width="100%"> </p>

Todo blog passa por um contrato de 5 portões antes de ser mostrado ao usuário. O usuário nunca é o primeiro revisor; os portões são.

PortãoAplicaImplementação
1. Descoberta de CapacidadeFerramentas e agentes necessários presentes antes da escritascripts/blog_preflight.py --gate 1
2. Completude de Formato.md + .html + .pdf + imagem de herói realscripts/blog_render.py, scripts/generate_hero.py
3. Verificação VisualSem overflow de SVG, JSON-LD válido, modo escuro renderizado corretamentepatchright / playwright em 3 larguras de viewport
4. Revisão de Conteúdo (BLOQUEANTE)blog-reviewer pontuação 90+ E zero problemas P0agents/blog-reviewer.md (bloqueante, v1.9.0)
5. Integridade de Ativos e LinksCada img resolve, og:image existe, links retornam 200, wordCount dentro de 5%scripts/blog_preflight.py --gate 5

Escada de imagem de herói: Banana MCP, API direta do Gemini, banco de imagens premium (Unsplash, Pexels, Pixabay), API pública Openverse. O primeiro disponível ganha. Bloqueia e itera até 3 vezes em qualquer falha de portão antes de escalar para o usuário. Especificação completa: skills/blog/references/blog-delivery-contract.md.

Arquitetura

<p align="center"> <img src="https://file.nanoskill.ai/01-architecture-B-19.svg" alt="arquitetura do sistema claude-blog: pipeline da esquerda para a direita, do comando do usuário passando pelo roteamento do orquestrador, execução de sub-habilidades e despacho de agentes até o contrato de entrega de 5 portões antes de chegar ao usuário" width="100%"> </p>

O claude-blog é distribuído como um orquestrador mais 29 sub-habilidades, 5 agentes, 21 referências, 12 modelos e 9 scripts no nível raiz. O orquestrador roteia comandos do usuário para sub-habilidades, que geram agentes e chamam scripts via Bash.

CamadaQuantidadeLocalização
Sub-habilidades (invocáveis pelo usuário)29skills/blog-*/SKILL.md
Sub-habilidades (internas)1skills/blog-chart/SKILL.md
Agentes especializados5agents/blog-*.md
Referências sob demanda21skills/blog/references/*.md
Modelos de conteúdo12skills/blog/templates/*.md
Scripts Python no nível raiz9scripts/*.py
Testes160tests/test_*.py

Árvore de diretórios completa, diagramas de fluxo de dados, metodologia de pontuação e pontos de extensão: docs/ARCHITECTURE.md.

Requisitos

  • Claude Code CLI instalado e configurado.
  • Python 3.11+ (para pontuação de qualidade, execução do contrato de entrega de 5 portões e lint).
  • Opcional: pip install -r requirements.txt para análise avançada (pontuação de legibilidade, detecção de esquema).

Portões de qualidade (impostos por CI em cada PR)

  1. pytest: 160 testes abrangendo suítes de segurança, comportamental, regressão e contrato de entrega.
  2. Validação de plugin: claude plugin validate . mais verificações manuais de JSON/regex.
  3. Lint de caminhos obsoletos: detecta desvios em referências cruzadas de references/ e templates/.
  4. Higiene de prosa: scripts/lint_prose.py (ciente de cercas, ciente de backticks) impõe a regra do CONTRIBUTING.md de não usar travessão, não usar meia-risca, não usar --.
  5. Coerência de versão: tests/test_version_coherence.py afirma que pyproject.toml, plugin.json, CITATION.cff e o frontmatter de skills/blog/SKILL.md correspondem.
  6. Coerência de comandos: tests/test_command_coherence.py afirma que skills/blog/SKILL.md e docs/COMMANDS.md declaram o mesmo conjunto de comandos.

Execute localmente antes de enviar:

python -m pytest tests/
python3 scripts/lint_prose.py
claude plugin validate .

Perguntas Frequentes

O que é o claude-blog?

O claude-blog é um conjunto de habilidades do Claude Code para escrever, otimizar e auditar conteúdo de blog. Ele executa 30 sub-habilidades e 5 agentes por meio de um contrato de entrega de 5 portões para que cada artigo atinja uma barra de qualidade de 90/100 antes de chegar até você.

Como o claude-blog é diferente de perguntar diretamente ao Claude ou ChatGPT?

O prompting direto lhe dá um rascunho a partir de um prompt. O claude-blog lhe dá um pipeline estruturado: pesquisa com estatísticas com fontes, aprovação de esboço, geração de rascunho, pontuação de qualidade em várias passagens, detecção de conteúdo de IA, verificação de fatos, injeção de esquema e uma revisão bloqueante que itera até 3 vezes antes da entrega. A habilidade impõe o que um editor sênior faria manualmente.

Preciso de uma assinatura AI Marketing Hub Pro para usar o claude-blog?

Não. A versão pública de código aberto em AgriciDaniel/claude-blog é licenciada sob MIT e gratuita para qualquer pessoa com Claude Code. O espelho privado em AI-Marketing-Hub/claude-blog é para membros Pro que desejam acesso antecipado a recursos em desenvolvimento e colaboração direta com a comunidade.

Quais plataformas de blog o claude-blog suporta?

Next.js MDX, Astro, Hugo, Jekyll, WordPress, Ghost, 11ty, Gatsby e HTML estático. O orquestrador detecta automaticamente a plataforma a partir de sinais do projeto e ajusta o frontmatter, a incorporação de imagens e a injeção de esquema de acordo.

O claude-blog alucina estatísticas?

Não. Cada estatística citada passa pelo /blog factcheck, que busca a URL da fonte e pontua a confiança da afirmação (correspondência exata, paráfrase, não encontrada). O agente blog-reviewer bloqueia a publicação se uma citação não puder ser verificada ou se a detecção de conteúdo de IA sinalizar a prosa como gerada por máquina.

O que é o Contrato de Entrega de Blog de 5 portões?

Um pipeline de pré-apresentação imposto por código que é executado em cada rascunho: Descoberta de Capacidade, Completude de Formato, Verificação Visual em 3 larguras de viewport, Revisão de Conteúdo (BLOQUEANTE; pontuação 90+ e zero P0) e Integridade de Ativos e Links. O orquestrador itera o redator até 3 vezes em qualquer falha de portão antes de escalar para você. Especificação completa em skills/blog/references/blog-delivery-contract.md.

Posso usar o claude-blog em vários idiomas?

Sim. /blog multilingual <tópico> --languages en,de,fr,es,ja escreve o post, traduz preservando frontmatter e esquema, executa adaptação cultural profunda por localidade e emite tags hreflang mais um mapa de idiomas pronto para CMS em um único comando.

Como citar o claude-blog em trabalhos acadêmicos?

Veja a seção Como citar abaixo ou o arquivo CITATION.cff na raiz do repositório. O GitHub exibe o arquivo de citação estruturada através do botão "Cite this repository" na página do espelho público.

O claude-blog é seguro para instalar?

O instalador contém apenas scripts Python e arquivos markdown, nunca executa código remoto além do que o pip install -r requirements.txt traz, e é revisado de acordo com a política SECURITY.md do projeto a cada alteração. O fluxo de instalação clonar-depois-checkout-tag permite inspecionar install.sh antes de executá-lo. Veja SECURITY.md para o modelo de ameaça completo.

Roteiro

<p align="center"> <img src="https://file.nanoskill.ai/05-roadmap-A-18.svg" alt="roteiro em ondas do claude-blog em uma linha do tempo horizontal: v1.6.0 fundação (Mar 2026), v1.7.0 framework FLOW (Abr 2026), v1.8.0 metodologia impeccable (Mai 2026), v1.9.0 contrato de entrega (atual, Mai 2026), v2.0.0 publicação multi-CMS (Q3 2026), v3.0.0 blog-como-código (Q1 2027)" width="100%"> </p>

v1.9.1 (próxima)

  • Função _count_body_words(html) compartilhada entre blog_render e blog_preflight para fechar o residual de auditoria v1.9.0.
  • Semântica de código de saída do generate_hero.py: não zero em nenhum caminho de geração de imagem (atualmente retorna erro JSON com saída 0).
  • Teste de cobertura do loop de iteração verificando que o orquestrador escala após 3 BLOQUEIOS do revisor, não 4.
  • Varrer documentos restantes (CONTRIBUTORS, NOTICE, SECURITY, PRIVACY, TEMPLATES, TROUBLESHOOTING, MCP-INTEGRATION, DEMO) em busca de qualquer desvio residual de estrato v1.x.

v1.10 (visão)

  • Refinamento de esboço informado pela SERP em tempo real via DataForSEO durante a escrita.
  • Arnês de avaliação medindo a qualidade do blog em diferentes configurações (presença de BRAND.md, variante de persona, modo multilíngue).
  • Contador de iteração imposto por código (atualmente instrução do orquestrador; promover para nível de script).

v2.0 (longo prazo)

  • Integração com servidor de visualização headless: o contrato de 5 portões é executado contra uma visualização de domínio real em vez de HTML local.
  • Conectores de publicação por plataforma CMS (WordPress, Ghost, Sanity) com republicação idempotente na reescrita.
  • Painel de rastreamento de citações de IA em tempo real (quais posts são citados pelo ChatGPT, Perplexity, AI Overviews; mapa de calor de visibilidade).

Abra uma issue com o rótulo roadmap se quiser propor ou votar em algo.

Desinstalação

Unix/macOS:

chmod +x uninstall.sh && ./uninstall.sh

Windows (PowerShell):

.\uninstall.ps1

Integração

A geração de gráficos e a incorporação de vídeos do YouTube são integradas. Os dados da API do Google exigem uma chave de API gratuita (veja /blog google setup).

Habilidades complementares opcionais (análise mais aprofundada de páginas publicadas):

HabilidadeIntegração
/seoAnálise profunda de SEO de páginas de blog publicadas
/seo-schemaValidação e geração de marcação de esquema
/seo-geoAuditoria de otimização para citação de IA
/seo-googleDados da API do Google (configuração compartilhada com blog-google)

Documentação

A documentação detalhada está em docs/:

  • Guia de Instalação: Unix, macOS, Windows, instalação manual.
  • Referência de Comandos: Referência completa de comandos com exemplos.
  • Arquitetura: Design do sistema e visão geral dos componentes.
  • Fluxo de Trabalho de Publicação: Fluxo de lançamento privado-para-público (mantenedores Pro).
  • Modelos: Referência de modelos e personalização.
  • Solução de Problemas: Problemas comuns e correções.
  • Integração MCP: Configuração opcional do servidor MCP.

Como citar

Se você usar o claude-blog em pesquisa ou produção, por favor cite o projeto:

@software{Agrici_claude_blog_2026,
  author       = {Agrici, Daniel},
  title        = {claude-blog: Habilidade de Escrita de Blog com IA e Otimização de SEO para Claude Code},
  year         = {2026},
  url          = {https://github.com/AgriciDaniel/claude-blog},
  version      = {1.9.0},
  license      = {MIT}
}

O GitHub também exibe o arquivo estruturado CITATION.cff através de "Cite this repository" na página do espelho público.

Segurança e Código de Conduta

  • Política de segurança + modelo de ameaça: SECURITY.md. A rodada de proteção v1.8.x fechou todas as descobertas conhecidas; v1.9.0 adiciona JSON-LD seguro contra XSS, recusa de link simbólico O_NOFOLLOW e validação de frontmatter, tudo verificado por teste de mutação. Para relatar uma vulnerabilidade em particular, siga o procedimento de divulgação em SECURITY.md.
  • Código de Conduta: CODE_OF_CONDUCT.md. Pacto do Contribuidor. Seja excelente uns com os outros.

Contribuindo

Contribuições são bem-vindas. Veja CONTRIBUTING.md para orientações. Antes de abrir um PR:

  1. Execute python -m pytest tests/ (todos os 160 devem passar).
  2. Execute python3 scripts/lint_prose.py --root . (zero violações).
  3. Execute claude plugin validate . (deve passar).
  4. Atualize as versões de forma coerente se você alterar contagens ou comportamentos visíveis ao usuário (veja docs/PUBLISHING.md).

Licença

Licença MIT. Veja LICENSE para detalhes.

Projetos relacionados

  • Rankenstein: Fluxo de trabalho de publicação de conteúdo baseado em GUI; da pesquisa à publicação em uma plataforma.
  • Framework FLOW: Prompts orientados por evidências Find, Optimize, Win (CC BY 4.0). Integrado como sub-habilidade via /blog flow.
  • Claude Ads e Claude SEO: habilidades irmãs que compartilham o mesmo kit de marca (banner + diagramas gerados com a paleta laranja da marca).
  • AI Marketing Hub: Comunidade gratuita, mais de 2.800 membros. O nível Pro em ai-marketing-hub-pro hospeda o espelho privado desta habilidade.

Histórico de estrelas

<a href="https://star-history.com/#AgriciDaniel/claude-blog&Date"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=AgriciDaniel/claude-blog&type=Date&theme=dark" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=AgriciDaniel/claude-blog&type=Date" /> <img alt="Histórico de estrelas do AgriciDaniel/claude-blog no GitHub" src="https://api.star-history.com/svg?repos=AgriciDaniel/claude-blog&type=Date" /> </picture> </a>

Se o claude-blog economiza seu tempo, uma estrela no repositório público é a maneira mais fácil de agradecer (e ajuda outros criadores de conteúdo a encontrá-lo).

Autor

Criado por Daniel Agrici, Arquiteto de Fluxos de Trabalho de IA, com Claude Code.

  • Blog: Mergulhos profundos em automação de marketing com IA.
  • YouTube: Tutoriais e demonstrações.
  • Todas as ferramentas de código aberto: Outras habilidades do Claude Code.
  • AI Marketing Hub: Comunidade gratuita para marketing potencializado por IA.

FAQ