2.2 — skills find, list e update

🔎 skills find: Busca Interativa

O comando npx skills find busca skills no ecossistema público do skills.sh. Sem argumentos, abre uma interface interativa estilo fzf. Com keyword, filtra diretamente.

# Busca interativa (abre fzf-like UI)
npx skills find

# Busca por keyword
npx skills find react
npx skills find typescript
npx skills find "code review"

# Resultado:
→ vercel-labs/agent-skills: react-best-practices (100K installs)
→ anthropics/skills: frontend-design (50K installs)
→ comunidade/react-skills: react-hooks (30K installs)

O que o find mostra

•Nome da skill e repositório — Onde encontrar e instalar
•Install count — Popularidade como indicador de qualidade
•Description — O que a skill faz
•Agentes compatíveis — Para quais agentes funciona

💡 Regra de ouro

Antes de criar uma skill, sempre execute npx skills find [sua-necessidade]. Pode já existir uma skill perfeita. Reutilizar é sempre melhor que criar.

📋 skills list: Inventário de Skills

O comando npx skills list mostra todas as skills instaladas, organizadas por escopo (projeto/global) e por agente. Essencial para auditar periodicamente o que está configurado.

# Listar tudo
npx skills list

📁 Projeto (.claude/skills/)
  ✓ react-best-practices [symlink] ← vercel-labs/agent-skills
  ✓ nextjs-routing [symlink] ← vercel-labs/agent-skills
  ✓ deploy-interno [copy] ← ./internal-skills

🌍 Global (~/.claude/skills/)
  ✓ find-skills [symlink] ← vercel-labs/agent-skills
  ✓ meu-estilo [copy] ← local

# Só globais
npx skills list -g

# Só projeto
npx skills list -p

Quando auditar

•Ao adicionar um novo desenvolvedor ao time
•Antes de uma release importante
•Quando o agente está gerando código inconsistente
•Mensalmente, como boa prática

💡 Dica de equipe

Adicione npx skills list ao seu README de setup do projeto. Novos devs saberão exatamente quais skills o time usa.

⬆️ skills update: Mantendo Atualizado

Skills evoluem. A comunidade melhora continuamente as skills populares. O comando npx skills update sincroniza suas skills com as versões mais recentes dos repositórios fonte.

# Atualizar todas as skills
npx skills update

# Atualizar skill específica
npx skills update react-best-practices

# Atualizar só globais
npx skills update -g

# Resultado:
✓ react-best-practices: v1.2 → v1.3 (3 linhas alteradas)
✓ nextjs-routing: já está atualizado
✓ deploy-interno: atualizado (cópia local)

Como o update funciona por método

🔗 Symlinks

Faz git pull no repositório fonte clonado. Todos os symlinks atualizam automaticamente pois apontam para a mesma fonte.

📋 Cópias

Baixa a versão mais recente e substitui as cópias locais. Cada cópia é atualizada individualmente.

🗂️ Controlando Escopo com -g e -p

As flags -g e -p são transversais: funcionam com list, update e remove. Sem flag, os comandos operam em ambos os escopos simultaneamente.

📁

-p / --project

Apenas skills do projeto (./ path)

🌍

-g / --global

Apenas skills globais (~/ path)

🔄

(sem flag)

Ambos os escopos

# Update apenas globais (não toca no projeto)
npx skills update -g

# List apenas projeto (para auditoria de PR)
npx skills list -p

# Remove apenas globais
npx skills remove -g skill-obsoleta

🔄 Symlink vs Copy: Quando Usar Cada Um

A escolha entre symlink (padrão) e copy (com --copy) afeta como as skills são armazenadas e atualizadas. Entender a diferença evita problemas em ambientes específicos.

🔗 Symlink (Recomendado)

✓Uma fonte canônica compartilhada
✓Update faz git pull na fonte
✓Menos espaço em disco
✓Todos os agentes veem a mesma versão

📋 Copy (--copy)

✓Funciona em Windows (symlinks limitados)
✓Funciona em filesystems remotos/NFS
✓Independente da fonte após instalação
→Update substitui as cópias manualmente

# Usar copy quando symlinks não funcionam

npx skills add --copy vercel-labs/agent-skills

🎮 Fluxo Completo de Gestão de Skills

Combinando find, add, list e update, você tem um ciclo completo de gestão de conhecimento do agente. Aqui está o fluxo recomendado para times:

Descoberta

npx skills find [tecnologia]

Encontre skills relevantes antes de criar do zero

Instalação

npx skills add owner/repo

Instale as skills encontradas

Auditoria

npx skills list

Periodicamente, verifique o que está instalado

Manutenção

npx skills update

Semanalmente ou antes de sprints importantes

✅ Resumo do Módulo

✓

skills find [query] — Busca no diretório público. Sem query: interface interativa.

✓

skills list [-g/-p] — Inventário completo por escopo e agente

✓

skills update [nome] — Atualiza todas ou uma skill específica

✓

Flags -g e -p — Filtram por escopo em list, update e remove

✓

Symlink vs Copy — Symlink recomendado. Copy para Windows e filesystems remotos.

✓

Fluxo de gestão — find → add → list → update. Ciclo contínuo de manutenção.

Próximo Módulo:

2.3 — 🗑️ skills remove e init — Remoção precisa e criação do seu primeiro SKILL.md

← Módulo 2.1 Próximo Módulo →