🏗️ Arquitetura do CLI: os módulos principais
O CLI é TypeScript com módulos: add.ts (instalação), find.ts (descoberta), install.ts (resolução de fonte), sync.ts (atualização).
Como o código é organizado
Entender a arquitetura facilita contribuições. Saber qual arquivo editar para adicionar agente ou corrigir bug.
💡 Conceitos-chave
TypeScript · add.ts · find.ts · install.ts · sync.ts · arquitetura modular
🔍 Como o CLI resolve fontes
Resolução: shorthand → GitHub API → clone git → symlink/copy → destino do agente. Path local: resolve diretamente.
De owner/repo ao arquivo local
O processo explica por que instalações de GitHub são mais lentas (API + clone) e path local é instantâneo.
💡 Conceitos-chave
shorthand resolution · GitHub API · git clone · symlink · performance
🔒 Sistema de lock file
skill-lock.json rastreia skills de projeto; local-lock.json rastreia globais. Contém: nome, fonte, método, agentes.
Rastreando instalações
O lock file é a fonte de verdade para list e update. Corrompido? Delete e reinstale.
💡 Conceitos-chave
skill-lock.json · local-lock.json · rastreamento · fonte · método
📡 Telemetria e variáveis de ambiente
DISABLE_TELEMETRY=1 desativa telemetria. INSTALL_INTERNAL_SKILLS=1 mostra skills internas. DEBUG=1 para logs.
Configurando o CLI
Em CI/CD, DISABLE_TELEMETRY=1 é recomendado para privacidade e performance.
💡 Conceitos-chave
DISABLE_TELEMETRY · INSTALL_INTERNAL_SKILLS · DEBUG · variáveis de ambiente
➕ Como adicionar suporte a um novo agente
Para adicionar agente: definir caminhos de instalação, método de detecção, formato de arquivo. Pull request para vercel-labs/skills.
Contribuindo com novos agentes
Com 50+ agentes suportados, o processo está documentado. Adicionar agente é acessível para contribuidores novos.
💡 Conceitos-chave
novos agentes · caminhos · detecção · Pull Request · contribuição
🤝 Como contribuir para o projeto open source
Processo: fork, branch feature/, mudanças, testes, PR. Issues good first issue são o melhor começo.
Começando a contribuir
O Skills CLI é projeto em crescimento. Contribuições têm impacto real em ecossistema crescente.
💡 Conceitos-chave
fork · branch feature/ · PR · good first issue · testes · impacto
✅ Resumo do Módulo
Próximo:
Você completou o curso Skills CLI! Parabéns! 🎉