# Habilidade de Agente de Escrita de Blog com IA para Claude Code > 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. - Canonical: https://nanoskill.ai/pt/skills/ai-blog-writing-skill - Markdown: https://nanoskill.ai/pt/skills/ai-blog-writing-skill.md - Author: AgriciDaniel - Published: 2026-05-24T06:35:19.314Z - Updated: 2026-07-25T04:39:13.470Z - Language: pt - Source type: github - Popularity signal: 818 ## Sources - https://github.com/AgriciDaniel/claude-blog ## Install ```shell npx skills add https://github.com/AgriciDaniel/claude-blog ``` ## About 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. ## Key features - **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. ## Use cases - **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. ## Result preview Veja um listículo real sobre as melhores ferramentas de PPT com IA criado por esta Habilidade de Agente. ![blog-writing-demo-01](https://file.nanoskill.ai/blog-writing-demo-01) ![blog-writing-demo-02](https://file.nanoskill.ai/blog-writing-demo-02) ![blog-writing-demo-03](https://file.nanoskill.ai/blog-writing-demo-03) ![blog-writing-demo-4](https://file.nanoskill.ai/blog-writing-demo-4) ## Result walkthrough ### Passo 1: Instalar Adicione a habilidade ao seu agente. ![blog-writing-step-1](https://file.nanoskill.ai/blog-writing-step-1) ### Passo 2:Gerar Conteúdo Use um comando específico para gerar conteúdo de blog. ![blog-writing-step-2](https://file.nanoskill.ai/blog-writing-step-2) ### Passo 3:Revisar e Editar Revise o conteúdo e edite no documento Word gerado. ![blog-writing-step-03](https://file.nanoskill.ai/blog-writing-step-03) ## Skill definition # 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`](https://github.com/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`](https://github.com/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](https://www.skool.com/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`](docs/PUBLISHING.md). > **Blog:** [Veja como o claude-blog funciona](https://agricidaniel.com/blog/claude-code-blog-writer) **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`: ```markdown --- 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//` para o conteúdo da habilidade, `~/.claude/agents/.md` para agentes e `~/.claude/scripts/.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.` (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](#demo) - [Início Rápido](#início-rápido) - [Comandos](#comandos) - [Como o claude-blog se compara?](#como-o-claude-blog-se-compara) - [Recursos](#recursos) - [Contrato de entrega (v1.9.0)](#contrato-de-entrega-v190) - [Arquitetura](#arquitetura) - [Requisitos](#requisitos) - [Perguntas Frequentes](#perguntas-frequentes) - [Roteiro](#roteiro) - [Desinstalação](#desinstalação) - [Integração](#integração) - [Documentação](#documentação) - [Como citar](#como-citar) - [Segurança e Código de Conduta](#segurança--código-de-conduta) - [Contribuindo](#contribuindo) - [Licença](#licença) - [Projetos relacionados](#projetos-relacionados) - [Autor](#autor) ## Demonstração [Assista à Demonstração no YouTube](https://www.youtube.com/watch?v=AeLC4iutG8w)

demonstração do comando claude-blog: roteamento de subcomandos /blog através do orquestrador

--- ## 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`](https://github.com/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](https://www.skool.com/ai-marketing-hub-pro) para ser adicionado. **Instalação via Plugin (Claude Code 1.0.33+):** ```bash # 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): ```bash 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):** ```bash curl -fsSL https://raw.githubusercontent.com/AI-Marketing-Hub/claude-blog/main/install.sh | bash ``` **Instalação com Um Comando (Windows PowerShell):** ```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):** ```bash # 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](https://github.com/AI-Marketing-Hub/claude-blog/blob/main/install.sh) 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 ` para definir o escopo do seu blog, `/blog write ` para gerar seu primeiro artigo (o contrato de 5 portões é executado automaticamente) e `/blog analyze ` para pontuá-lo na rubrica de 100 pontos.

demonstração do /blog write do claude-blog: geração de artigo ponta a ponta com o Contrato de Entrega de 5 portões

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

| Comando | Descrição | |---------|-------------| | `/blog write ` | Escrever um novo post de blog do zero | | `/blog rewrite ` | Otimizar um post de blog existente | | `/blog analyze ` | Auditoria de qualidade com pontuação de 0 a 100 | | `/blog brief ` | Gerar um briefing de conteúdo detalhado | | `/blog calendar` | Gerar um calendário editorial | | `/blog strategy ` | Estratégia de blog e ideação de tópicos | | `/blog outline ` | Esboço de conteúdo informado pela SERP | | `/blog seo-check ` | Validação de SEO pós-escrita | | `/blog schema ` | Gerar marcação de esquema JSON-LD | | `/blog repurpose ` | Reaproveitar para redes sociais, e-mail, YouTube | | `/blog geo ` | 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 ` | 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 ` | 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] ` | Planejamento e execução de cluster de tópicos semânticos (hub-and-spoke) | | `/blog multilingual --languages ` | Escrever, traduzir, localizar e emitir hreflang em um único comando | | `/blog translate --to ` | Tradução otimizada para SEO com preservação de formato | | `/blog localize --locale ` | Adaptação cultural profunda por localidade | | `/blog locale-audit ` | 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 ` | 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: | Capacidade | claude-blog | Prompt direto no Claude / ChatGPT | Copy.ai / Jasper | Construir 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) | Categoria | Pontos | Foco | |----------|--------|-------| | Qualidade do Conteúdo | 30 | Profundidade, legibilidade, originalidade, engajamento | | Otimização de SEO | 25 | Cabeçalhos, título, palavras-chave, links, meta | | Sinais E-E-A-T | 15 | Autor, citações, confiança, experiência | | Elementos Técnicos | 15 | Esquema, imagens, velocidade, dispositivos móveis, tags OG | | Prontidão para Citação de IA | 15 | Citabilidade, 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ência | Propósito | Usado por | |---|---|---| | `ai-slop-detection.md` | Detecção de conteúdo de IA em duas camadas: primeira ordem (frases) + segunda ordem (ritmo estrutural) | `blog-rewrite`, `blog-reviewer`, `blog-analyze` | | `editorial-heuristics.md` | 10 heurísticas adaptadas de Nielsen com pontuação 0-4 + marcação de gravidade P0-P3 | `blog-analyze --rubric` | | `cognitive-load.md` | Densidade 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.md` | Rubrica de pesquisa em 5 dimensões + 4 classes de armadilha de palavras-chave pré-voo + limites mínimos de atualização | `blog-researcher`, `blog-discourse`, `blog-brief`, `blog-strategy` | | `synthesis-contract.md` | 6 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`](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`](https://github.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.

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

## Contrato de entrega (v1.9.0)

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

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ão | Aplica | Implementação | |---|---|---| | 1. Descoberta de Capacidade | Ferramentas e agentes necessários presentes antes da escrita | `scripts/blog_preflight.py --gate 1` | | 2. Completude de Formato | `.md` + `.html` + `.pdf` + imagem de herói real | `scripts/blog_render.py`, `scripts/generate_hero.py` | | 3. Verificação Visual | Sem overflow de SVG, JSON-LD válido, modo escuro renderizado corretamente | `patchright` / `playwright` em 3 larguras de viewport | | 4. Revisão de Conteúdo (BLOQUEANTE) | `blog-reviewer` pontuação 90+ E zero problemas P0 | `agents/blog-reviewer.md` (bloqueante, v1.9.0) | | 5. Integridade de Ativos e Links | Cada 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`](skills/blog/references/blog-delivery-contract.md). ## Arquitetura

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

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. | Camada | Quantidade | Localização | |---|---:|---| | Sub-habilidades (invocáveis pelo usuário) | 29 | `skills/blog-*/SKILL.md` | | Sub-habilidades (internas) | 1 | `skills/blog-chart/SKILL.md` | | Agentes especializados | 5 | `agents/blog-*.md` | | Referências sob demanda | 21 | `skills/blog/references/*.md` | | Modelos de conteúdo | 12 | `skills/blog/templates/*.md` | | Scripts Python no nível raiz | 9 | `scripts/*.py` | | Testes | 160 | `tests/test_*.py` | Árvore de diretórios completa, diagramas de fluxo de dados, metodologia de pontuação e pontos de extensão: [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md). ## Requisitos - [Claude Code](https://docs.anthropic.com/en/docs/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: ```bash 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`](https://github.com/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`](skills/blog/references/blog-delivery-contract.md). ### Posso usar o claude-blog em vários idiomas? Sim. `/blog multilingual --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](#como-citar) abaixo ou o arquivo [`CITATION.cff`](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`](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`](SECURITY.md) para o modelo de ameaça completo. ## Roteiro

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)

**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: ```bash chmod +x uninstall.sh && ./uninstall.sh ``` Windows (PowerShell): ```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): | Habilidade | Integração | |-------|-------------| | `/seo` | Análise profunda de SEO de páginas de blog publicadas | | `/seo-schema` | Validação e geração de marcação de esquema | | `/seo-geo` | Auditoria de otimização para citação de IA | | `/seo-google` | Dados da API do Google (configuração compartilhada com blog-google) | ## Documentação A documentação detalhada está em [`docs/`](docs/): - [Guia de Instalação](docs/INSTALLATION.md): Unix, macOS, Windows, instalação manual. - [Referência de Comandos](docs/COMMANDS.md): Referência completa de comandos com exemplos. - [Arquitetura](docs/ARCHITECTURE.md): Design do sistema e visão geral dos componentes. - [Fluxo de Trabalho de Publicação](docs/PUBLISHING.md): Fluxo de lançamento privado-para-público (mantenedores Pro). - [Modelos](docs/TEMPLATES.md): Referência de modelos e personalização. - [Solução de Problemas](docs/TROUBLESHOOTING.md): Problemas comuns e correções. - [Integração MCP](docs/MCP-INTEGRATION.md): Configuração opcional do servidor MCP. ## Como citar Se você usar o claude-blog em pesquisa ou produção, por favor cite o projeto: ```bibtex @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`](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`](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`](SECURITY.md). - **Código de Conduta**: [`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md). Pacto do Contribuidor. Seja excelente uns com os outros. ## Contribuindo Contribuições são bem-vindas. Veja [`CONTRIBUTING.md`](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`](docs/PUBLISHING.md)). ## Licença Licença MIT. Veja [`LICENSE`](LICENSE) para detalhes. ## Projetos relacionados - **[Rankenstein](https://rankenstein.pro)**: Fluxo de trabalho de publicação de conteúdo baseado em GUI; da pesquisa à publicação em uma plataforma. - **[Framework FLOW](https://github.com/AgriciDaniel/flow)**: Prompts orientados por evidências Find, Optimize, Win (CC BY 4.0). Integrado como sub-habilidade via `/blog flow`. - **[Claude Ads](https://github.com/AgriciDaniel/claude-ads)** e **[Claude SEO](https://github.com/AgriciDaniel/claude-seo)**: habilidades irmãs que compartilham o mesmo kit de marca (banner + diagramas gerados com a paleta laranja da marca). - **[AI Marketing Hub](https://www.skool.com/ai-marketing-hub)**: Comunidade gratuita, mais de 2.800 membros. O nível Pro em [`ai-marketing-hub-pro`](https://www.skool.com/ai-marketing-hub-pro) hospeda o espelho privado desta habilidade. ## Histórico de estrelas Histórico de estrelas do AgriciDaniel/claude-blog no GitHub Se o claude-blog economiza seu tempo, uma estrela no [repositório público](https://github.com/AgriciDaniel/claude-blog) é a maneira mais fácil de agradecer (e ajuda outros criadores de conteúdo a encontrá-lo). ## Autor Criado por [Daniel Agrici](https://agricidaniel.com/about), Arquiteto de Fluxos de Trabalho de IA, com Claude Code. - [Blog](https://agricidaniel.com/blog): Mergulhos profundos em automação de marketing com IA. - [YouTube](https://www.youtube.com/@AgriciDaniel): Tutoriais e demonstrações. - [Todas as ferramentas de código aberto](https://github.com/AgriciDaniel): Outras habilidades do Claude Code. - [AI Marketing Hub](https://www.skool.com/ai-marketing-hub): Comunidade gratuita para marketing potencializado por IA. ## FAQ ### O que é a habilidade claude-blog? claude-blog é um conjunto de habilidades do Claude Code projetado para escrever, otimizar e auditar conteúdo de blog em escala. Ele garante que cada artigo seja duplamente otimizado para classificações do Google e plataformas de citação de IA. ### Para quem é esta habilidade de escrita de blog com IA? É para blogueiros solo e criadores que desejam publicar postagens de alta qualidade com eficiência, equipes de marketing e agências que gerenciam grandes portfólios de conteúdo, e construtores de habilidades do Claude Code que buscam uma referência de nível de produção para arquitetura de habilidades. ### Como funciona o Contrato de Entrega de 5 Portões? O Contrato de Entrega de 5 Portões avalia cada rascunho com uma rubrica de 100 pontos abrangendo Capacidade, Formato, Visual, Revisão de Conteúdo e Integridade de Ativos. Qualquer rascunho com pontuação abaixo de 90 é bloqueado e o redator itera até três vezes antes de escalar para você. ### Que tipo de conteúdo o claude-blog produz? Ele produz 8 artefatos em uma única pasta, incluindo um arquivo markdown com título, descrição, data, autor, tags e URL canônica, além de HTML renderizado, PDF, imagens de destaque, capturas de tela, um cartão de pontuação de revisão e um relatório de auditoria pré-voo. ### Esta habilidade pode lidar com conteúdo multilíngue? Sim, ela suporta publicação multilíngue com um único comando, incluindo escrita, tradução, localização e emissão de hreflang. Também oferece tradução otimizada para SEO com preservação de formato e adaptação cultural profunda por localidade. ### Como o claude-blog garante qualidade e precisão do conteúdo? Ele usa um sistema de pontuação de qualidade de 5 categorias, detecção de conteúdo de IA para sinalizar prosa gerada por máquina, escrita orientada por persona com aplicação de estilo e um pipeline de verificação de fatos que verifica estatísticas em relação a fontes citadas.