Pular para o conteúdo
APRENDER

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.

Doug atualizado 8 de novembro de 2026

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):

ItemResultado
Total de tarifaR$ 191,90
IOF, à parteR$ 8,32
Período2025-01 a 2025-02
Maior tipocartão, R$ 120,00
Lançamentos não classificados1
VeredictoCONFERIR

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:

OndeO que acontece com o arquivo
Terminal, sem IAO motor roda no computador e nada sai dele.
Claude Code, sessão localO 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.aiO 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.

Guia grátis PDF · 21 páginas

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.