Claude Skills: o que é uma skill de IA e como funciona
Claude Skills explicadas para o financeiro: o que é uma skill, o que vai na pasta, como o Claude a usa e onde ela quebra, com o Auditor de Tarifas.
Resposta direta
Uma skill de IA, no Claude, é uma pasta com um arquivo de instruções que ensina o modelo a fazer uma tarefa específica do mesmo jeito sempre. O arquivo começa com um nome e uma descrição, e o Claude usa a descrição para decidir quando aplicar a skill. Ela pode levar scripts junto.
Para o financeiro, isso muda o ponto de partida: em vez de reescrever o prompt do fechamento toda vez, você guarda o método numa skill e pede em português. Quando a skill leva um script, o cálculo é feito pelo código, e a IA cuida de ler o pedido e explicar o resultado.
Como uma skill funciona por dentro?
Segundo a documentação do Claude Code (lida em 08/11/2026), a skill é um arquivo de instruções que entra na caixa de ferramentas do Claude. Três peças aparecem em qualquer skill:
- Nome e descrição, no topo do arquivo. A descrição diz o que a skill faz e quando usar. É com ela que o Claude decide se a skill serve para o seu pedido.
- As instruções, no corpo do arquivo: o passo a passo, as regras e o formato da resposta.
- Arquivos de apoio, opcionais: scripts, modelos, exemplos. Uma skill pode ser só texto, sem uma linha de código.
Numa sessão normal do Claude Code, só as descrições ficam sempre carregadas. O corpo da skill entra quando ela é chamada. Por isso uma skill longa quase não pesa no contexto enquanto você não a usa.
No claude.ai, a skill é enviada como um ZIP com a pasta da skill na raiz, e o recurso exige a execução de código ligada. No Claude Code, ela fica numa pasta do seu computador. O nome do arquivo muda entre as duas plataformas, como uma das perguntas abaixo mostra.
Qual a diferença entre skill e prompt?
O prompt é um pedido que você escreve e que vale para aquela conversa. A skill é o método guardado numa pasta, que o Claude carrega quando o seu pedido combina com a descrição. Se a skill traz um script, o número sai do script, e o modelo não precisa adivinhar a conta.
A comparação com o Project, a pasta de contexto, está em skill, prompt ou Project: quando usar cada um. Para o pedido avulso, comece pelo prompt financeiro.
Um exemplo real: o Auditor de Tarifas
O Auditor de Tarifas é uma ferramenta grátis e aberta (Apache-2.0) que soma as tarifas de um extrato OFX ou CSV por banco, mês e tipo, com o IOF separado. Ele não concilia. A pasta da skill traz o arquivo de instruções, o script scripts/auditar_tarifas.py e um extrato fictício em exemplo/extrato_341.ofx.
Rodado com --ano 2025 sobre esse extrato fictício, o script imprime o que está abaixo (conferido em 07/11/2026):
| Item | Resultado |
|---|---|
| Total de tarifa | R$ 191,90 |
| IOF, à parte | R$ 8,32 |
| Período | 2025-01 a 2025-02 |
| Maior tipo | cartão, R$ 120,00 |
| Lançamentos não classificados | 1 |
| Veredicto | CONFERIR |
O veredicto CONFERIR é o ponto didático. Um lançamento tem marca de tarifa e não caiu em nenhuma categoria do script. Ele já está dentro dos R$ 191,90, como outra_tarifa (R$ 4,20), e a skill pede que você o confira em vez de esconder. É isso que as instruções de uma skill definem: o que fazer quando o dado não encaixa. Os valores são do extrato de exemplo, não referência de tarifa de banco nenhum.
A Conciliação Bancária segue o mesmo formato: um comando (python scripts/conciliar.py conciliar --extrato exemplo/extrato.ofx --razao exemplo/razao.csv, entre outros argumentos) que imprime o caminho do resumo.json e do relatório em Excel. A página da Conciliação Bancária mostra a demo.
Uma skill é segura para dados financeiros?
Depende de onde ela roda, e é a primeira pergunta da TI. Leitura de 08/11/2026, com fonte:
| Onde | O que acontece com o arquivo |
|---|---|
| Terminal, sem IA | O motor roda no computador e nada sai dele. |
| Claude Code, sessão local | O motor roda no computador. A skill foi feita para o Claude ler só o resumo que ele imprime, mas o pedido, esse resumo e qualquer arquivo que o Claude abrir vão para a Anthropic. |
| Cowork e claude.ai | O trabalho roda na nuvem da Anthropic e o arquivo sobe para lá. |
Fontes: o README do skills-financas-br, seção “Privacidade, por plataforma”, e a documentação de uso de dados do Claude Code. A proteção do Claude Code é de desenho, não de bloqueio.
Trocar nome, CNPJ e valor não anonimiza um extrato. Para testar uma skill, use um extrato fictício, como o do repositório. O passo a passo de cada plataforma está em como instalar uma skill no Claude.
Onde uma skill ajuda e onde quebra
- Ela segue regra, não julgamento. O script classifica por termos. Aceitar um lançamento como tarifa, ou descobrir de quem é um Pix sem identificação, continua sendo seu.
- Cada skill cobre um trabalho. O Auditor soma tarifa e não concilia. Pedir o que não está na pasta dá resposta ruim ou nenhuma.
- O formato de entrada importa. O Auditor não serve para PDF.
- O ambiente muda o que roda. Um script que precisa de Python local não roda onde o Python não existe.
- Skill de terceiros é código de terceiros. Leia o arquivo de instruções e os scripts antes de ligar, mesmo em repositório aberto.
Perguntas relacionadas
Preciso saber programar para criar uma skill?
Para uma skill só de texto, não. O arquivo começa com um cabeçalho curto (nome e descrição), seguido das instruções em português. Programar só entra se você quiser que um script faça o cálculo. Escrever a descrição com clareza pesa mais, porque é por ela que o Claude escolhe a skill.
Onde a skill fica guardada no Claude Code?
A skill pessoal fica em ~/.claude/skills/<nome>/ e vale para todos os seus projetos. A de projeto fica em .claude/skills/<nome>/, dentro do repositório. A variável ${CLAUDE_SKILL_DIR} aponta para a pasta da skill e serve para chamar os scripts dela, de qualquer pasta de trabalho.
O arquivo da skill é SKILL.md ou skill.md?
Depende de onde você lê. A documentação do Claude Code exige SKILL.md, com essa grafia. A ajuda do claude.ai para skills customizadas manda criar um skill.md, em minúsculas. Quando for criar a sua, siga a grafia da plataforma onde ela vai rodar.
As skills do Finance AI Lab são pagas?
Não. O Auditor de Tarifas é grátis e aberto. O custo possível está no Claude: ele tem plano gratuito com uso limitado, e o Claude Code consta nos planos Pro, Max e Ultra, não no Free (página de preços, lida em 07/11/2026). Rodar o script direto no terminal dispensa o Claude.
Próximo passo
Para ver uma skill de verdade, abra o Auditor de Tarifas, instale pelo caminho que a sua TI aceitar, seguindo como instalar uma skill no Claude, e rode primeiro o extrato fictício. Compare com a tabela acima.
Para a automação virar processo, veja como consolidar a posição de caixa de vários bancos com n8n. Esta peça é um degrau de IA para finanças: o guia do operador, que reúne a escada completa, do que é IA à aplicação no fechamento.
O guia do operador: IA para finanças, do chão à aplicação.
A escada inteira do Aprender num PDF só. O que destrava a sua rotina, sem teoria.
- Um exemplo brasileiro real em cada conceito (NFS-e, OFX, plano de contas)
- O que a IA faz, e o que ela NÃO faz no seu fechamento
- Da primeira conversa ao agente que concilia o seu extrato
- Conciliação, FP&A e régua de cobrança aplicados
Recebe no seu e-mail
Confirma no link que chega. Sem spam, cancela quando quiser.