AgentSkillsCN

edicao-de-conteudo

在使用编辑工具对博客内容进行编辑或审阅时,尤其注重优化结构、提升清晰度、增强SEO效果、完善链接布局以及优化媒体呈现。

SKILL.md
--- frontmatter
name: edicao-de-conteudo
description: Use ao editar ou revisar conteúdo de blog posts com ferramentas de editor, especialmente para melhorar estrutura, clareza, SEO, links e posicionamento de mídia.

Edição de Conteúdo

Visão geral

Guia completo (pt-BR) para usar as ferramentas de edição de conteúdo com foco em qualidade, legibilidade e SEO. Siga as regras abaixo e nunca escreva Markdown de imagens manualmente.

Regras essenciais (obrigatórias)

  • Sem H1 no corpo. O título fica no frontmatter. Comece o conteúdo com ## (H2).
  • Nunca inclua contagem de palavras, progresso de escrita, meta‑comentários, notas internas ou comentários entre colchetes.
  • Evite padrões ruins: introdução longa (>150 palavras antes de gerar valor), keyword stuffing, parágrafos gigantes (máx. 3–4 frases), instruções vagas e frases de enchimento.
  • Imagens: espere o usuário fornecer a URL. Use insertImage com URL e texto alternativo. Nunca pesquise imagens, nunca use URL placeholder e nunca escreva ![alt](url) manualmente.
  • Markdown: H2/H3 com ##/###, ênfase com negrito e itálico, código inline e links com [texto](url).
  • Tabelas: use para comparação de features, dados de referência e cronogramas. Não use para lista de uma coluna, instruções sequenciais ou só 2 itens. Máx. 3–5 colunas (mobile), cabeçalhos curtos (1–3 palavras), texto alinhado à esquerda e números à direita.
  • Interleaved thinking após cada tool call: 1) reflita sobre o resultado 2) pense no próximo passo 3) aja chamando a próxima ferramenta.

Organização das ferramentas (quando e como usar)

1) Manipulação de texto

Insert Text — use para acrescentar trechos, introduções curtas ou complementos em pontos exatos.

  • ✅ Use quando faltar contexto, exemplos ou transições.
  • ❌ Não use para “colocar qualquer coisa” antes de entender a lacuna.

Replace Text — use para ajustar termos, corrigir repetições ou substituir frases vagas por conteúdo específico.

  • ✅ Troque termos genéricos por termos precisos.
  • ❌ Não faça substituições massivas sem revisar fluidez.

Delete Text — use para remover redundâncias, trechos fora do tópico e parágrafos longos demais.

  • ✅ Remova introduções infladas e “encheção de linguiça”.
  • ❌ Não delete informações que suportam o argumento principal.

Format Text — use para dar ênfase pontual e legibilidade.

  • ✅ Destaque termos-chave e conceitos.
  • ❌ Evite excesso de negrito ou itálico.

2) Estrutura e organização

Insert Heading — use para criar seções (H2), subseções (H3) e tópicos menores (H4).

  • ✅ Seções claras, com títulos objetivos.
  • ❌ Nunca use H1 no corpo.

Insert List — use para listas de passos, recursos ou agrupamentos.

  • ✅ Prefira listas quando o texto vira “parede”.
  • ❌ Não transforme tudo em lista; equilíbrio é essencial.

Insert Code Block — use para snippets com linguagem definida e, se necessário, uma legenda curta.

  • ✅ Use quando o leitor precisa copiar/entender código.
  • ❌ Não use para pseudo‑código quando uma explicação bastar.

Insert Table — use para comparações e dados estruturados.

  • ✅ Resuma diferenças, preços, prazos, métricas.
  • ❌ Não use tabela para 2 itens ou lista simples.

3) Mídia e apoio visual

Insert Image — use somente com URL fornecida pelo usuário.

  • ✅ Defina alt text claro e descritivo; adicione legenda se agrega valor.
  • ❌ Jamais invente URL ou escreva Markdown de imagem manualmente.

Suggest Images — use para planejar onde inserir imagens e quais tipos ajudam o leitor.

  • ✅ 1 imagem a cada 300–500 palavras.
  • ✅ Sugira tipo (screenshot, diagrama, infográfico, foto) e consulta de busca.

4) SEO e otimização editorial

Inject Keywords — use para inserir palavras‑chave faltantes mantendo naturalidade.

  • ✅ Coloque keyword em H2, no 1º parágrafo e em substituições contextuais.
  • ❌ Nunca force repetição; preserve legibilidade.

Add Internal Links — use após buscar conteúdos relacionados e inserir links internos relevantes.

  • ✅ Máx. 3 links; posicione após seções principais, antes da conclusão ou no fim.
  • ❌ Não linkar excessivamente ou fora de contexto.

Add External Links — use para citar fontes confiáveis (estatísticas, estudos, fatos datados).

  • ✅ Prefira fontes oficiais, acadêmicas ou reconhecidas no tema.
  • ❌ Evite links frágeis, promocionais ou sem autoridade.

Improve Readability — use para clareza: frases longas, vocabulário complexo e parágrafos extensos.

  • ✅ Divida frases com 20+ palavras e parágrafos com 100+ palavras.
  • ✅ Meta: Flesch ~60.

Optimize Title — use para reescrever o título com keyword no início e até 60 caracteres.

  • ✅ Mantenha natural e fácil de ler.
  • ❌ Não sacrifique clareza por SEO.

Optimize Meta — use para meta description com keyword e CTA (150–160 caracteres).

  • ✅ Extraia pontos principais do conteúdo.

Generate Quick Answer — use para criar resposta rápida nos primeiros 100 palavras (resumo rápido, definição, pontos‑chave ou comparação).

  • ✅ Ajuda a capturar a intenção do leitor imediatamente.

Exemplos rápidos (✅/❌)

Sem H1 no corpo

  • ## Benefícios do SEO local
  • # Benefícios do SEO local

Imagem sempre via ferramenta

  • ✅ “Inserir imagem com URL fornecida pelo usuário usando insertImage.”
  • ![gráfico](https://exemplo.com/grafico.png)

Tabela bem usada

  • ✅ Comparar 3 planos com 3–5 colunas, cabeçalhos curtos
  • ❌ Tabela de uma coluna com 2 itens

Introdução enxuta

  • ✅ 2–3 frases que entregam valor e contexto
  • ❌ 8 parágrafos antes de chegar ao ponto

Checklist final do editor

  • Conteúdo começa em H2 (sem H1).
  • Sem meta‑comentários ou notas internas.
  • Parágrafos curtos e leitura fluida.
  • Keywords naturais, sem stuffing.
  • Links internos/externos com propósito.
  • Imagens só com URL fornecida pelo usuário.