Fim da fragmentação de habilidades de agentes usando npx skills

Se você executa múltiplos agentes de IA ou CLIs em seu computador — seja Hermes, Claude Code, Codex, Antigravity, Kimi ou outras ferramentas compatíveis —, provavelmente já enfrentou um problema frustrante: a fragmentação de habilidades (skills). Cada agente ou CLI mantém sua própria pasta skills separada, o que leva a instalações duplicadas, divergência de versões e sobrecarga de gerenciamento.

Em nosso trabalho diário com agentes de IA, frequentemente nos deparávamos com os seguintes problemas:

• Múltiplas instalações: Instalar uma nova habilidade para um agente e depois ter que instalá-la novamente para cada um dos outros.
• Divergência de versões (version drift): Personalizar ou corrigir uma habilidade para um agente, esquecer de atualizar o restante e acabar com agentes se comportando de forma diferente.
• Gerenciamento de habilidades: Ter que vasculhar cada pasta skills de cada agente no sistema apenas para ver quais habilidades estavam realmente instaladas.

O npx skills CLI, uma ferramenta de linha de comando de código aberto desenvolvida pela Vercel, resolve esse problema permitindo que você gerencie uma única pasta skills centralizada e a compartilhe entre todos os seus agentes. Você pode conferir o repositório do npx skills no GitHub.

Pasta Centralizada

O conceito é simples: se apontarmos a pasta skills de cada agente para a mesma pasta física, o problema da fragmentação desaparece por completo.

Quando você instala uma habilidade usando o npx skills CLI, ela é baixada para a pasta centralizada em sua máquina (~/.agents/skills). Em seguida, o CLI cria um link simbólico (symlink, que funciona como um atalho direto) da pasta skills de cada agente de volta para essa pasta centralizada.

Por exemplo, quando o Claude Code procura por habilidades em ~/.claude/skills/, ele é redirecionado de forma transparente para ~/.agents/skills. Se você fizer um ajuste em uma habilidade dentro dessa pasta centralizada, cada agente verá a atualização instantaneamente. Sem cópias manuais, sem scripts de sincronização e sem desperdício de espaço em disco.

Instalando o npx skills e Adicionando uma Habilidade

Execute o seguinte comando para começar e adicionar nossa primeira habilidade:

npx skills add https://github.com/coleam00/excalidraw-diagram-skill --skill excalidraw-diagram

O CLI perguntará se deseja configurar isso para um projeto específico ou globalmente. Geralmente recomendamos escolher global para que todos os agentes compatíveis possam acessá-la:

Em seguida, certifique-se de selecionar Symlink para garantir uma única fonte da verdade:

Feito isso, podemos verificar que a habilidade está instalada na pasta centralizada em ~/.agents/skills:

Abra o Kimi CLI (ou qualquer outro agente) e a habilidade excalidraw-diagram estará disponível e pronta para uso!

Criando uma Habilidade do Zero

Para criar suas próprias habilidades, você pode usar a ferramenta skill-creator da Anthropic. Instale-a assim:

npx skills add https://github.com/anthropics/skills --skill skill-creator

Agora, no Kimi ou em qualquer outro agente, insira o seguinte comando (prompt):

Use the skill-creator to help me build a skill for creating a product landing page

O Kimi ou o seu agente detectará automaticamente o skill-creator e guiará você passo a passo pelo processo:

Outros Comandos Úteis do npx skills

Aqui estão alguns outros comandos práticos:

• npx skills ls -g: Lista todas as habilidades instaladas globalmente
• npx skills update: Mantém todas as habilidades atualizadas com um único comando
• npx skills remove: Desinstala/remove uma habilidade de forma interativa

Consulte o repositório do npx skills no GitHub para ver mais comandos e referências.

Indo Mais Longe

Como todas as habilidades agora estão em um único lugar (~/.agents/skills), podemos inicializar essa pasta como um repositório Git e enviá-la para o GitHub ou GitLab.

cd ~/.agents/skills
git init
git add .
git commit -m "Initial skills folder"
git remote add origin https://github.com/Tech-Voyage-Dev/skills
git push -u origin main

Agora, temos um histórico completo de todas as alterações de habilidades, o que significa que podemos reverter facilmente se uma atualização quebrar algo. Além disso, podemos sincronizar perfeitamente as habilidades entre várias máquinas (como um notebook e um computador desktop) executando um rápido git pull.

Alguns Pontos de Atenção (Segurança e Riscos)

• A compatibilidade varia: Nem todas as plataformas de agentes oferecem suporte a todos os recursos ainda (como ganchos personalizados ou ferramentas permitidas específicas). Uma habilidade pode funcionar muito bem em um agente, mas falhar em outro.
• Confie na fonte: Instale apenas habilidades de fontes confiáveis.
• Revise antes de executar: Se estiver usando uma habilidade personalizada ou de terceiros, revise os arquivos (especialmente na pasta scripts/) antes de permitir que o seu agente a execute.
• Menor privilégio: Tente não conceder a uma habilidade mais permissões de ferramentas ou acessos do que ela realmente precisa para funcionar.
• Nunca codifique segredos: Mantenha suas chaves de API e segredos fora dos arquivos de suas habilidades.

Configurar uma "única fonte da verdade" centralizada com o npx skills poupou nossa equipe de frustrações e trabalho duplicado. Recomendamos muito que faça o teste — os recursos de IA aumentam à medida que suas habilidades crescem!