📊 O Ecossistema de 50+ Agentes
O Skills CLI suporta mais de 50 agentes de IA, desde os mais populares como Claude Code e Cursor até ferramentas especializadas como Devin e OpenHands. A lista cresce a cada versão.
Agentes mais populares
Anthropic · Terminal
Anysphere · Editor
GitHub · Editor
OpenCode · Terminal
Codeium · Editor
Cline · VS Code
Roo · VS Code
Google · Terminal
Cognition · Web
Block · Terminal
Sourcegraph · Editor
OpenDevin · Terminal
💡 Por que tantos agentes?
Times modernos raramente usam apenas um agente. Um desenvolvedor pode usar Claude Code no terminal, Cursor no editor e Copilot no GitHub. O Skills CLI garante que as mesmas skills estejam disponíveis em todos eles.
📁 Caminhos de Instalação por Agente
Cada agente lê suas instruções de um local específico no sistema de arquivos. O CLI sabe exatamente onde instalar — você não precisa configurar nada manualmente. A tabela abaixo mostra os caminhos principais:
| Agente | Projeto (padrão) | Global (-g) |
|---|---|---|
| Claude Code | .claude/skills/ | ~/.claude/skills/ |
| Cursor | .cursor/rules/ | ~/.cursor/rules/ |
| GitHub Copilot | .github/copilot/ | ~/.github/copilot/ |
| Windsurf | .windsurf/rules/ | ~/.windsurf/rules/ |
| OpenCode | .opencode/skills/ | ~/.opencode/skills/ |
| Cline/Roo | .clinerules/ | ~/.clinerules/ |
Escopo: Projeto vs Global
🔍 Detecção Automática de Agentes
Quando você executa npx skills add, o CLI não instala para todos os 50+ agentes — ele primeiro detecta quais agentes você tem instalados verificando a presença de suas configurações no sistema.
Verificação de presença
O CLI verifica se existem as pastas de configuração: existe .claude/ no sistema? Existe .cursor/? Se sim, o agente está ativo.
Instalação seletiva
Apenas os agentes detectados recebem as skills. Economiza espaço e evita criar configurações desnecessárias.
Forçar agente específico
Use -a cursor para instalar para um agente específico mesmo que não seja detectado automaticamente.
💡 Forçar instalação
Se o CLI não detectou um agente mas você quer instalar para ele:
npx skills add -a cursor vercel-labs/agent-skills
Use --all para instalar para todos os agentes independente de detecção.
⚡ Tabela de Compatibilidade de Features
Nem todos os agentes implementam todas as features do formato SKILL.md. Features básicas funcionam em todos, mas algumas funcionalidades avançadas são exclusivas de agentes específicos. Conhecer a tabela evita surpresas.
| Feature | Claude Code | Cursor | Copilot | Cline | Outros |
|---|---|---|---|---|---|
| Skills básicas (name + body) | ✅ | ✅ | ✅ | ✅ | ✅ |
| allowed-tools | ✅ | ✅ | ✅ | ✅ | ✅ |
| context: fork | ✅ | ❌ | ❌ | ❌ | ❌ |
| Hooks (pre/post-tool) | ✅ | ❌ | ❌ | ✅ | ❌ |
Graceful degradation
Features não suportadas são silenciosamente ignoradas — a skill funciona, apenas sem aquela feature específica. Isso garante portabilidade: uma skill com hooks funciona no Claude Code e funciona (sem hooks) no Cursor.
🏆 Qual Agente Usar para Cada Caso
A escolha do agente certo para cada tipo de skill maximiza o benefício. Alguns agentes têm funcionalidades exclusivas que valem a pena considerar ao criar skills avançadas.
Claude Code — Skills avançadas
Melhor escolha quando você quer hooks (automações ao usar ferramentas) ou context:fork (contexto isolado para a skill). Roda no terminal, ideal para fluxos de desenvolvimento.
Cursor — Skills de editor
Excelente para skills de formatação de código, geração de snippets e assistência inline durante edição. Suporta skills básicas e allowed-tools.
GitHub Copilot — Skills de workflow
Ideal para skills relacionadas ao fluxo GitHub: templates de PR, regras de commit, guidelines de code review. Integrado ao ecossistema GitHub Actions.
🗺️ Pastas de Descoberta de Skills
O CLI faz descoberta recursiva de skills em múltiplas pastas padronizadas. Isso permite que repositórios organizem suas skills em diferentes locais sem configuração adicional.
Pastas onde o CLI busca skills (em ordem de prioridade):
meu-repositorio/ ├── skills/ ← principal │ ├── react.md │ └── typescript.md ├── .claude/skills/ ← específico Claude Code ├── .agents/skills/ ← genérico multi-agente ├── .cursor/skills/ ← específico Cursor └── skills/.curated/ ← skills curadas └── stable-skill.md
Descoberta recursiva
O CLI busca recursivamente em subpastas de skills/. Você pode organizar skills em categorias: skills/frontend/, skills/devops/, skills/testing/ — todas serão descobertas.
💡 Best practice
Use skills/ como pasta principal em repositórios públicos. Use .claude/skills/ para skills específicas do Claude Code que outros agentes não devem carregar.
✅ Resumo do Módulo
Próxima Trilha:
Trilha 2 — ⚡ CLI na Prática: Todos os comandos com exemplos reais, flags e casos de uso