Como deixei o Claude Code MUITO melhor com as Agent Skills da Vercel

BBetter Stack
컴퓨터/소프트웨어창업/스타트업AI/미래기술

Transcript

00:00:00Este é o Skills By The Cell, um diretório de habilidades de agentes que você pode adicionar a qualquer IA
00:00:04para ampliar suas capacidades, como torná-la incrível em React, transformá-la em designer de front-end
00:00:10ou até mesmo em editora de motion graphics. O sistema funciona clonando e verificando um repositório
00:00:15para ver se há um arquivo skills.md antes de instalar a habilidade. Mas será que a nova proposta da Cloudflare
00:00:22tornará esse recurso obsoleto? Inscreva-se no canal e vamos direto ao assunto.
00:00:27As "agent skills" foram introduzidas pela Anthropic no ano passado para melhorar as capacidades do Claude em
00:00:32tarefas específicas. Elas funcionam adicionando um diretório "skills" dentro da pasta ".claude" e depois criando
00:00:37outro diretório com o nome da habilidade, seguido por um arquivo skills.md.
00:00:42Para a habilidade funcionar, esse arquivo precisa de alguns elementos-chave. Primeiro, a seção do topo,
00:00:47que é um front matter em YAML, contendo ao menos o nome da habilidade e a descrição.
00:00:52Abaixo disso, fora do front matter, é onde devem ir as instruções da habilidade propriamente ditas.
00:00:58Essas instruções são carregadas no contexto do modelo para que ele possa executar a tarefa específica.
00:01:03A beleza das habilidades reside em uma técnica chamada divulgação progressiva, onde apenas as informações
00:01:08essenciais aparecem inicialmente, e o modelo pode se aprofundar se for necessário.
00:01:13Assim, quando um agente carrega, apenas o front matter de cada habilidade entra no
00:01:19contexto. Após ler o prompt, ele verifica a descrição de cada uma para ver se alguma
00:01:24pode aprimorar o resultado. Se encontrar, ele adiciona o conteúdo externo ao front matter no contexto ativo.
00:01:31Você pode até vincular outros arquivos como referências para o modelo buscar, se julgar preciso.
00:01:40Desde então, empresas como Microsoft, OpenAI e OpenCode adotaram as habilidades de agentes.
00:01:46Mas não havia uma forma fácil de instalá-las em vários agentes sem acessar manualmente o diretório e clonar o repo.
00:01:52Isso ficou evidente quando a Vassal quis compartilhar habilidades de suas ferramentas para que usuários as usassem em seus agentes.
00:01:58Então criaram o projeto "Add Skill", que facilita a adição de habilidades em 16 agentes diferentes.
00:02:03Basta usar "npx add-skill" seguido pelo nome da habilidade ou a URL do repositório.
00:02:14Eu sei o que você está pensando: o que impede alguém de usar o Add Skill para adicionar qualquer repositório?
00:02:19Bem, após o comando, a ferramenta clona o repositório e procura por um arquivo skill.md.
00:02:25Se não encontrar, ela apaga o repositório. Mas, se encontrar, ela detecta automaticamente
00:02:32o agente instalado analisando as configurações e cria um link simbólico (symlink) de
00:02:37".agents/skills" para onde as habilidades devem ficar naquele agente — como ".cursor" ou ".claude".
00:02:44Também há telemetria para rastreamento, sobre a qual falarei adiante. Com isso, a Vassal facilitou a instalação.
00:02:55Mas e quanto à descoberta? É aqui que entra o skills.sh, exibindo uma longa lista
00:03:01de habilidades ainda não categorizadas ou paginadas. Acho que a lista é populada quando
00:03:08alguém instala uma habilidade via Add Skill, o que ativa a telemetria do pacote
00:03:14para enviar o nome, agentes e outros dados. Essa telemetria é totalmente anônima
00:03:20e serve para popular a lista, contar downloads e identificar quais agentes as utilizam,
00:03:26permitindo até rastrear o que foi tendência nas últimas 24 horas.
00:03:32E se você se preocupa com privacidade, saiba que é possível desativar a telemetria completamente.
00:03:37É incrível o esforço da Vassal Labs em descoberta de habilidades; muita gente já as usa para achar recursos fantásticos,
00:03:42como habilidades de React Native, boas práticas de autenticação (Better Auth)
00:03:48e até o popular ReMotion, que permite criar vídeos complexos a partir de um único prompt.
00:03:53Mas será que a nova proposta da Cloudflare jogou tudo isso por terra? Pois ela introduz uma alternativa
00:03:59para os agentes descobrirem habilidades buscando primeiro um arquivo JSON leve em um local conhecido
00:04:05que lista tudo o que está disponível. Imagine escrever: "Crie um projeto Cloudflare usando Wrangler".
00:04:18O agente lerá o prompt e verificará um diretório padrão como [cloudflare.com/well-known](https://www.google.com/search?q=https://cloudflare.com/well-known).
00:04:24Na verdade, será algo como "/skills", de onde ele recuperará o arquivo index.json.
00:04:30Este arquivo traz informações obrigatórias como nome, descrição e número de arquivos da habilidade.
00:04:44Com base no prompt e no index.json, o agente perceberá que precisa da habilidade do Wrangler.
00:04:55Ele fará uma chamada para obter os arquivos, fará o cache para uso futuro e aplicará a
00:05:01habilidade na resposta final ao usuário.
00:05:08Embora a proposta da Cloudflare pareça legal, ela adiciona etapas extras para tornar uma
00:05:14habilidade disponível, como criar o index.json e hospedá-lo em uma URL específica.
00:05:20Comparado a apenas colocar no GitHub para a Vassal encontrar, acho que a abordagem da
00:05:27Cloudflare prejudica pequenos desenvolvedores devido a esse trabalho extra. Se for aceita
00:05:33— e não sei quem revisa ou aprova isso — pode significar o fim do skills.sh da Vassal.
00:05:46Contudo, acredito que possam coexistir: o skills.sh para desenvolvedores independentes
00:05:57e o método da Cloudflare para descoberta automática em grandes empresas como Vercel ou a própria Cloudflare.
00:06:03De qualquer forma, com tantos devs criando projetos incríveis, você precisará de monitoramento
00:06:07de erros, e é aí que entra o Better Stack. Ele não apenas ingere logs do seu back-end,
00:06:12como também monitora erros de front-end usando rastreamento nativo com IA.
00:06:18Para completar, o Better Stack cria páginas de status lindíssimas. Confira o Better Stack hoje mesmo.

Key Takeaway

O ecossistema de agentes de IA está evoluindo para um modelo modular de habilidades, onde ferramentas da Vercel e propostas da Cloudflare disputam a preferência na facilidade de instalação e descoberta.

Highlights

As "Agent Skills" permitem ampliar capacidades de IAs em tarefas como React e design.

A Vercel Labs lançou o projeto "Add Skill" para facilitar a instalação em 16 agentes diferentes.

O funcionamento baseia-se em arquivos skills.md com front matter YAML e instruções específicas.

O portal skills.sh serve como um diretório para descoberta de novas habilidades da comunidade.

A Cloudflare propôs um novo padrão de descoberta automática via arquivos JSON em URLs conhecidas.

Existe um debate sobre a coexistência entre o modelo manual/comunitário e o modelo corporativo automático.

Timeline

Introdução às Agent Skills e Estrutura

O vídeo inicia apresentando o conceito de Agent Skills como um diretório para ampliar as capacidades de IAs em áreas técnicas como React e motion graphics. O narrador detalha a estrutura técnica necessária, que envolve a criação de um diretório específico ".claude" contendo um arquivo skills.md. Este arquivo deve obrigatoriamente possuir um front matter em YAML com nome e descrição da habilidade. A técnica de "divulgação progressiva" é explicada como um método para economizar contexto, carregando instruções detalhadas apenas quando necessário. Este segmento é fundamental para entender como a IA decide quais ferramentas utilizar com base no prompt do usuário.

A Solução Add Skill da Vercel

Nesta seção, o problema da dificuldade de instalação manual de habilidades em múltiplos agentes é abordado como a principal motivação para a criação do projeto "Add Skill". A ferramenta permite que usuários instalem habilidades em até 16 agentes diferentes usando um simples comando npx. O processo interno envolve clonar o repositório, verificar a existência do arquivo de configuração e criar links simbólicos (symlinks) automáticos para as pastas corretas dos agentes, como o Cursor ou Claude Code. O palestrante destaca que isso elimina a necessidade de gerenciar diretórios manualmente. Essa automação da Vercel visa padronizar a distribuição de recursos entre diferentes interfaces de IA.

Descoberta e Telemetria no skills.sh

O foco muda para a plataforma skills.sh, que atua como o motor de busca e descoberta para essas novas funcionalidades. A lista de habilidades é populada através de telemetria anônima coletada quando alguém utiliza o comando de instalação, permitindo rastrear tendências e volumes de download. Exemplos práticos de habilidades populares são citados, incluindo recursos para React Native, autenticação com Better Auth e criação de vídeos com ReMotion. O narrador ressalta que a telemetria pode ser desativada por usuários preocupados com privacidade, mantendo a ética da ferramenta. Este ecossistema representa o esforço da comunidade em criar um repositório centralizado de conhecimento para agentes.

A Proposta da Cloudflare e o Futuro

A parte final do vídeo analisa a nova proposta da Cloudflare que visa automatizar a descoberta de habilidades através de um arquivo index.json hospedado em URLs padrão. Diferente do método da Vercel, o agente de IA buscaria ativamente por essas habilidades sem a necessidade de instalação prévia pelo usuário. O autor pondera que, embora eficiente para grandes empresas, essa abordagem pode ser burocrática para pequenos desenvolvedores independentes devido à necessidade de hospedagem própria. O vídeo conclui sugerindo que ambos os métodos podem coexistir, atendendo a nichos diferentes do mercado de desenvolvimento. Por fim, há uma breve menção ao Better Stack como solução para monitoramento de erros e logs em projetos que utilizam essas tecnologias.

Community Posts

View all posts