📦 Instalação Básica com Shorthand GitHub
A forma mais simples e usada é o shorthand owner/repo. O CLI resolve automaticamente para a URL completa do GitHub, faz o download e instala para os agentes detectados.
Exemplos de instalação básica:
# Instalação mais simples (shorthand) npx skills add vercel-labs/agent-skills # O CLI detecta agentes e pergunta: ? Instalar 12 skills para: claude, cursor, copilot? (Y/n) # Com -y: pula a confirmação npx skills add -y vercel-labs/agent-skills ✓ 12 skills instaladas para claude ✓ 12 skills instaladas para cursor ✓ 12 skills instaladas para copilot
Como o shorthand é resolvido
💡 Repositórios mais populares
- npx skills add vercel-labs/agent-skills
- npx skills add anthropics/skills
- npx skills add ComposioHQ/awesome-claude-skills
🔗 Todos os Formatos de Fonte
O comando skills add aceita quatro formatos de fonte, cada um adequado a um cenário diferente. Conhecer todos expande muito o que você pode fazer com o CLI.
Shorthand GitHub
npx skills add vercel-labs/agent-skills
Mais simples. Resolve automaticamente para GitHub. O formato é owner/repo.
URL Completa do GitHub
npx skills add https://github.com/org/repo
URL completa. Também funciona com GitLab e Bitbucket com suas URLs próprias.
URL de Skill Específica
npx skills add https://github.com/org/repo/tree/main/skills/minha-skill
Instala apenas uma skill específica apontando para o caminho exato no repositório.
Path Local
npx skills add ./meu-projeto-local
Instala do sistema de arquivos local. Ideal para desenvolvimento e skills internas.
🌍 Flag -g: Instalação Global
A flag -g (ou --global) muda o destino da instalação de ./agente/skills/ para ~/agente/skills/. Skills globais ficam disponíveis em qualquer projeto no seu sistema.
📁 Escopo Projeto (padrão)
Comitado com o projeto. Toda a equipe usa as mesmas skills.
🌍 Escopo Global (-g)
Não versionado. Suas preferências pessoais em todos os projetos.
💡 Quando usar cada escopo
- →Projeto: Convenções de código, stack do projeto, processo do time
- →Global: Estilo pessoal, idioma, ferramentas preferidas, produtividade
🎯 Flag -a: Instalar para Agente Específico
A flag -a (ou --agent) especifica exatamente para qual agente instalar, sobrescrevendo a detecção automática. Aceita um único agente ou uma lista separada por vírgula.
# Instalar só para Claude Code npx skills add -a claude vercel-labs/agent-skills # Instalar para Claude e Cursor npx skills add -a claude,cursor vercel-labs/agent-skills # Global + agente específico npx skills add -g -a cursor vercel-labs/agent-skills
Identificadores de agentes
🔩 Flag -s: Instalar Skills Específicas
A flag -s (ou --skill) permite instalar apenas skills selecionadas de um repositório. Útil quando um repositório tem muitas skills mas você precisa de apenas algumas.
# Ver skills disponíveis antes de instalar npx skills add --list vercel-labs/agent-skills Available: react-best-practices, nextjs-routing, design-system, git-commit-style, ... # Instalar só react e nextjs npx skills add -s react-best-practices,nextjs-routing \ vercel-labs/agent-skills
💡 Use --list primeiro
Antes de instalar de um novo repositório, use --list para ver quais skills estão disponíveis. Assim você pode escolher exatamente o que precisa com -s.
🤖 --all e -y para Automação CI/CD
Para pipelines de CI/CD e scripts de setup, o comando deve ser não-interativo. As flags --all e -y garantem instalação completamente automatizada.
Exemplo de GitHub Actions workflow:
- name: Install Agent Skills
run: |
npx skills add --all -y vercel-labs/agent-skills
npx skills add --all -y ./our-internal-skills
--all
Instala para TODOS os agentes suportados, independente de detecção automática. Útil em ambientes de CI onde os agentes não estão instalados mas queremos os arquivos.
-y / --yes
Responde "yes" automaticamente a todas as confirmações. Essencial para scripts não-interativos. Combine com --all para instalação completamente automática.
✅ Resumo do Módulo
Próximo Módulo:
2.2 — 🔍 skills find, list e update — Descubra, audite e mantenha suas skills atualizadas