Skill de artigo para base de conhecimento no Claude

Transforme chamados repetidos em artigos de central de ajuda com título buscável, passos testáveis e versão curta para WhatsApp.

Acesso
Grátis
Downloads
Seja o primeiro a baixar
Versão
1.0.0
Atualizada em
17/11/2026
Funciona em
Claude Code, Claude.ai / Cowork, API
Receber a skill grátis

Resposta direta: a skill Artigo de base de conhecimento faz o Claude transformar um chamado resolvido, uma dúvida que se repete ou um contorno em artigo de central de ajuda pronto para publicar. Ela escolhe o tipo certo, escreve título que o cliente busca, passos testáveis e entrega metadados, data de revisão e versão curta para WhatsApp.

Para quem é esta skill?

  • Times de atendimento que respondem a mesma pergunta toda semana e querem mandar um link em vez de reescrever.
  • Empresas montando ou reorganizando a central de ajuda no Zendesk, Freshdesk, Movidesk, Octadesk, Notion ou WordPress.
  • Equipes de produto e suporte que precisam publicar um problema conhecido com contorno e manter o status atualizado.
  • Quem quer revisar artigos antigos que ficaram errados depois de mudanças no produto.
  • Para quem não é: quem precisa de documentação técnica para desenvolvedores, como referência de API, ou de conteúdo de blog para atrair visitas.

O que a skill faz, passo a passo

  1. Entende o material de origem: qual era o problema, qual foi a solução confirmada, quem é afetado e com que frequência. Se faltar o caminho exato de menus ou a mensagem de erro, pergunta.
  2. Escolhe o tipo de artigo: tutorial (como fazer), solução de problemas, FAQ, problema conhecido ou referência (limites, planos, prazos).
  3. Escreve para ser encontrado: título com as palavras que o cliente digita, primeira frase que repete o problema em linguagem simples e sinônimos nas tags.
  4. Redige o corpo no modelo do tipo: passos numerados começando por verbo, menus em negrito, o que o cliente deve ver depois de cada passo e a seção “Ainda precisa de ajuda?” com os canais.
  5. Revisa com um checklist e marca com [CONFIRMAR] tudo o que não tem certeza, além do que precisa de validação técnica ou jurídica.
  6. Entrega com metadados: categoria, tags, público, resumo para busca, origem, quem valida, data de revisão e versão curta para WhatsApp.

Exemplo real

Pedido do usuário: “Toda semana chegam umas 20 mensagens no WhatsApp da loja dizendo ‘paguei o Pix e o pedido continua aguardando pagamento’. Quase sempre o cliente pagou depois que o QR Code expirou, ou fechou a tela antes da confirmação. Quando o Pix expira, estornamos em até 2 dias úteis. Escreve um artigo para a central de ajuda no Zendesk e uma versão curta para o WhatsApp.”

Trecho do resultado:

Título: Paguei o Pix, mas o pedido continua "Aguardando pagamento"
Tipo: Solução de problemas
Tags: pix, pagamento não confirmado, aguardando pagamento,
      qr code expirado, estorno pix

Se você pagou com Pix e o pedido ainda aparece como
Aguardando pagamento, veja o que pode ter acontecido.

Causas mais comuns
- A confirmação do Pix pode levar até 5 minutos.
- O QR Code vale por 30 minutos. Pagamentos feitos depois
  disso não são vinculados ao pedido.

Notas de publicação
- Validar com: financeiro (prazo do estorno) e TI (validade
  do QR Code).
- Revisar em: 17/02/2027.
- Sugestão: exibir a contagem regressiva do QR Code no
  checkout para reduzir esses chamados.

Além do artigo, a skill aponta uma melhoria no checkout que ataca a causa dos chamados.

O que vem no pacote

  • SKILL.md com o fluxo, as regras de escrita para autoatendimento e o checklist antes de publicar.
  • Modelos completos de artigo (references/modelos-de-artigo.md): tutorial, solução de problemas, FAQ, problema conhecido e referência, com exemplos de títulos bons e ruins.
  • Guia de manutenção da base (references/manutencao-e-categorias.md): estrutura de categorias, regras de links, ciclo de vida do artigo, quando atualizar ou criar novo, rotina de revisão e métricas.
  • Formato de metadados de publicação com versão curta para WhatsApp.
  • Exemplo comentado do artigo sobre Pix que não dá baixa (examples/exemplo-1.md).
  • Casos de teste (evals/evals.json).

Como instalar

No Claude.ai (plano pago, com execução de código ativada):

  1. Baixe o arquivo artigo-base-conhecimento.zip pelo formulário desta página.
  2. Abra Personalizar → Skills e clique para enviar uma skill.
  3. Selecione o .zip e confirme que a skill aparece ativada na lista.

No Claude Code:

  1. Descompacte o .zip.
  2. Copie a pasta artigo-base-conhecimento para ~/.claude/skills/ (ou para .claude/skills/ do projeto).
  3. Abra uma nova sessão e faça um pedido com o seu caso; a skill é carregada automaticamente quando o assunto aparece.

Na API: envie a pasta como skill personalizada pelo endpoint de Skills e referencie o ID dela na requisição, com a ferramenta de execução de código habilitada.

Limitações e cuidados

  • A skill não inventa telas, menus, prazos ou limites. O que não for informado fica marcado como [CONFIRMAR] e precisa ser validado antes de publicar.
  • Artigos sobre troca, devolução, cancelamento ou garantia não podem contrariar o direito do consumidor. A skill sinaliza esses trechos para revisão, mas não substitui advogado: confira a legislação vigente.
  • Nenhum dado real de cliente entra no artigo; os exemplos usam dados fictícios evidentes.
  • Ela não publica sozinha na sua plataforma, a menos que você tenha conectado a ferramenta ao Claude.
  • Artigo de problema conhecido exige atualização constante. A skill indica a data de revisão, mas manter o status em dia é tarefa do time.

Perguntas frequentes

Serve para uma central de ajuda feita em WordPress?

Sim. O artigo sai em texto estruturado com títulos, listas e metadados, pronto para colar em qualquer plataforma. Se você precisa de um site para hospedar a central, veja site institucional.

A skill evita artigos duplicados?

Ela pergunta se já existe artigo parecido e, quando há integração com a base de conhecimento, busca os existentes para sugerir atualização em vez de duplicação. O guia de manutenção explica quando atualizar e quando criar um novo.

Como medir se a base está reduzindo chamados?

O guia de manutenção traz uma rotina de revisão e métricas úteis, como assuntos com muitos chamados e nenhum artigo. A skill também gera a versão curta para WhatsApp, que facilita mandar o link em vez de digitar a resposta inteira.

Licença: Apache-2.0

Créditos: Adaptada para o Brasil pela VVerner a partir de github.com/anthropics/knowledge-work-plugins (Apache-2.0).

Skills independentes, sem afiliação ou endosso da Anthropic. Claude é marca da Anthropic, PBC.

Skills relacionadas

Ver biblioteca