---
title: "skills.sh: instalar skills em vários agentes de programação com IA"
seoTitle: "Guia do skills.sh: instalar skills em agentes de programação"
navTitle: "Guia do skills.sh"
description: "Use a CLI do skills.sh para instalar e manter skills no Codex, no Claude Code e noutros agentes de programação, sem duplicar instruções."
slug: skills-sh-install-skills-ai-coding-agents
lang: pt-PT
date: 2026-08-05
updated: 2026-08-05
author: "Chatcode"
category: guide
faq:
  - q: "O skills.sh consegue instalar a mesma skill para o Codex e para o Claude Code?"
    a: "Sim. Passe os nomes dos dois agentes à CLI `skills`, por exemplo `--agent codex --agent claude-code`. A CLI instala uma cópia canónica e pode criar ligações para ela no diretório de skills que cada agente espera encontrar."
  - q: "Como instalo uma skill para todos os agentes suportados?"
    a: "Use `--agent '*'` com `--skill` e o nome de uma skill concreta. A opção `--all`, mais abrangente, instala todas as skills encontradas para todos os agentes sem pedir confirmação, por isso reveja a origem antes de a usar."
  - q: "As skills do skills.sh são seguras de instalar?"
    a: "Não automaticamente. O skills.sh faz auditorias de segurança, mas declara explicitamente que não garante a qualidade nem a segurança de todas as skills. Leia o SKILL.md, os scripts, as referências, as dependências e os acessos pedidos antes de instalar."
---

Se usa mais do que um agente de programação, copiar as mesmas instruções para
diretórios separados do Claude Code, do Codex, do Cursor e do OpenCode depressa
se torna confuso. Cada cópia pode divergir, e torna-se difícil perceber que
versão um agente está a seguir.

O [skills.sh](https://skills.sh/) é um catálogo para descobrir skills de
agentes. A sua [CLI `skills`](https://github.com/vercel-labs/skills), de código
aberto, trata da parte prática: selecionar skills de um repositório, instalá-las
para um ou vários agentes e, mais tarde, atualizá-las ou removê-las.

## Resposta rápida

Comece por listar as skills de um repositório sem instalar nada:

```bash
npx skills add vercel-labs/agent-skills --list
```

Depois, instale uma skill para os agentes que a devem usar:

```bash
npx skills add vercel-labs/agent-skills \
  --skill web-design-guidelines \
  --agent claude-code \
  --agent codex
```

Para disponibilizar essa skill específica a todos os agentes suportados pela
CLI, use um wildcard entre aspas, para que a shell não o expanda:

```bash
npx skills add vercel-labs/agent-skills \
  --skill web-design-guidelines \
  --agent '*'
```

Existe também um comando muito mais abrangente:

```bash
npx skills add vercel-labs/agent-skills --all
```

`--all` significa todas as skills encontradas e todos os agentes, sem pedidos de
confirmação. É prático para um repositório que é seu e que já reviu.
Normalmente, é demasiado abrangente para experimentar uma coleção pública que
não conhece.

## O que é instalado

Uma skill de agente é um diretório que contém, no mínimo, um ficheiro
`SKILL.md`. Esse ficheiro tem um nome, uma descrição que ajuda o agente a
decidir quando a ativar e as instruções a seguir. Uma skill pode também conter
scripts executáveis, material de referência e outros recursos. A estrutura
completa está documentada na
[especificação Agent Skills](https://agentskills.io/specification).

A CLI `skills` conhece os diretórios de projeto e globais usados por dezenas de
agentes de programação. Por exemplo, usa `.agents/skills/` numa instalação do
Codex ao nível do projeto e `.claude/skills/` para o Claude Code. Pode criar
ligações simbólicas (symlinks) desses diretórios dos agentes para uma única
cópia canónica da skill. Assim, as instruções mantêm-se consistentes e uma só
atualização serve vários agentes.

Use `--copy` quando as ligações simbólicas não forem adequadas ao sistema de
ficheiros ou ao ambiente de implementação. As cópias são independentes, por
isso passa a ser responsabilidade sua manter todos os agentes na mesma versão.

## Escolha o âmbito, projeto ou global, de forma deliberada

Por omissão, a instalação é local ao projeto. Execute o comando a partir da raiz
do projeto quando uma skill codifica convenções do repositório, versões de
frameworks ou um fluxo de trabalho que a equipa deve poder inspecionar.

Acrescente `--global` (ou `-g`) apenas para um fluxo de trabalho pessoal que se
deva aplicar a vários projetos:

```bash
npx skills add vercel-labs/agent-skills \
  --skill web-design-guidelines \
  --agent codex \
  --global
```

As skills locais ao projeto são mais fáceis de rever junto do código que afetam.
As skills globais reduzem a repetição, mas também podem fazer com que dois
programadores obtenham comportamentos diferentes do agente no mesmo
repositório. Documente qualquer skill global de que dependa um fluxo de
trabalho partilhado.

## Trate o catálogo como ponto de descoberta, não como prova de qualidade

A tabela de classificação do skills.sh baseia-se na telemetria anónima de
instalações recolhida pela CLI. Um número de instalações pode mostrar
interesse, mas não demonstra que uma skill melhora os resultados das tarefas,
que está atualizada ou que se adequa ao seu projeto.

Antes de instalar uma skill pública:

1. Abra o repositório de origem e leia o `SKILL.md` na íntegra.
2. Inspecione os ficheiros referenciados e todos os scripts que a skill possa
   executar.
3. Verifique a licença, a manutenção recente, as dependências, o acesso à rede e
   as notas de compatibilidade.
4. Procure instruções que entrem em conflito com as versões do seu projeto ou
   com regras já existentes no `AGENTS.md`.
5. Experimente-a num projeto e numa tarefa repetível antes de a tornar global ou
   de a instalar para todos os agentes.

O skills.sh diz que faz auditorias de segurança regulares, mas também
[afirma que não pode garantir todas as skills listadas](https://skills.sh/docs#how-are-you-securing-skills).
É essa a fronteira certa a assumir. Uma skill é um conjunto de instruções, e
por vezes de código, vindo de outro repositório – não uma sandbox nem uma
decisão de confiança.

A telemetria anónima da CLI pode ser desativada para um comando com a variável
de ambiente documentada:

```bash
DISABLE_TELEMETRY=1 npx skills add vercel-labs/agent-skills --list
```

## Mais skills não tornam necessariamente um agente melhor

Instalar uma skill não aumenta a capacidade de base do modelo. Dá-lhe
instruções e recursos adicionais. Instruções úteis podem tornar um fluxo de
trabalho especializado mais fiável; instruções irrelevantes ou desatualizadas
podem consumir contexto, restringir uma boa abordagem ou entrar em conflito com
o repositório.

Os primeiros resultados são díspares. Um
[benchmark recente de skills de engenharia de software](https://arxiv.org/abs/2603.15401)
registou uma melhoria média de apenas 1,2% em 49 skills públicas. Trinta e nove
não mostraram nenhuma melhoria na taxa de sucesso e três reduziram-na. Um
[estudo mais abrangente, o SkillsBench](https://arxiv.org/abs/2602.12670),
encontrou um ganho médio substancial em vários domínios, mas também resultados
negativos em algumas tarefas e um melhor desempenho de skills focadas do que de
documentação exaustiva.

Ambos são preprints recentes e não um veredicto final. Ainda assim, a lição
prática é útil: para avaliar uma skill, compare o resultado com o da mesma
tarefa feita sem ela.
Mantenha-a quando o resultado for mais correto, repetível ou fácil de manter – e
não apenas porque o agente produziu uma resposta mais longa.

## Use o mecanismo mais pequeno que resolva o problema

| Necessidade | Melhor ponto de partida |
| --- | --- |
| Procedimento repetível, específico de uma ferramenta, com ficheiros de apoio | Uma skill de projeto focada |
| Fluxo de trabalho pessoal usado em muitos repositórios | Uma única skill global, revista |
| Regras que todos os contribuidores e agentes têm de seguir sempre | Instruções de projeto versionadas, como o `AGENTS.md` |
| Uma tarefa invulgar | Um prompt direto com o contexto necessário |
| Uma política ou verificação determinística | Um script, teste, formatador ou regra de CI |
| Orientações antigas, genéricas ou contraditórias | Nenhuma skill até as orientações serem corrigidas |

Esta distinção evita que uma biblioteca de skills se transforme num segundo
sistema de configuração, menos visível. As skills são mais úteis para
conhecimento processual que um agente só deve carregar quando surge uma tarefa
correspondente. Os comandos e limites duradouros, válidos para todo o
repositório, pertencem a um ficheiro de instruções focado; consulte
[o que pôr no AGENTS.md e no CLAUDE.md](/articles/agents-md-claude-md-best-practices)
para ver os dados e um modelo compacto.

## Mantenha as skills instaladas fáceis de gerir

A CLI oferece os comandos habituais de ciclo de vida:

```bash
# Show project and global skills
npx skills list

# Update one installed skill
npx skills update web-design-guidelines

# Remove it
npx skills remove web-design-guidelines
```

Reveja as alterações na origem antes de atualizar uma skill usada em produção
ou por uma equipa. Se a reprodutibilidade for importante, registe a origem e a
revisão analisada na documentação do projeto, tal como faria com qualquer outra
ferramenta de desenvolvimento.

O ponto de partida sensato é restrito: instale uma skill revista num projeto,
para os agentes que precisam dela. Só alargue para `--agent '*'`, para o âmbito
global ou para `--all` depois de o fluxo de trabalho ter merecido esse alcance.
