---
title: "Fim da fragmentação de habilidades de agentes usando npx skills"
description: "Usa vários agentes de IA como Claude Code ou Kimi? Aprenda a gerenciar uma pasta centralizada de habilidades compartilhada usando o npx skills CLI."
canonical_url: "https://techvoyage.dev/pt/article/centralised-the-skills-for-agents"
last_updated: "2026-06-14T11:05:30.060Z"
---

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](https://github.com/vercel-labs/skills).

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

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

![Usando o comando npx skills add para instalar uma habilidade do GitHub](https://inimages.techvoyage.dev/articles/Centralised%20the%20skills%20for%20agents/npx-skills-add-command.webp)

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:
![Selecionando a opção de instalação global na CLI npx skills](https://inimages.techvoyage.dev/articles/Centralised%20the%20skills%20for%20agents/npx-skills-install-global-prompt.webp)

Em seguida, certifique-se de selecionar `Symlink` para garantir uma **única fonte da verdade**:
![Escolhendo o método symlink para sincronização de habilidades](https://inimages.techvoyage.dev/articles/Centralised%20the%20skills%20for%20agents/npx-skills-symlink-option.webp)![Confirmação de instalação bem-sucedida e criação de symlink na CLI](https://inimages.techvoyage.dev/articles/Centralised%20the%20skills%20for%20agents/npx-skills-installation-completed.webp)

Feito isso, podemos verificar que a habilidade está instalada na pasta centralizada em `~/.agents/skills`:
![Verificando as habilidades instaladas no diretório centralizado](https://inimages.techvoyage.dev/articles/Centralised%20the%20skills%20for%20agents/npx-skills-directory-verification.webp)

Abra o Kimi CLI (ou qualquer outro agente) e a habilidade `excalidraw-diagram` estará disponível e pronta para uso!
![Kimi CLI mostrando as habilidades centralizadas carregadas e prontas](https://inimages.techvoyage.dev/articles/Centralised%20the%20skills%20for%20agents/kimi-cli-skills-integration.webp)

## Criando uma Habilidade do Zero

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

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

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

```text
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:
![Assistente interativo skill-creator em execução na Kimi CLI](https://inimages.techvoyage.dev/articles/Centralised%20the%20skills%20for%20agents/kimi-cli-skill-creator-setup.webp)

## 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](https://github.com/vercel-labs/skills) 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.

```bash
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!