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 emdocs/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 troqueAI-Marketing-Hub/claude-blogporAgriciDaniel/claude-bloge o slug do pluginclaude-blog@ai-marketing-hub-claude-blogporclaude-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çãoAI-Marketing-Hub. Se/plugin marketplace addfalhar 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
curlouirmdiretamente 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 credenciaisgh 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
<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>🚀 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.
| Comando | Descriçã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 calendar | Gerar 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 updatecom 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
srcdoce 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 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.
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ã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.
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.
| 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.
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.txtpara análise avançada (pontuação de legibilidade, detecção de esquema).
Portões de qualidade (impostos por CI em cada PR)
- pytest: 160 testes abrangendo suítes de segurança, comportamental, regressão e contrato de entrega.
- Validação de plugin:
claude plugin validate .mais verificações manuais de JSON/regex. - Lint de caminhos obsoletos: detecta desvios em referências cruzadas de
references/etemplates/. - 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--. - Coerência de versão:
tests/test_version_coherence.pyafirma quepyproject.toml,plugin.json,CITATION.cffe o frontmatter deskills/blog/SKILL.mdcorrespondem. - Coerência de comandos:
tests/test_command_coherence.pyafirma queskills/blog/SKILL.mdedocs/COMMANDS.mddeclaram 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 entreblog_rendereblog_preflightpara 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):
| 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/:
- 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 emSECURITY.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:
- Execute
python -m pytest tests/(todos os 160 devem passar). - Execute
python3 scripts/lint_prose.py --root .(zero violações). - Execute
claude plugin validate .(deve passar). - 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-prohospeda 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.


