Use este checklist antes de publicar qualquer artigo para verificar se ele atende aos padrões tanto de legibilidade humana quanto de recuperação por IA. Cada item segue uma boa prática abordada em conteúdo amigável para a IA da Geração Geral.
Estrutura e títulos
- Os títulos H1, H2 e H3 são usados hierarquicamente, nenhum nível é pulado.
- Cada título é descritivo e específico, não genérico (evite "Visão Geral", "Introdução", "Detalhes").
- Nenhum título é repetido no mesmo artigo.
- Palavras-chave relevantes aparecem naturalmente nos títulos.
Parágrafos e fluxo
- As frases são curtas. Idealmente menos de 20 palavras e direto.
- Cada parágrafo cobre uma única ideia ou tarefa.
- Preenchimento de informações, contexto de fundo e tangenciais são removidos ou linkados separadamente.
- Cada seção é modular e concisa. Idealmente menos de 500 tokens (~375 palavras).
Listas e tabelas
- Os tópicos são usados para informações agrupadas e não ordenadas.
- Listas numeradas são usadas para etapas sequenciais.
- As listas contêm de 3 a 7 itens e cada item é paralelo em estrutura.
- Tabelas são usadas para dados estruturados (parâmetros, configurações, comparações).
- Todas as colunas das tabelas possuem cabeçalhos descritivos.
- Todas as células da tabela contêm texto descritivo. Sem Y/N, traços, emojis ou ícones.
- Sem células mescladas ou formatação de tabelas inconsistente.
Trechos de código
- O código é limpo, consistentemente indentado e corretamente formatado.
- Comentários internos explicam lógica e intenção.
- Destacamento de sintaxe ou tags de idioma são aplicados.
- Blocos de código são copiáveis. Sem números de linha ou estilo decorativo.
- Uma instrução de contexto está incluída para código API ou do produto.
Imagens e links
- Cada imagem tem texto alternativo significativo e descritivo.
- Texto alternativo evita rótulos vagos como "captura de tela".
- Legendas ou textos ao redor fornecem contexto adicional quando necessário.
- Todo texto âncora é descritivo. Por exemplo, "Aprenda a gerenciar espaços de trabalho privados" em vez de "aqui", "isto" ou "clique aqui."
- Links internos conectam a artigos relacionados quando relevante.
SEO e metadados
- Palavras-chave aparecem naturalmente em títulos, aberturas de seções e texto do corpo da chave.
- Uma meta-descrição é escrita com as principais palavras-chave do artigo.
- Metadados estruturados (tag de título, descrição, campos personalizados) são aplicados onde suportado.
- A terminologia é consistente com termos aprovados pelo glossário.
Habilidades e fluxo de trabalho de IA
- Se um SKILL.md foi usado, o resultado foi revisado quanto à precisão e completude antes da publicação.
- Nenhuma seção foi pulada sem motivo. Se uma seção for omitida, ela realmente não se aplica.
- Voz e tom correspondem às convenções do MSTP: segunda pessoa, presente, voz ativa, sem linguagem de marketing.
- As perguntas frequentes produzidas pela habilidade são autônomas e provenientes de perguntas reais de usuários, não de preenchimento gerado.
GEO (Otimização de Motores Generativos)
- O artigo começa com uma resposta direta à pergunta principal do usuário nas duas primeiras frases.
- Cada seção é autônoma e faz sentido quando lida isoladamente, sem exigir contexto ao redor.
- Termos-chave e definições são explicitamente declarados, não assumidos pelo contexto.
- Nenhuma informação crítica está enterrada no meio de um longo parágrafo — destaque em um título, lista ou destaque.
- O conteúdo é estruturado para que a IA possa extrair uma resposta útil sem precisar ler o artigo completo.
Glossário e terminologia
- Os termos aprovados do glossário são usados exatamente conforme definidos. Sem sinônimos ou variações.
- Termos desconhecidos são definidos ou vinculados na primeira menção.
- Abreviações e siglas são usadas consistentemente ao longo de toda a obra.
Estilo de escrita
- O tom é claro, conversacional e fácil de usar com facilidade.
- É usada linguagem simples; Jargão é evitado ou explicado.
- A segunda pessoa ("você") é usada em conteúdos instrucionais e de como fazer.
Perguntas frequentes
- O artigo inclui de 5 a 10 perguntas frequentes em uma seção dedicada.
- As perguntas são originadas de consultas reais de usuários, tickets de suporte ou perguntas comuns sobre produtos.
- Cada resposta ao FAQ é autônoma e concisa.
Verificações específicas de IA
- Rascunhos gerados por IA revisados quanto à precisão, tom e alucinações.
- O artigo foi testado no Eddy AI para confirmar respostas precisas.
- O conteúdo é modular o suficiente para ser reutilizado em FAQs, respostas de chat e resumos.
- Dúvidas não respondidas ou feedback de suporte foram revisados e incorporados.