Skills são pacotes de instrução que dão ao Claude capacidades especializadas — carregadas só quando necessário, sem desperdiçar tokens.
Skills são pacotes de instruções, scripts e recursos que o Claude carrega dinamicamente para melhorar sua performance em tarefas especializadas. Pense nelas como "módulos de expertise" — extremamente simples de criar, incrivelmente poderosas na prática.
A única coisa obrigatória é um arquivo SKILL.md. Todo o resto é opcional.
O processo é elegante: eficiente no início, profundo quando necessário.
Claude escaneia os metadados YAML de cada SKILL.md. Apenas algumas dezenas de tokens por skill — custo mínimo.
Com base na sua mensagem, Claude decide qual skill é relevante. Se nenhuma for, zero tokens extras são consumidos.
Claude lê o SKILL.md via bash, trazendo as instruções ao contexto. Arquivos adicionais só são lidos se necessário.
Scripts Python/JS rodam via bash. Apenas o output entra no contexto — o código em si nunca consome tokens.
Como um manual bem organizado com índice, capítulos e apêndice, Skills deixam o Claude carregar informação só quando precisa dela.
~20 tokens por skill. O Claude vê o nome e a descrição de todas as skills disponíveis para decidir qual ativar.
Instruções completas, exemplos e guias. Arquivos extras como forms.md só são lidos se o contexto pedir.
Scripts Python/JS rodam deterministicamente. Só o resultado entra no contexto — nunca o código em si.
Uma skill só gasta tokens completos quando é realmente necessária. Você pode ter dezenas de skills sem overhead.
Skills podem incluir arquivos auxiliares (schemas, templates, guias). Claude carrega apenas os necessários para cada tarefa.
Ordenar listas, validar dados, extrair campos de PDF — operações onde código é mais confiável que geração de tokens.
No Claude Code, você pode editar skills durante a sessão sem reiniciar. Mudanças são captadas em tempo real.
Disponíveis para todos no claude.ai e via API. Claude as usa automaticamente quando você pede a criação de documentos.
Cria planilhas profissionais com fórmulas, tabelas dinâmicas, gráficos e formatação condicional.
xlsxMonta apresentações com slides, layouts, imagens, gráficos e notas de apresentador.
pptxGera PDFs com formatação rica, preenche formulários existentes e extrai campos automaticamente.
pdfCria documentos Word com estilos, cabeçalhos, tabelas de conteúdo e formatação avançada.
docxReferência atualizada da API, SDKs em 8 linguagens e boas práticas. Embutida no Claude Code.
api-refCrie skills customizadas para os fluxos únicos da sua organização.
Claude detecta quando a skill é relevante para a sua tarefa e a carrega automaticamente — sem você precisar fazer nada.
Você invoca explicitamente com /nome-da-skill. Ideal para fluxos com efeitos colaterais como deploy ou commit.
disable-model-invocation: true → só você pode invocar (use para deploy, send-slack, etc)
user-invocable: false → só Claude invoca (para contexto de background)
O repositório oficial da Anthropic traz guias completos em Jupyter Notebook para você começar do zero e chegar ao nível avançado.
Fundamentos do sistema de Skills com exemplos práticos para início rápido.
Casos de uso reais com dados financeiros — análises, relatórios e automações.
Aprenda a construir, subir e combinar suas próprias skills via API.
Skills customizadas empacotam metodologias proprietárias, guias de marca e fluxos específicos da sua organização. Disponíveis no Claude Code, via API e no claude.ai.
Mantenha o SKILL.md enxuto. Mova documentação detalhada para arquivos auxiliares referenciados.
Claude usa esses campos para decidir quando ativar a skill. Seja específico e inclua quando usar.
Monitore como Claude usa sua skill em cenários reais e iterate. Use disable-model-invocation para workflows com side-effects.
Peça ao Claude para capturar abordagens bem-sucedidas e erros comuns diretamente no SKILL.md durante a conversa.
Use apenas skills que você criou ou obteve da Anthropic. Skills maliciosas podem executar código não-autorizado.
Use scripts quando precisar de comportamento consistente e repetível — sorting, validação, extração de dados.
O cookbook da Anthropic tem tudo que você precisa — notebooks, exemplos e dados reais.