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
- 0 Seja o primeiro a baixar
- Versão
- 1.0.0
- Atualizada em
- 17/11/2026
- Funciona em
- Claude Code, Claude.ai / Cowork, API
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
- 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.
- Escolhe o tipo de artigo: tutorial (como fazer), solução de problemas, FAQ, problema conhecido ou referência (limites, planos, prazos).
- 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.
- 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.
- 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. - 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.mdcom 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):
- Baixe o arquivo
artigo-base-conhecimento.zippelo formulário desta página. - Abra Personalizar → Skills e clique para enviar uma skill.
- Selecione o .zip e confirme que a skill aparece ativada na lista.
No Claude Code:
- Descompacte o .zip.
- Copie a pasta
artigo-base-conhecimentopara~/.claude/skills/(ou para.claude/skills/do projeto). - 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.