Loading skill
Install any skill in seconds. Free to start, no credit card required.
Get Started Free →Redige um artigo para base de conhecimento a partir de um problema resolvido ou pergunta frequente. Use quando a resolução de um ticket vale ser documentada para self-service, a mesma pergunta continua aparecendo, um workaround precisa ser publicado, ou um problema conhecido deve ser comunicado aos clientes. / Draft a knowledge base article from a resolved issue or common question. Use when a ticket resolution is worth documenting for self-service, the same question keeps coming up, a workaround
.claude/skills/evolution-foundation-cs-kb-article/SKILL.md| Test case | Without → With | Effect | Δ tokens | Δ turns |
|---|---|---|---|---|
| case-14 | ✗→✓ | ▲ Improved | 111% | 0% |
| case-15 | ✗→✓ | ▲ Improved | 125% | 0% |
| case-16 | ✗→✓ | ▲ Improved | 190% | 0% |
| case-01 | ✗→✓ | ▲ Improved | 159% | 0% |
| case-03 | ✗→✓ | ▲ Improved | 146% | 0% |
> Se encontrar integrações não configuradas, verifique CONNECTORS.md.
Redigir um artigo de base de conhecimento pronto para publicação a partir de um problema de suporte resolvido, pergunta frequente ou workaround documentado. Estrutura o conteúdo para pesquisabilidade e self-service.
/cs-kb-article <problema resolvido, referência de ticket ou descrição do tópico>Exemplos:
/cs-kb-article Como configurar SSO com Okta — resolvi isso para 3 clientes no mês passado/cs-kb-article Ticket #4521 — cliente não conseguia exportar dados com mais de 10k linhas/cs-kb-article Pergunta frequente: como configurar notificações via webhook/cs-kb-article Problema conhecido: gráficos do dashboard não carregam no Safari 16Analisar o input para identificar:
Se uma referência de ticket for fornecida, buscar o contexto completo:
/int-evo-crm): Puxar o thread do ticket, resolução e quaisquer notas internas/int-linear-review) ou Linear MCP: Verificar se há bug report ou feature request relacionadoUsando a estrutura de artigo, padrões de formatação e boas práticas de pesquisabilidade abaixo:
Apresentar o rascunho com metadados:
## Rascunho de Artigo KB
**Título:** [Título do artigo]
**Tipo:** [How-to / Troubleshooting / FAQ / Problema Conhecido / Referência]
**Categoria:** [Área de produto ou tópico]
**Tags:** [Tags pesquisáveis]
**Público:** [Todos os usuários / Admins / Desenvolvedores / Plano específico]
---
[Conteúdo completo do artigo — usando o template apropriado abaixo]
---
### Notas de Publicação
- **Fonte:** [Ticket #, conversa com cliente, ou discussão interna]
- **Artigos existentes para atualizar:** [Se isso tem sobreposição com conteúdo existente]
- **Revisão necessária de:** [SME ou time se precisar verificar precisão técnica]
- **Data de revisão sugerida:** [Quando revisitar para verificar precisão]Após gerar o artigo:
Todo artigo KB deve incluir:
Artigos são inúteis se os clientes não conseguem encontrá-los. Otimizar cada artigo para busca:
| Bom Título | Título Ruim | Por quê | |------------|-----------|-----| | "Como configurar SSO com Okta" | "Configuração SSO" | Específico, inclui o nome da ferramenta que clientes buscam | | "Fix: Dashboard mostra página em branco" | "Problema no Dashboard" | Inclui o sintoma que os clientes vivenciam | | "Rate limits e quotas da API" | "Informações da API" | Inclui os termos específicos que clientes buscam | | "Erro: 'Connection refused' ao importar dados" | "Problemas de Importação" | Inclui a mensagem de erro exata |
Começar cada artigo com uma frase que recoloca o problema ou tarefa em linguagem simples:
Objetivo: Instruções passo a passo para realizar uma tarefa.
Estrutura:
# Como [realizar tarefa]
[Overview — o que este guia cobre e quando usá-lo]
## Pré-requisitos
- [O que é necessário antes de começar]
## Passos
### 1. [Ação]
[Instrução com detalhes específicos]
### 2. [Ação]
[Instrução]
## Verificar se Funcionou
[Como confirmar o sucesso]
## Problemas Comuns
- [Problema]: [Solução]
## Artigos Relacionados
- [Links]Boas práticas:
Objetivo: Diagnosticar e resolver um problema específico.
Estrutura:
# [Descrição do problema — o que o usuário vê]
## Sintomas
- [O que o usuário observa]
## Causa
[Por que isso acontece — explicação breve e sem jargão]
## Solução
### Opção 1: [Correção principal]
[Passos]
### Opção 2: [Alternativa se a Opção 1 não funcionar]
[Passos]
## Prevenção
[Como evitar isso no futuro]
## Ainda Com Problemas?
[Como obter ajuda]Boas práticas:
Objetivo: Resposta rápida a uma pergunta comum.
Estrutura:
# [Pergunta — nas palavras do cliente]
[Resposta direta — 1-3 frases]
## Detalhes
[Contexto adicional, nuances ou explicação se necessário]
## Perguntas Relacionadas
- [Link para FAQ relacionado]
- [Link para FAQ relacionado]Boas práticas:
Objetivo: Documentar um bug conhecido ou limitação com um workaround.
Estrutura:
# [Problema Conhecido]: [Descrição breve]
**Status:** [Investigando / Workaround Disponível / Correção em Progresso / Resolvido]
**Afetados:** [Quem/o que é afetado]
**Última atualização:** [Data]
## Sintomas
[O que os usuários vivenciam]
## Workaround
[Passos para contornar o problema, ou "Nenhum workaround disponível"]
## Prazo de Correção
[Data prevista de correção ou status atual]
## Atualizações
- [Data]: [Atualização]Boas práticas:
Bases de conhecimento decaem sem manutenção. Seguir esse cronograma:
| Atividade | Frequência | Quem | |----------|-----------|-----| | Revisão de novo artigo | Antes de publicar | Revisão de par + SME para conteúdo técnico | | Auditoria de precisão | Trimestral | Time de suporte revisa artigos de maior tráfego | | Verificação de conteúdo obsoleto | Mensal | Sinalizar artigos não atualizados em 6+ meses | | Atualizações de problemas conhecidos | Semanal | Atualizar status em todos os problemas conhecidos abertos | | Revisão de analytics | Mensal | Verificar quais artigos têm baixas avaliações de utilidade ou altas taxas de rejeição | | Análise de gaps | Trimestral | Identificar principais tópicos de tickets sem artigos KB |
Atualizar existente quando:
Criar novo quando:
Organizar artigos em uma hierarquia que corresponde à forma como os clientes pensam:
Primeiros Passos
├── Configuração de conta
├── Configuração inicial
└── Guias de início rápido
Features e How-tos
├── [Área de feature 1]
├── [Área de feature 2]
└── [Área de feature 3]
Integrações
├── [Integração 1]
├── [Integração 2]
└── Referência de API
Troubleshooting
├── Erros comuns
├── Problemas de performance
└── Problemas conhecidos
Billing e Conta
├── Planos e preços
├── Dúvidas de billing
└── Gerenciamento de conta| Case | Status | Duration (ms) | Turns | Tokens | Tool calls | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Without | With | Δ | Without | With | Δ | Without | With | Δ | Without | With | Δ | ||
case-14 | fail→pass | 15,706 | 12,744 | -19% | 1 | 1 | 0% | 2,619 | 5,525 | +111% | 0 | 0 | — |
case-15 | fail→pass | 14,866 | 12,143 | -18% | 1 | 1 | 0% | 2,375 | 5,351 | +125% | 0 | 0 | — |
case-16 | fail→pass | 10,367 | 11,409 | +10% | 1 | 1 | 0% | 1,832 | 5,309 | +190% | 0 | 0 | — |
case-01 | fail→pass | 13,926 | 15,843 | +14% | 1 | 1 | 0% | 2,412 | 6,246 | +159% | 0 | 0 | — |
case-02 | fail→fail | 15,882 | 12,325 | -22% | 1 | 1 | 0% | 2,621 | 5,475 | +109% | 0 | 0 | — |
case-03 | fail→pass | 14,033 | 12,527 | -11% | 1 | 1 | 0% | 2,255 | 5,555 | +146% | 0 | 0 | — |
case-04 | pass→pass | 6,687 | 7,744 | +16% | 1 | 1 | 0% | 1,131 | 4,664 | +312% | 0 | 0 | — |
case-05 | pass→fail | 10,005 | 11,924 | +19% | 1 | 1 | 0% | 1,723 | 5,422 | +215% | 0 | 0 | — |
case-06 | pass→pass | 14,596 | 15,420 | +6% | 1 | 1 | 0% | 2,299 | 5,749 | +150% | 0 | 0 | — |
case-07 | fail→pass | 9,824 | 11,954 | +22% | 1 | 1 | 0% | 1,700 | 5,375 | +216% | 0 | 0 | — |
case-08 | pass→pass | 14,397 | 13,045 | -9% | 1 | 1 | 0% | 2,352 | 5,451 | +132% | 0 | 0 | — |
case-09 | pass→pass | 12,230 | 8,132 | -34% | 1 | 1 | 0% | 1,986 | 4,703 | +137% | 0 | 0 | — |
case-10 | pass→pass | 14,707 | 13,799 | -6% | 1 | 1 | 0% | 2,407 | 5,605 | +133% | 0 | 0 | — |
case-11 | fail→pass | 8,515 | 7,084 | -17% | 1 | 1 | 0% | 1,511 | 4,633 | +207% | 0 | 0 | — |
case-12 | fail→fail | 6,086 | 3,639 | -40% | 1 | 1 | 0% | 952 | 3,920 | +312% | 0 | 0 | — |
case-13 | fail→pass | 17,598 | 17,061 | -3% | 1 | 1 | 0% | 3,038 | 6,355 | +109% | 0 | 0 | — |
case-17 | pass→pass | 10,486 | 13,630 | +30% | 1 | 1 | 0% | 1,873 | 5,689 | +204% | 0 | 0 | — |
case-18 | pass→pass | 9,499 | 6,661 | -30% | 1 | 1 | 0% | 1,447 | 4,515 | +212% | 0 | 0 | — |
case-19 | pass→pass | 6,846 | 3,327 | -51% | 1 | 1 | 0% | 1,156 | 3,914 | +239% | 0 | 0 | — |
case-20 | pass→pass | 11,131 | 7,840 | -30% | 1 | 1 | 0% | 1,752 | 4,595 | +162% | 0 | 0 | — |
case-21 | fail→pass | 19,534 | 18,134 | -7% | 1 | 1 | 0% | 3,184 | 6,499 | +104% | 0 | 0 | — |
case-22 | fail→fail | 12,894 | 10,175 | -21% | 1 | 1 | 0% | 1,944 | 5,067 | +161% | 0 | 0 | — |
DecimalAI ran this skill against gemini-3.6-flash twice over the same eval suite — once with the skill loaded and once without — and compared the two runs case by case. 22 cases were attempted. The headline lift of +36 percentage points is the difference between those two pass rates over the 22 comparable cases. 1 case got worse with the skill loaded, and it is included in that figure.
Without the skill loaded, the model failed this case. With it loaded, the same prompt on the same model passed. This is one improved case from the latest verified run; every case, including any that regressed, is in the table above.
Other measured skills in the registry, with their headline benchmark lift.