São os Skills, as ferramentas e as Knowledge Bases que tornam o Claude Desktop realmente produtivo. Bem usados poupam tempo; mal usados, surge a próxima enxurrada de plugins. Aqui arrumo os conceitos e mostro como manter limpa uma biblioteca de Skills numa equipa.
Skills, extensões, ferramentas – o que é o quê?
Skill: instruções para uma tarefa recorrente. Um Skill reúne descrição, prompts e exemplos para uma tarefa bem delimitada. O Claude escolhe-o assim que a tarefa corresponde à descrição.
Ferramenta: função concreta que o Claude pode invocar. As ferramentas chegam à aplicação sobretudo através de servidores MCP. Uma ferramenta envia um e-mail, lê um ficheiro ou cria um compromisso – um comando atómico com entrada e saída.
Extensão: conjunto de Skills, ferramentas e configuração. Uma extensão empacota um conjunto coerente, por exemplo para pesquisa ou revisão de código. Instala-se uma vez e proporciona uma experiência consistente.
Knowledge Base: repositório de conhecimento estruturado. Uma Knowledge Base fornece ao Claude contexto duradouro – por exemplo documentação de produto, regras de marca ou respostas frequentes. Complementa os Skills, não os substitui.
Como escrevo Skills que aguentam o dia a dia
Descrição de tarefa clara. No front matter fica escrito quando o Skill entra em ação. Se a descrição for vaga, o Claude escolhe-o ou demasiado raramente ou demasiadas vezes.
Dois a três exemplos. Exemplos concretos de antes e depois vencem regras abstratas. No dia a dia, um Skill sem exemplos parece um modelo que ninguém usa.
Formato de resultado esperado. Markdown, tabela, JSON ou texto livre – quem define o resultado obtém saídas fiáveis.
Fronteiras claras. Um Skill deve descrever também o que não faz. Assim evita alucinações nas margens da tarefa.
Como evitar o cemitério de plugins
Introduzo cinco regras do jogo assim que estão envolvidas mais de três pessoas.
- Versionar os Skills. Um repositório comum em vez de cópias avulsas em cada computador. As alterações são rastreáveis e é possível voltar atrás.
- Manter a convenção de nomes. Formato, por exemplo, papel.objetivo.verbo. Assim todos encontram os Skills e o Claude escolhe-os com mais fiabilidade.
- Um procedimento de revisão próprio. Antes de entrar em produção, cada Skill novo passa por uma revisão curta. São verificados o conteúdo, os exemplos e as permissões.
- Arrumar trimestralmente. Os Skills que ninguém usa saem. Uma breve estatística de utilização a partir do ficheiro de registo chega como base de dados.
- Documentar as autorizações de segurança. Que dados o Skill pode tocar e quais não. Esta lista substitui dez discussões numa auditoria.
Quando uma Knowledge Base compensa mesmo
Perguntas recorrentes. Quando a mesma explicação aparece em cinco tópicos por semana, uma Knowledge Base poupa mais tempo do que custa a construir.
Fonte estável. Documentação de produto, regras de marca ou contratos são ideais. Conteúdos que envelhecem depressa pertencem antes a uma fonte em direto via MCP.
Responsabilidade clara. Uma pessoa mantém a Knowledge Base atualizada. Sem dono, qualquer repositório de conhecimento fica desatualizado em menos de seis meses.
Este artigo faz parte da série Claude Desktop einrichten (em alemão).