Nos últimos dois anos temos falado constantemente sobre modelos.
Mais contexto.
Mais tokens.
Mais benchmarks.
Mais capacidade de raciocínio.
Mas uma das novidades mais interessantes do Claude Code não tem nada a ver com o modelo.
Tem a ver com uma pasta.
.claude/skills
O último lançamento do Claude Code introduziu carregamento automático de plugins a partir desse local, adicionou o comando claude plugin init <name> para gerar scaffolding e melhorou a experiência em torno de /plugin.
Pode parecer uma mudança menor.
Não é.
Porque aponta para uma transição muito mais profunda: Claude Code está evoluindo de um agente generalista para uma plataforma extensível de workflows.
E isso poderia mudar a forma como os times organizam conhecimento operacional dentro de seus repositórios.
O problema dos agentes generalistas
Os modelos atuais sabem muitas coisas.
Mas raramente sabem como seu time trabalha especificamente.
Não conhecem:
- Seu fluxo de deployment.
- Suas convenções de arquitetura.
- Suas regras de testing.
- Seus procedimentos de segurança.
- Seus padrões de documentação.
- Suas práticas de revisão.
Cada vez que abrimos uma nova sessão temos que explicar novamente parte desse contexto.
Mesmo com memória, repositórios indexados e janelas de contexto enormes, continua existindo uma diferença importante entre conhecimento geral e conhecimento operacional.
Os agentes entendem código.
Os times entendem processos.
E essa lacuna é precisamente onde aparecem os skills.
O que é realmente um skill?
A forma mais simples de entender é pensar em um skill como uma capacidade especializada empacotada dentro do repositório.
Não é simplesmente um prompt.
Não é apenas documentação.
Não é só uma automação.
É uma combinação de:
- Contexto.
- Instruções.
- Ferramentas.
- Procedimentos.
- Conhecimento específico.
Tudo versionado junto ao código.
Por exemplo:
.claude/
└── skills/
├── security-review/
├── release-checklist/
├── migration-validator/
├── api-documentation/
└── incident-response/
Cada skill pode ensinar ao agente como executar uma tarefa concreta seguindo as regras desse projeto.
Do prompt engineering para o workflow engineering
Durante muito tempo a conversa esteve centrada em prompts.
A pergunta era:
Qual é o melhor prompt?
Agora a pergunta começa a mudar:
Qual é o melhor workflow?
Essa mudança é importante.
Porque os prompts vivem em conversas.
Os workflows vivem em repositórios.
E os repositórios são onde os times colaboram.
Um skill bem desenhado pode capturar anos de experiência operacional e colocá-la à disposição de qualquer desenvolvedor que trabalhe no projeto.
A nova infraestrutura invisível
Os melhores skills provavelmente não serão os mais complexos.
Serão os mais repetidos.
Pensemos em tarefas que ocorrem constantemente:
Revisão de segurança
/plugin security-review
O agente:
- Busca secrets expostos.
- Revisa permissões.
- Verifica dependências.
- Avalia configurações críticas.
- Gera um relatório padronizado.
Validação de releases
/plugin release-checklist
O agente:
- Executa verificações.
- Revisa changelogs.
- Verifica migrações.
- Valida documentação.
- Gera um resumo de riscos.
Auditoria arquitetônica
/plugin architecture-review
O agente:
- Detecta violações de padrões.
- Revisa dependências entre módulos.
- Avalia limites de contexto.
- Sugere melhorias.
Nenhuma dessas tarefas depende exclusivamente do modelo.
Depende principalmente do processo.
O interessante não é a automação
É a portabilidade.
Até agora grande parte do conhecimento operacional vive em lugares dispersos:
- Wikis.
- Notion.
- Confluence.
- Documentos internos.
- Mensagens de Slack.
- Memória tribal.
Os skills permitem mover parte desse conhecimento diretamente para o repositório.
Isso significa que o conhecimento viaja junto com o código.
Quando alguém clona um projeto, também obtém os workflows.
Quando alguém cria um fork, também herda os processos.
Quando alguém incorpora um novo desenvolvedor, os skills fazem parte do onboarding.
A analogia com GitHub Actions
Quando GitHub Actions apareceu, muitos pensaram que era simplesmente uma forma mais conveniente de executar scripts.
Com o tempo se tornou infraestrutura crítica.
Hoje ninguém discute a importância de:
.github/workflows/
Porque lá vive grande parte da automação do ciclo de desenvolvimento.
.claude/skills poderia percorrer um caminho parecido.
Não como substituto do GitHub Actions.
Mas como a camada onde vivem os procedimentos inteligentes do time.
O nascimento do repositório programável
Historicamente um repositório continha:
- Código.
- Configuração.
- Documentação.
Agora começa a conter algo mais.
Comportamento.
Não o comportamento do software.
O comportamento do agente.
Estamos vendo os primeiros passos em direção a repositórios que não apenas armazenam código, mas também ensinam aos agentes como trabalhar dentro deles.
Essa mudança é enorme.
Porque transforma o repositório de uma estrutura passiva em uma fonte ativa de conhecimento operacional.
Por Que Isso Importa para Times Lean
Os times mais beneficiados provavelmente não serão as grandes empresas.
Serão os times que precisam escalar conhecimento sem escalar reuniões.
Cada vez que um skill captura uma prática operacional:
- Diminui o tempo de onboarding.
- Reduz erros repetitivos.
- Padroniza processos.
- Aumenta consistência.
- Multiplica experiência.
Um desenvolvedor novo pode aproveitar procedimentos construídos pelo time durante meses ou anos.
E o agente pode aplicá-los automaticamente.
O Sinal Mais Importante
A verdadeira notícia não é que Claude Code adicione plugins.
A notícia é que a Anthropic parece estar apostando em uma arquitetura onde o valor não vive apenas no modelo.
Vive na camada de especialização.
Os modelos continuarão melhorando.
Mas a diferenciação real pode surgir dos skills que cada organização construa sobre eles.
Do mesmo modo que todos usamos Git, mas cada empresa tem workflows distintos.
Conclusão
Durante anos pensamos que o futuro dos agentes dependia principalmente de modelos cada vez mais inteligentes.
Claude Code está sugerindo algo diferente.
Talvez o próximo salto de produtividade não venha de um modelo melhor.
Talvez venha de repositórios capazes de ensinar aos agentes como trabalhar.
Se essa visão se materializar, .claude/skills poderia terminar sendo uma das pastas mais importantes de qualquer projeto moderno.
Não porque contenha código.
Mas porque conterá a experiência acumulada do time.